Envío de Interacciones

A través de la API de Sagicc, tendrás la capacidad de emplear los canales de comunicación previamente configurados en la plataforma para enviar mensajes de manera programada a tus clientes, adaptándote a sus necesidades específicas y las necesidades de tu empresa. Esta funcionalidad permite la integración fluida de Sagicc con otros sistemas o plataformas, aprovechando los canales ya establecidos para el envío de mensajes. Asimismo, dicha interacción dejará un rastro en Sagicc de los casos y las interacciones, facilitando el seguimiento detallado de las comunicaciones enviadas.

Para enviar interacciones a través de la API, realiza una petición de tipo POST al endpoint https://{{sagicc_instance_url}}/api/interaction/send, y envía en el cuerpo de la petición un objeto con la siguiente estructura y atributos:

• ticket_id: Identificador del caso que estará asociado a la nueva interacción. Requerido cuando campaign_id no se encuentra especificado.

• campaign_id: Identificador de la campaña en la cual se creará un caso que estará asociado a la nueva interacción. Requerido cuando ticket_id no se encuentra especificado.

• type: Especifica el tipo de mensaje a enviar. Siempre requerido. Sus posibles valores pueden ser:

  • sm: Standard message o mensaje estándar.

  • hsm: Highly structured message o mensaje altamente estructurado. Exclusivo para canales de tipo WhatsApp.

• message: Texto o contenido del mensaje a enviar. Requerido cuando template_id no se encuentra especificado.

• contact_info_id: Identificador del dato de contacto al cual será enviado el mensaje. Requerido cuando contacto_info no se encuentra especificado.

• contact_info: Dato de contacto al cual será enviado el mensaje. Requerido cuando contacto_info_id no se encuentra especificado.

• country_code: Código del país, asociado al dato de contacto al cual será enviado el mensaje (solo números, sin caracteres especiales).

• channel_id: Identificador del canal que será utilizado para enviar el mensaje. Requerido cuando channel_type_id no se encuentra especificado.

• channel_type_id: Identificador del tipo de canal que será enviado para enviar el mensaje. Sagicc utilizada el primer canal encontrado del tipo especificado para enviar el mensaje. Requerido cuando channel_id no se encuentra especificado.

• transfer_to_agent: Especifica si una vez enviado el mensaje el caso debe o no asignarse a un agente. Sus posibles valores son true o false.

• close_ticket: Especifica si el caso debe o no marcarse como cerrado luego de ser enviado al mensaje. Sus posibles valores son true o false.

• attachments: Arreglo con información de los documentos adjuntos que serán enviados. Cada uno de los objetos debe tener la siguiente estructura:

  • url: URL del adjunto a enviar. La URL debe permitir descargar el archivo original. Siempre requerido.

  • file_name_real: Nombre real del archivo adjunto a enviar. En caso de no especificarlo, el archivo se enviará con un nombre generado por la plataforma.

  • mime_type: Identificador mime del archivo a enviar. Por ejemplo, image/png, application/pdf, etc. Siempre requerido.

• subject: Asunto de la interacción. Para que la interacción sea reconocida como una respuesta a una interacción previa, se debe anteponer el prefijo “RE: {asunto de la interacción previa}”. Esto permite que los clientes de correo electrónico la agrupen correctamente en el mismo hilo de conversación Requerido cuando el canal seleccionado es de tipo “Correo Electrónico”.

• cc: Cadena con correos electrónicos (separados por coma) a los cuales será enviada una copia de la interacción.

• bcc: Cadena con correos electrónicos (separados por coma) a los cuales será enviada una copia oculta de la interacción.

• in_reply_to: Identificador de la interacción previa a la cual la nueva interacción se enviará como respuesta. Este valor se obtiene consultando la interacción original mediante el endpoint {model}/{id} de la API de Sagicc.

• template_id: Identificador de la plantilla a enviar. Corresponde a una plantilla previamente configurada en Sagicc. Requerido cuando message no se encuentra especificado.

• template_name: Nombre de la plantilla de tipo HSM, previamente configurada en Meta. Requerido cuando type es “hsm”.

• template_params: Cadena que contiene las variables necesarias para la plantilla. Estas deben estar en el formato {{1}}, {{2}}, etc. (excluyendo variables básicas de Sagicc como {{id}} o {{cliente.primer_nombre}}) y deben separarse con el carácter |. La cantidad de parámetros debe coincidir con el número de variables externas definidas en la plantilla. Requerido cuando type es “hsm”.

• template_media_url: URL del elemento multimedia para la plantilla, si la plantilla configurada en Meta lo requiere. Requerido cuando type es “hsm”.

• template_lang: Idioma seleccionado para el envío de la plantilla. El idioma debe coincidir con alguno de los idiomas para la plantilla configurada en Meta. Requerido cuando type es “hsm”.

• interactive_content: Elemento interactivo a enviar. Consiste en un objeto de tipo JSON que incluye todos los elementos interactivos a enviar, ya sea texto, elementos multimedia, botones, listas, etc.

En caso de que la interacción se envíe exitosamente, la respuesta correspondiente devolverá el código 200 junto con un mensaje de éxito. Además, se proporcionará información adicional proveniente del canal. En situaciones de fallo en la solicitud, la respuesta mostrará el código 400 acompañado de un mensaje que identifica la causa del error.

A continuación, te presentamos varios ejemplos de envío de interacciones mediante la API de Sagicc, abarcando diversos tipos de mensajes y canales.

Interacción Simple

Interacción de Correo Electrónico con adjuntos

Interacción de Plantilla Tipo HSM (exclusivo para WhatsApp)

Interacción de WhatsApp con Contenido Interactivo - Media

Interacción de WhatsApp con Contenido Interactivo - Botones

Interacción de WhatsApp con Contenido Interactivo - Lista