WhatsApp Gupshup


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.


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.


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

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

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


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;id_template;tipo;variable;variable;variable

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

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

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

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

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

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

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