Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Current »


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.

Contenido


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.

Para ello se debe agregar el siguiente párrafo en el archivo "/etc/nginx/sites-enabled/default"

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 sin titulo para opciones:

List:

button: Boton de lista

body: Algo de texto

header: el header

title: Titulo de lista

1-Opción 1 - descripcion 1

2-Opción 2 - descripcion 2

3-Opción 3 - descripcion 3

4-Opción 4 - descripcion 4

footer:el footer

Ejemplo con titulo para opciones:

List:

button: Boton de lista

body: Algo de texto

header: el header

title: Titulo de lista

itemTitle: primera parte

1-Opción 1 - descripcion 1

2-Opción 2 - descripcion 2

itemTitle: segunda parte

3-Opción 3 - descripcion 3

4-Opción 4 - descripcion 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.

Templates

Las plantillas de mensajes pueden ser una herramienta valiosa para iniciar conversaciones con los usuarios. Las plantillas de texto se pueden acceder en la ventana de configuración del proveedor y utilizar en el buzón junto con respuestas predefinidas. En este proceso, es esencial reemplazar los marcadores de posición con los valores específicos requeridos como variables.

Sincronizar: Al hacer clic en este botón, se obtendrán todas las plantillas aprobadas de tipo texto asociadas a la cuenta. Una vez que la sincronización se realice con éxito, los miembros de la campaña podrán utilizar estas plantillas como respuestas prearmadas.

Eliminar: Este botón se utiliza para eliminar permanentemente todas las plantillas de la base de datos del proveedor en uContact.

Ejemplos de templates:

hsm;id_template;tipo;variable;variable;variable

hsm;2b394c67-3ef5-4e50-b0bd-446bd5a71c4b;text;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;variable;variable;variable

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

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/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;
}


  • No labels