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 tenes una cuenta de Gupshup?
Si todavía no tenes 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, tenes que hacer clic en el bóton 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.
¿Que significa cada estado?
A continuación puedes verificar los diferentes estados que pueden tener los conectores.
El webhook se crea automáticamente al crear el conector. Si el conector se elimina, se elimina el Webhook.
¿Qué sigue?
Ahora que ya sabes un conector de Gupshup WhatsApp, ¡veamos como utilizarlo en tus canales de WhatsApp con este tutorial!