En este documento se aclara cómo funcionará la integración de uContact con la API de Twilio para la creación de campañas de WhatsApp.

Contenido

1 Primeros Pasos
- 1.1 Aprobación de Twilio
- 1.2 Número aprobado
2 Proveedores
3 Campañas WhatsApp Twilio
- 3.1 Configuración Básica
4 Templates
- 4.1 NGINX

Primeros Pasos

Aprobación de Twilio

En primer lugar, debe registrar su número en Twilio, en la web https://www.twilio.com/whatsapp/request-access.

Esto es necesario para que su número sea habilitado para enviar WhatsApp vía uContact.

Se debe repetir este paso para cada número que se desee utilizar como proveedor.

Allí se tiene que completar un formulario con sus datos y esperar la aprobación.

Número aprobado

Luego de aprobado el número, vamos a la configuración de TwilioWhatsapp.

Configuración de Twilio

Al ingresar a esta pantalla se ven todos los números habilitados y links para configurar cada uno.

Al presionar el link se abre un pop-up para configurar las URL de Mensajes Entrantes y Status.

El campo FROM se debe copiar entero, es decir, la palabra WhatsApp junto con el número.

Ejemplo
"whatsapp:+13212040825" → esto es lo que se pega en el campo DID de la campaña de WhatsApp.

Para configurar las URL se usan los siguientes links:

When a message comes in
https://<instancename>.ucontactcloud.com/Integra/resources/TwilioWhatsapp/message
Status callback URL
https://<instancename>.ucontactcloud.com/Integra/resources/TwilioWhatsapp/status

<instancename> refiere a nuestro dominio de uContact Cloud.

Datos de acceso a Twilio.

Para configurar Twilio como su proveedor se necesitan datos de acceso, estos son: número, usuario y contraseña.

¿Cómo obtener datos para acceso a Twilio?

Una vez dentro de Twilio, debe dirigirse al icono del engranaje en la parte superior derecha de la pantalla, hacer clic y seleccionar 'Settings'.

Aquí buscar el cuadro de 'LIVE Credentials', del cual se toma el ACCOUN SID como su nombre de usuario y el AUTH TOKEN como contraseña.

Proveedores

En primera instancia, se debe configurar TwilioWhatsapp como su proveedor de SMS.
Para ello debe dirigirse a Proveedores/SMS.

Al ingresar a la pantalla de proveedores SMS, seleccionar el proveedor TwilioWhatsApp.

Aquí se configura su proveedor:

Nombre con el cual identificará a su proveedor.
Nombre de Usuario es el ACCOUNT SID del cuadro Live Credentials en Twilio, se encuentra haciendo clic en Settings (esquina superior derecha de la pantalla, icono de engranaje).
Contraseña es el AUTH TOKEN del cuadro Live Credentials en Twilio, se encuentra haciendo clic en Settings (esquina superior derecha de la pantalla, icono de engranaje).
SMS From se ingresará el número móvil que estará asociado a Twilio.
SMS RegExp Expresión regular utilizada para los números de destino de los mensajes.
Mensajes por segundo Limite de mensajes que serán enviados por segundo por el proveedor.

Mensajes por segundo Si es 0 no limita la cantidad de mensajes que se podrán enviar por segundo

Luego de completados los campos, presionar Guardar y quedará todo configurado para TwilioWhatsApp.

Campañas WhatsApp Twilio

Una vez terminada la configuración del proveedor debe dirigirse a Campañas/SMS

Configuración Básica

Aquí crearemos las campañas de WhatsApp, para ello se debe completar:

Nombre
Nombre para identificar la campaña de WhatsApp.
Nivel de Servicio
El nivel de servicio es el porcentaje de las interacciones que fueron atendidos/abandonadas por el agente antes/después de un tiempo límite estipulado.
DIDs - Puertos
Ingresar todo el contenido del campo FROM como se indica en la sección Número Aprobado.
- El DID es único para cada campaña de WhatsApp, este campo permite a uContact identificar la campaña a la que pertenece cada interacción que llega.
Proveedores SMS
Seleccionar su proveedor creado previamente para WhatsApp.
Estrategia
Es el comportamiento que va a tener la campaña. Para obtener más información sobre las diferentes estrategias, visite Estrategias - Omnicanal.
Horario
Horario en el cual la campaña de SMS estará disponible, es decir con agentes disponibles para atender los SMS de clientes. Para agregar una configuración de horarios se debe agregar con el botón '+' y aparecerá luna nueva ventana como lo muestra la siguiente imagen, o eliminar una seleccionada de la lista con el botón '-'.

Al finalizar la creación presiona el botón Guardar y quedará activada la campaña de WhatsApp.

Configuración avanzada

La configuración avanzada de campañas de WhatsApp es igual al de campañas SMS.

¿Cómo agregar miembros?

Para agregar o quitar agentes a las campañas, el usuario debe pasar a la sección de Miembros en la sección superior izquierda de la pantalla.

En la columna Campañas se selecciona una o varias campañas a las cuales se desea agregar o quitar miembros.
Seleccionamos uno o más agentes de la columna Agentes y presionamos Agregar
En la columna Miembros veremos a los agentes agregados a la campaña.

Templates

Para el envío de plantillas tenemos 2 formatos:

hsm;contentSid;variable1;variable2

{
  "template":{
    "name":"{{contentSid}}"
    "placeholders":[
      "variable1",
      "variable2"
    ]
  }
}

NGINX

Para recibir los mensajes en uContact es necesario agregar el siguiente fragmento de código a la configuración de NGINX.

location /Integra/resources/TwilioWhatsapp{
     proxy_pass http://localhost:8085;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}