Requisitos previos
Antes de integrar tu bandeja de entrada de WhatsApp en Arrows, debes configurar algunos aspectos en el proveedor de API que planeas usar. Estos requisitos previos se explican a continuación.
Uso de la API de WhatsApp Cloud
Si planeas usar la API de WhatsApp Cloud, se necesitan los siguientes dos requisitos previos.
I. Configura tu aplicación de desarrollador de Facebook
Primero, debes crear tu aplicación de desarrollador de Facebook con el producto WhatsApp habilitado. Ve a la Guía de la API de WhatsApp Cloud y navega a la sección llamada Configurar Activos de Desarrollador y Acceso a la Plataforma y sigue los pasos.
Una vez que completes este paso, puedes configurar los números de teléfono requeridos en la sección de WhatsApp de tu aplicación de desarrollador de Facebook. Si completas los pasos con éxito, deberías poder obtener el ID del número de teléfono y el ID de la cuenta de WhatsApp Business, como se muestra en la captura de pantalla a continuación. Arrows requerirá estos valores para crear la bandeja de entrada de WhatsApp.
II. Configura un usuario del sistema para tu Administrador de Negocios de Facebook
Crea un usuario del sistema en tu Administrador de Negocios con acceso a la aplicación de WhatsApp. Genera un token de acceso para el usuario, que se requerirá como la clave API para configurar una bandeja de entrada en Arrows.
Al generar el token de acceso, asegúrate de que se seleccionen los permisos de whatsapp_business_management y whatsapp_business_messaging.
Paso 1. Crea un usuario del sistema en la pestaña Usuarios del Sistema del Administrador de Negocios.
Paso 2. Agrega el usuario del sistema. En la pestaña Cuentas de WhatsApp, selecciona «Agregar Personas» y selecciona al usuario del sistema para otorgar acceso a la cuenta de WhatsApp Business.
Paso 3. Genera el token de acceso y solicita permisos.
Consulta este video (en ingles) para ver los pasos detallados.
Usando Twilio
Si planeas usar la API de Twilio, se necesitan los siguientes requisitos previos.
Para conectar una bandeja de entrada de WhatsApp, deberás configurar una URL de devolución de llamada en la bandeja de entrada de Twilio. Sigue los pasos a continuación.
- Inicia sesión en tu consola de Twilio.
- Ve a SMS programables -> Whatsapp -> Enviadores.
- Verás tu número de teléfono. Haz clic en él. Aparecerá un campo como el que se muestra a continuación.
- Proporciona https://app.softwarearrows.com/twilio/callback como valor para la entrada CUANDO LLEGA UN MENSAJE.
Twilio Studio
Si utilizas Twilio Studio para un flujo de conversación personalizado, actualizar la URL del webhook directamente romperá tu integración existente.
Para estos casos, puedes seguir los pasos a continuación.
- Identifica el paso en tu flujo donde deseas que ocurra la transferencia al agente.
- Agrega un widget de solicitud HTTP como se muestra a continuación con los valores dados.
- Método de Solicitud: POST
- URL de Solicitud:
https://app.arrows.com/twilio/callback - Tipo de Contenido: Application/JSON
- Cuerpo de la Solicitud:
{{trigger.message | to_json }}(haz los cambios necesarios según las variables de tu flujo).
El widget de solicitud HTTP enviará el cuerpo del mensaje a Arrows. Esto creará una conversación en Arrows desde donde el agente podrá responder.
Asegúrate de que tu flujo pueda manejar las respuestas del usuario a las respuestas del agente.
Configurar la Bandeja de Entrada de WhatsApp en Arrows
Si cumples con los requisitos previos, puedes crear tu bandeja de entrada de WhatsApp en Arrows. Sigue los pasos que se describen a continuación.
Paso 1. Abre tu panel de control de Arrows. Ve a Configuración → Bandejas de Entrada → Agregar Bandeja de Entrada.
Paso 2. Haz clic en el ícono de «WhatsApp».
Paso 3. Elige un proveedor de API. Según tu selección, verás un conjunto diferente de campos a completar. Aprendamos sobre cada uno de ellos.
Seleccionar API de WhatsApp Cloud
Elige «WhatsApp Cloud» como proveedor de API.
Los campos, como se ven en esta selección, se explican a continuación.
| Valores | Descripción |
|---|---|
| Nombre | Elige un nombre para tu bandeja de entrada. Ej.: El nombre de tu empresa |
| Número de teléfono | Rellena el número de teléfono que has configurado en la aplicación de desarrollador de Facebook |
| ID del número de teléfono | El ID del número de teléfono obtenido en los requisitos previos |
| ID de la cuenta de negocio | El ID de la cuenta de negocio para el número obtenido en los requisitos previos |
| Clave API | El token de acceso del usuario de la cuenta de negocio para el número obtenido en los requisitos previos |
| Token de verificación de Webhook | Este token es requerido al configurar el Webhook en la aplicación de desarrollador de Facebook. Rellena una cadena alfanumérica segura que desees usar |
Completa los pasos para obtener tu URL de devolución de llamada de Webhook de WhatsApp.
Habilitar el webhook
Configura el webhook en la aplicación de desarrollador de Facebook.
Vuelve a la sección de WhatsApp en la aplicación de desarrollador de Facebook. Navega a la subsección de Configuración y configura la URL de devolución de llamada.
El valor para la URL debe ser la misma URL que obtuviste al final de la creación de la bandeja de entrada de Arrows y se verá como
https://app.softwarearrows.com/webhooks/whatsapp/+{numero_telefono}.El valor para el token de verificación debe ser el mismo valor que configuraste para el Webhook Verify Token durante la creación de la bandeja de entrada.
También debes suscribirte a los eventos del campo de mensajes en tu aplicación de desarrollador de Facebook bajo «Webhooks Fields».
Una vez que completes todos los pasos, la sección debería verse como la captura de pantalla.
Seleccionar Twilio
Elige «Twilio» como proveedor de API.
Los campos necesarios se explican a continuación.
| Entrada | Descripción | Dónde lo puedo encontrar |
|---|---|---|
| Nombre de la Bandeja | Este es el nombre de la bandeja de entrada, que se utilizará en toda la aplicación. | N/A |
| Número de Teléfono | Este es el número que utilizarás para comunicarte con tu cliente. Este debe estar verificado en Twilio. | Ingresa tu número como en el Tablero de Twilio |
| SID de la Cuenta | SID de la cuenta en la Consola de Twilio | Inicia sesión en la Consola de Twilio. Aquí podrás ver el SID de la Cuenta y el Token de Autenticación |
| Token de Autenticación | Token de autenticación de la cuenta | Inicia sesión en la Consola de Twilio. Aquí podrás ver el SID de la Cuenta y el Token de Autenticación |
Haz clic en Crear Canal de Twilio después de completar la información.
Ahora agrega agentes a tu bandeja de entrada.
Has creado exitosamente una bandeja de entrada de WhatsApp!
Configuración adicional de la bandeja de entrada
Tu bandeja de entrada de WhatsApp recién configurada debería aparecer ahora en tu lista de bandejas de entrada. Para ver esto y hacer configuraciones adicionales en tu bandeja de entrada de WhatsApp, ve a Configuración → Bandejas de Entrada → haz clic en el ícono de engranaje en la bandeja de entrada de WhatsApp asociada.
Todas las configuraciones adicionales disponibles son las mismas que en tu bandeja de entrada de Twitter.
Tipos de medios compatibles
Tu bandeja de entrada de WhatsApp admite varios tipos de medios, que se resumen a continuación.
Audio
Extensiones compatibles:
- aac
- mp4
- mpeg
- amr
- ogg
Compatible para: Tanto el usuario final como el agente en Arrows.
Documento
Extensiones compatibles:
- text/plain
- application/pdf
- application/vnd.ms-powerpoint
- application/msword
- application/vnd.ms-excel
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/vnd.openxmlformats-officedocument.presentationml.presentation
- application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Compatible para: Tanto el usuario final como el agente en Arrows.
Imagen
Extensiones compatibles:
- jpeg
- png
Compatible para: Tanto el usuario final como el agente en Arrows.
Video
Extensiones compatibles:
- mp4
- 3gp
Compatible para: mp4 para tanto el usuario final como el agente en Arrows, y 3gp solo para el usuario final.
Sticker
Extensiones compatibles: image/webp
Compatible para: Solo el usuario final.
Preguntas Frecuentes
¿Cómo configurar múltiples números bajo una sola aplicación de Facebook?
La aplicación de Facebook permite configurar solo un único punto final de Webhook. Así que crea bandejas de entrada en Arrows para todos los números según sea necesario. Deberás configurar la URL de Webhook proporcionada para solo una de estas bandejas de entrada en la aplicación de Facebook para que todas las demás bandejas de entrada funcionen.
