Gupshup WhatsApp
En uContact puedes integrar tu proveedor de Gupshup para utilizar en tus canales de WhatsApp. Es muy fácil crearlo y requiere una configuración sencilla con la información proporcionada por el proveedor.
¡Antes de empezar!
Antes de comenzar la configuración, debes tener cierta información que uContact necesitará para poder establecer la integración con el proveedor. A continuación te detallamos que información es necesaria.
¿No tienes una cuenta de Gupshup?
Si todavía no tienes una cuenta de Gupshup, te mostramos como puedes crear una utilizando la siguiente guía.
Configuración en el portal de Gupshup
Dentro del portal de Gupshup es necesario configurar ciertos Webhooks para el correcto funcionamiento del proveedor. Puedes ver en esta guía como hacerlo.
- Webhook para los mensajes y estado
https://instancia.ucontactcloud.com/api/inbound/gupshupWpp/eventDebes reemplazar "instancia" con el nombre de la instancia, sin el .ucontactcloud.com. Si la instancia es https://marketing.ucontactcloud.com, el webhook tendría que quedar de la siguiente forma: https://marketing.ucontactcloud.com/api/inbound/gupshupWpp/event.
¡Agreganos como Socio!
Es importante que dentro del Portal de Gupshup asocies a uContact como socio, para hacerlo puedes visitar la siguiente guía donde te mostramos el paso a paso.
Si ya tenes un número de socio configurado que no es de Net2phone, debes comunicarte con nuestro equipo de Soporte indicando el Client Secret para poder configurar la cuenta de Gupshup asociada a ese número de socio. Tené en cuenta que todas las cuentas de Gupshup que se utilicen en la instancia van a tener que estar asociadas a ese número de socio.
Información requerida
- Aplicación en Gupshup: Es necesario que tengas una aplicación creada en el portal de Gupshup.
- API Key: API Key de la cuenta de Gupshup.
- Partner App Token: Este es el Partner Token de la App que puedes encontrar dentro del Portal de Partners.
- App ID: Identificador único de la App.
¿Cómo configurar el proveedor en uContact?
- Primero tienes que ir al Menú de Administrador y acceder al apartado de Conectores. Luego, dentro de la pantalla, haz click el botón Nuevo ubicado en la esquina superior derecha.
- En este modal, debes escribir un nombre único para el conector, seleccionar el canal WhatsApp y el proveedor Gupshup.
- Luego, aparecerán dos nuevos apartados. En el de Configuración, debes completar los campos con la información proporcionada por el proveedor.
Configuración
- API Key: API Key de la cuenta de Gupshup.
- Partner App Token: Este es el Partner Token de la App que puedes encontrar dentro del Portal de Partners. En caso de que hayas configurado el Partner ID de uContact en el Self Service Portal de Gupshup, este campo tienes que dejarlo vacío.
- App ID: Identificador único de la App.
- Mensajes por segundo: Cantidad máxima de mensajes que el conector podrá enviar por segundo.
- Luego, en el apartado de Números, debes ingresar los números que configuraste en la App de Gupshup. A continuación, puedes ver como cargar el número.
Números
Lista de teléfonos: Aquí debes agregar los números que utilizará el conector para enviar y recibir los mensajes. Puedes agregarlos manualmente o masivamente utilizando una lista con los números.
¿Cómo agregar un número?
Para agregar un número, simplemente debes escribirlo en el campo Número de teléfono y luego hacer clic en el botón +.
Luego de agregarlo, lo podrás visualizar en el listado.
En cada número tendrás la posibilidad de:
- Copiar: esta opción te copia el número al portapapeles.
- Eliminar: esta opción permite eliminar el número del conector, para eliminarlo es necesario que guardes el conector.
¿Cómo subir una lista de números?
Para subir una lista de números, tienes que hacer clic en el botón que se muestra a continuación.
Luego, se abrirá el asistente de importación de datos.
- Paso 0: se muestran los campos necesarios.
- Paso 1: tienes que arrastrar la lista o seleccionarla desde tu computadora, tiene que estar en formato XLSX, ODS, CSV o TXT.
- Paso 2: visualizarás en la columna izquierda los primeros 3 registros de la lista y en la columna derecha deberás asociarlo a la opción Teléfonos. Además, si en la lista incluiste un encabezado, por ejemplo, Números, tienes que seleccionar la opción Contiene encabezados.
- Paso 3: por último, en este paso simplemente tienes que hacer clic en Finalizar.
¿Cómo monitorear el estado del conector?
Puedes verificar el estado del conector en tiempo real. Para hacerlo, puedes dirigirte al apartado de Conectores en el Menú de Administración, donde verás una lista con todos los conectores creados. En la columna "Estado", aparecerá el estado correspondiente a cada conector.
¿Qué significa cada estado?
A continuación puedes verificar los diferentes estados que pueden tener los conectores.
Plantillas HSM
Las plantillas HSM son mensajes con formato predefinido que deben ser aprobadas por WhatsApp antes de poder enviarse. Son necesarias para iniciar interacciones con clientes o cuando ya pasaron más de 24 horas desde el último mensaje del cliente; pasado ese tiempo, WhatsApp no permite enviar mensajes de texto libre y solo acepta plantillas aprobadas.
¿Dónde se crean?
Se crean desde Meta Business o Gupshup y deben pasar por un proceso de aprobación antes de quedar disponibles.
¿Qué contenido pueden tener?
Los contenidos pueden incluir texto, medios, encabezado, pie de página y botones de respuesta rápida.
¿Cómo sincronizar?
Al crear un nuevo conector de Gupshup, las plantillas HSM de esa cuenta se importan automáticamente. No es necesario hacer nada adicional en ese momento.
Para traer plantillas nuevas o actualizadas después de la creación, desde el listado de conectores haz clic en los tres puntos del conector y selecciona Sincronizar plantillas.
Al finalizar, aparecerá una notificación indicando cuántas plantillas se agregaron, cuántas se eliminaron y si alguna no pudo sincronizarse. Si no había cambios pendientes, la notificación indicará que no hay plantillas para sincronizar.
Solo los usuarios con permisos para crear o editar conectores pueden realizar la sincronización de plantillas.
¿Qué se sincroniza?
Se importan todas las plantillas de tu cuenta de Gupshup, sin importar su estado:
- Aprobadas: se importan en estado deshabilitado. Deben habilitarse manualmente desde la campaña para poder utilizarlas.
- Pendientes / Rechazadas: se importan en estado deshabilitado y no se pueden habilitar manualmente.
Si ya existe una plantilla con el mismo nombre en el sistema, no se sincronizará y aparecerá contabilizada en el mensaje de resultado como "no pudo sincronizarse".
Actualizaciones automáticas
Después de la primera sincronización, uContact recibe actualizaciones automáticas desde Gupshup. Cuando una plantilla cambia, ya sea su contenido o su estado de aprobación, uContact lo actualiza de forma automática. Las plantillas que nunca se sincronizaron manualmente no se incorporan solas, solo aparecen en uContact a partir de la próxima sincronización manual.
Vinculación con campañas
- Cuando se asigna el conector a una campaña, todas sus plantillas sincronizadas se agregan automáticamente a esa campaña en estado deshabilitado. Para habilitarlas, accedé al apartado de Plantillas de la campaña.
- Cuando se quita el conector de una campaña, las plantillas se eliminan automáticamente de esa campaña y no se pueden utilizar.
- Si se elimina el conector, sus plantillas se eliminan del sistema y de todas las campañas a las que estaba asignado.
- Si se cambia el conector, las plantillas anteriores se eliminan y se reemplazan por las del nuevo conector.
¿Qué sigue?
Ahora que ya sabes cómo crear y configurar conectores de Gupshup, ¡veamos como utilizarlo en tus canales de WhatsApp con este tutorial!