https://integra-scm.atlassian.net/l/c/qfuptKeA

Configuración

Configurar Gupshup en uContact es un proceso sencillo, pero primero se debe verificar que se posea todo lo requerido para crear un proveedor y campaña.

Requerido:

  • Cuenta configurada con acceso en Gupshup.

  • Crear una App.

  • 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

  • También se configuran los webhooks de uContact para que Gupshup mande los mensajes y estados al portal.

note

https://integraccs.ucontactcloud.com/Integra/resources/Gupshup/event

https://integraccs.ucontactcloud.com/Integra/resources/Gupshup/event

2. Crear proveedor en uContact

Ingresa a uContact con un usuario con permisos para crear proveedores de SMS.

Luego nos dirigimos a Administrador → Proveedores → SMS

Seleccionamos Gupshup de la lista de proveedores y completamos los campos:

  • Nombre
    Para identificar al proveedor.

  • user
    Nombre de la App.

  • password
    API Key de Gupshup.

  • sms from
    Número de WhatsApp sin puntos, ni espacios, ni signos.

3. Crear campaña

  • Seleccionar un proveedor Gupshup.

  • Colocar nombre de la app en el campo puerto.

note

NGINX debe ser modificado para que responda los eventos cuando se agrega la URL en Gupshup.

location /Integra/resources/Gupshup/ { 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;}

NGINX debe ser modificado para que responda los eventos cuando se agrega la URL en Gupshup.

location /Integra/resources/Gupshup/ { 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;}

Interactive button list

Tipo Buttons:

Todo lo qué se muestra en negrita es obligatorio.

Ejemplo:

Button;

image;https://integraccs.ucontactcloud.com/attachments/20211015/214bc4ec-5be3-4c03-a1e9-df2b6efa969c.jpeg;texto de la imagen;la caption

1-Opción 1

2-Opción 2

3-Opción 3

Interactive list

Ejemplo:

List;

title; Elegí uno

body; Algo de texto

header; el header

1-Opción 1

2-Opción 2

3-Opción 3

4-Opción 4

footer;el footer

note

Para poder enviar hsm's, debe ser por medio de un ID. Este ID se obtiene realizando una petición HTTP.

GET https://api.gupshup.io/sm/api/v1/template/list/<app_name>
HEADERS apikey: <api_key>

El app name y api key son los mismos parámetros que se utilizan al configurar un proveedor de Gupshup en uContact.

Para poder enviar hsm's, debe ser por medio de un ID. Este ID se obtiene realizando una petición HTTP.

GET https://api.gupshup.io/sm/api/v1/template/list/<app_name>
HEADERS apikey: <api_key>

El app name y api key son los mismos parámetros que se utilizan al configurar un proveedor de Gupshup en uContact.

Template

hsm;id_template;tipo;variable;variable;variable

hsm;2b394c67-3ef5-4e50-b0bd-446bd5a71c4b;text;Prueba;Test;Algo

hsm;id_template;tipo;mediaUrl;variable;variable;variable

hsm;c6aecef6-bcb0-4fb1-8100-28c094e3bc6b;image;https://images.pexels.com/photos/248797/pexels-photo-248797.jpeg;algo;nose;cosa

Contact

contact;firstName;formattedName;phone;type;:email;type;direction;type

Ejemplo:

contact;John:John Smith;59898514179;CELL;abc2594@gmail.com;Cufre 1940;HOME

Location

location;longitude,latitude;Nombre;direccion

Ejemplo:

location;-34.92403016332158, -56.158280428772684;Shopping Punta Carretas;Montevideo, Uruguay