WhatsApp Infobip
- Daniel Olivera (Unlicensed)
- uContact dev
- Ramiro Pereyra (Unlicensed)
La incorporación de Infobip a nuestro servicio brinda una mejor experiencia a nuestros clientes.
Hay muchas posibilidades que destacan lo útil que es este servicio.
Contenido
WhatsApp Infobip V1
Configuración
Para configurar Infobip en uContact solo debe seguir algunos simples pasos, primero debemos verificar que
posea todo lo requerido para crear un proveedor y campaña.
Requerido:
Cuenta configurada en Infobip y acceso a ella.
Número de contacto habilitado.
Ingresar a uContact con un usuario con permiso para crear campañas y marcadores SMS.
Poseer una IP Pública para redireccionamiento de tráfico de uContact.
Habilitar el NGINX.
1. Configurar cuenta
En la cuenta de Infobip se debe crear un ScenarioKey.
También se configuran los Webhooks de uContact para que Infobip mande los mensajes al portal.
WebHooks:
https://<instancename>.ucontactcloud.com/Integra/resources/InfobipWhatsapp/message
https://<instancename>.ucontactcloud.com/Integra/resources/InfobipWhatsapp/status
Para saber cómo crear un ScenarioKey puede consultar el siguiente link.
Ejemplo:
curl --location --request POST 'https://gyyy2e.api.infobip.com/omni/1/scenarios' \ --header 'Authorization: Basic (ususario:pwd en encode 64 sin parentesis)' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "WHATSAPP scenario", "flow": [ { "from": "(numero sin parentesis)", "channel": "WHATSAPP" } ], "default": true }'
2. Obtener parámetros de acceso
En Infobip podrá encontrar las API Keys que necesitará para crear el proveedor en uContact.
3. Crear proveedor en uContact
Ingresa a uContact con un usuario que posea permisos para crear proveedores de SMS.
Una vez adentro nos dirigimos a Administrador → Proveedores → SMS
Seleccionamos InfobipWhatsapp de la lista de proveedores y completamos los campos:
Nombre
Para identificar al proveedor.user
Se ingresará el scenarioKey creado.password
API Key de Infobip.sms from
Número de WhatsApp sin puntos, ni espacios, ni signos.Mensajes por segundo
Limite de mensajes que serán enviados por segundo por el proveedor.
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/InfobipWhatsapp{
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;
}
WhatsApp Infobip V2
Configuración
Configurar Infobip en uContact es muy simple. Primero debemos verificar que posea todo lo requerido para crear un proveedor y campaña.
Requerido:
Cuenta configurada en Infobip y acceso.
Número de contacto habilitado.
Ingresar a uContact con un usuario que tenga permiso para crear campañas y marcadores SMS.
Posesión de una IP Pública para redireccionamiento de tráfico de uContact.
NGINX habilitado.
1. Configurar cuenta
También se configuran los Webhooks de uContact para que Infobip mande los mensajes al portal.
2. Obtener parámetros de acceso
En Infobip podrá encontrar las API Keys que se necesitan para crear el proveedor en uContact.
3. Crear proveedor en uContact
Ingresa a uContact con un usuario que posea permisos para crear proveedores de SMS.
Una vez dentro, nos dirigimos a Administrador → Proveedores → SMS.
Seleccionamos InfobipWhatsappV2 de la lista de proveedores y completamos los campos:
Nombre
Para identificar al proveedor.user
Se ingresa el usuario creado.password
API Key de Infobip.sms from
Número de WhatsApp sin puntos, espacios ni signos.
Interactive Button List
Tipo Buttons:
body: texto
header;texto(si es tipo TEXT)
type VIDEO/IMAGE/
DOCUMENT/TEXT
filename (si es tipo DOCUMENT)
buttons: 1 a 3
ID - title - description
footer: texto
Ejemplo:
|
|---|
Interactive List
Ejemplo:
|
|---|
Template
Body:
|
|---|
Text:
|
|---|
Video/Image:
|
|---|
Document:
|
|---|
Location:
|
|---|
URL:
|
|---|
Quick_Reply
|
|---|
Quick_Reply_Media
|
Ejemplo:
|
|---|
Contact
contact;firstName;formattedName;phone;type;email;type;direction;type
Ejemplo:
|
|---|
Location
location;latitutede,longitude;name;address
Ejemplo:
|
|---|
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/InfobipWhatsappV2{
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;
}
En caso de querer configurar un proveedor de Infobip SMS, dirigirse al siguiente link: Infobip SMS