Whatsapp Gupshup V3

Whatsapp Gupshup V3


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 y configurarle un Partner.

  • 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. Crear proveedor en uContact

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

Luego dirigirse a Administrador → Proveedores → SMS

Seleccionar GupshupV3 de la lista de proveedores, se mostrará el siguiente formulario:

Vista del formulario de creación de proveedor GupshupWhatsappV3

 

En el formulario se deben ingresar los siguientes valores:

  • Nombre
    Para identificar al proveedor.

  • SMS From
    Número que recibirá los mensajes entrantes. También es el número desde el que saldrán los mensajes salientes. Es un número de celular sin puntos, espacios, ni signos.

  • Mensajes por segundo
    Límite de mensajes que serán enviados por segundo por el proveedor

  • ID de la aplicación

    ID de la App de Gupshup.

  • Token de partner
    Si se usa uContact como Partner de Gupshup, no se debe ingresar nada en este campo. En caso contrario, si se usa un Partner que no sea uContact, se debe ingresar un access token de ese partner. Para poder usar uContact como Partner de Gupshup, se debe agregar el partner ID 3247 cuando se configura la aplicación de Gupshup en el portal de Gupshup (ver https://integra-scm.atlassian.net/wiki/x/BoBQ2w).

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

ID y nombre de la aplicación Se puede encontrar en la página de Gupshup: Panel de Control / {Tu app} → Configuración


2. Crear campaña

  • Seleccionar un proveedor GupshupV3.

  • Ingresar el número de SMS From en el campo puerto.


Administración del proveedor

image-20250903-165330.png

Se dispone de un indicador del estado del webhook. El mismo tendrá color verde si hay un webhook de GupshupV3 apuntando a la instancia y rojo en caso contrario.

Mensajes especiales

Se pueden mandar mensajes especiales como ubicación, listas de botones, contactos, etc., tal y como se describe en https://integra-scm.atlassian.net/wiki/x/AQCwkg.

Templates

El uso de templates se describe en https://integra-scm.atlassian.net/wiki/x/AoATrQ.

Visibilidad del endpoint para el webhook

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

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

Asegúrate de que el endpoint sea accesible y que ningún firewall lo esté bloqueando.