Guía Completa para Configurar un Canal de WhatsApp con WhatChat
Cómo Gestionar Conversaciones de WhatsApp Business desde WhatChat #
Gestionar tus conversaciones de WhatsApp Business ahora es más fácil que nunca con WhatChat. Para configurar tu cuenta, tienes dos opciones de proveedores a elegir:
- API de WhatsApp Cloud
- Twilio
En esta guía, te explicaremos todos los procedimientos necesarios para llevar tu bandeja de entrada de WhatsApp a WhatChat.
Requisitos Previos #
Antes de integrar tu bandeja de entrada de WhatsApp en WhatChat, es necesario configurar algunos aspectos en la API del proveedor que elijas. A continuación, te mostramos los requisitos previos para cada opción.
Usando la API de WhatsApp Cloud #
Si planeas utilizar la API de WhatsApp Cloud, asegúrate de cumplir con los siguientes dos requisitos previos:
1. Configura tu Aplicación de Facebook Developer #
Primero, necesitas crear una aplicación en Facebook Developer con el producto de WhatsApp habilitado. Dirígete a la Guía de API de WhatsApp Cloud y navega a la sección titulada Configurar Activos de Desarrollador y Acceso a la Plataforma, y sigue los pasos indicados.
Una vez completado este paso, podrás configurar los números de teléfono requeridos en la sección de WhatsApp de tu aplicación de desarrollador de Facebook. Si realizas con éxito los pasos, deberías poder obtener el ID de Número de Teléfono y el ID de Cuenta de Negocio de WhatsApp, que son necesarios para crear la bandeja de entrada de WhatsApp en WhatChat.
#
2. Configura un Usuario del Sistema en tu Administrador de Negocios de Facebook #
Crea un usuario del sistema en tu Administrador de Negocios que tenga acceso a la aplicación de WhatsApp. Genera un token de acceso para el usuario, que será requerido como la clave API para configurar una bandeja de entrada en WhatChat.
- 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 de Cuentas de WhatsApp, selecciona “Agregar Personas” y elige al sistema usuario para otorgarle acceso a la cuenta de WhatsApp Business.
- Paso 3: Genera el token de acceso y solicita los permisos necesarios.
Consulta este video para pasos detallados.
Usando Twilio #
Si optas por utilizar la API de Twilio, necesitarás cumplir con los siguientes requisitos previos:
Para conectar con una bandeja de entrada de WhatsApp, necesitarás configurar una URL de callback en la bandeja de entrada de Twilio. Sigue los pasos a continuación:
- Inicia sesión en tu Consola de Twilio.
- Ve a Programmable SMS → Whatsapp → Senders.
- Selecciona tu número de teléfono y haz clic en él. Verás un campo para ingresar la URL.
- Proporciona
https://app.whatchat.com/twilio/callback
como valor en el campo CUANDO LLEGA UN MENSAJE.
Twilio Studio #
Si utilizas Twilio Studio para un flujo de conversación personalizado, actualizar la URL del webhook directamente puede interrumpir tu integración existente. En esos casos, sigue los pasos a continuación:
- Identifica el paso en tu flujo donde deseas que se produzca la transferencia a un agente.
-
Agrega un widget de hacer solicitud HTTP con los siguientes valores:
- MÉTODO DE SOLICITUD: POST
- URL DE SOLICITUD:
https://app.whatchat.com/twilio/callback
- TIPO DE CONTENIDO: Application/JSON
- CUERPO DE LA SOLICITUD:
{{trigger.message | to_json }}
(realiza cambios según sea necesario basándote en tus variables de flujo).
La solicitud HTTP se encargará de enviar el cuerpo del mensaje a WhatChat, creando una conversación desde donde un agente puede responder fácilmente.
Asegúrate de que tu flujo pueda manejar las respuestas de los usuarios a las respuestas del agente.
Configurando la Bandeja de Entrada de WhatsApp en WhatChat #
Si has cumplido con los requisitos previos, ahora puedes crear tu bandeja de entrada de WhatsApp en WhatChat. Sigue los pasos que se detallan a continuación:
- Abre tu tablero de WhatChat. Ve a Configuración → Bandejas de Entrada → Agregar Bandeja.
- Haz clic en el ícono de WhatsApp.
- Elige un proveedor de API. Según tu selección, se te solicitará completar diferentes campos. A continuación, exploremos cada uno de ellos.
Seleccionando la API de WhatsApp Cloud #
Elige «WhatsApp Cloud» como tu proveedor de API.
Los campos, tal como se ven en esta selección, se explican a continuación.
Completa los pasos para obtener tu URL de Callback de Webhook de WhatsApp. Habilita el webhook y configúralo en tu Aplicación de Desarrollador de Facebook:
- Regresa a la sección de WhatsApp en tu Aplicación de Desarrollador de Facebook. Navega a la subsección de Configuración y establece la URL de Callback.
- La URL debe ser la misma que obtuviste al finalizar la creación de tu bandeja de entrada en WhatChat, con un formato similar a
https://app.whatchat.com/webhooks/whatsapp/+{número_de_tel}
. - El valor para el token de verificación debe coincidir con el que configuraste para el Token de Verificación de Webhook durante la creación de la bandeja de entrada.
También deberías suscribirte a los eventos de campo de mensajes en tu aplicación de Facebook Developer bajo Campos de Webhooks. Una vez que completes todos los pasos, la sección debería tener un aspecto similar al de la captura de pantalla proporcionada.
Una vez que termines todos los pasos, la sección debería verse como la captura de pantalla.
Seleccionando Twilio #
Elige «Twilio» como tu proveedor de API.
Los campos, tal como se ven en esta selección, se explican a continuación.
Completa los campos solicitados y luego haz clic en Crear Canal de Twilio.
Paso 4: Agregar Agentes a tu Bandeja de Entrada #
¡Has creado con éxito una bandeja de entrada de WhatsApp!
Configuración Adicional de la Bandeja de Entrada #
Tu nueva bandeja de entrada de WhatsApp debería aparecer ahora en tu lista de bandejas. Para ver esto y realizar configuraciones adicionales, 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. Te recomendamos revisar este enlace para comprender mejor las configuraciones.
Tipos de Multimedia Soportados #
Tu bandeja de entrada de WhatsApp soporta varios tipos de medios, que se resumen a continuación:
Audio #
- Extensiones soportadas:
- aac
- mp4
- mpeg
- amr
- ogg
Soportado por: tanto el usuario final como el agente en WhatChat.
Documentos #
- Extensiones soportadas:
- 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
Soportado por: tanto el usuario final como el agente en WhatChat.
Imágenes #
- Extensiones soportadas:
- jpeg
- png
Soportado por: tanto el usuario final como el agente en WhatChat.
Videos #
- Extensiones soportadas:
- mp4
- 3gp
Soportado para: mp4 para ambos, el usuario final y el agente en WhatChat; 3gp solo para el usuario final.
Stickers #
- Extensiones soportadas: image/webp
Soportado solo para el usuario final.
Preguntas Frecuentes (FAQ) #
¿Cómo configurar múltiples números bajo una sola aplicación de Facebook?
La aplicación de Facebook solo permite configurar un único endpoint de Webhook. Por lo tanto, deberás crear bandejas de entrada en WhatChat para todos los números requeridos y configurar la URL de Webhook proporcionada solo para una de estas bandejas en la aplicación de Facebook para que todas las demás funcionen.
¿Qué tipos de plantillas de WhatsApp son soportadas por WhatChat?
Actualmente, WhatChat solo soporta plantillas basadas en texto. Si tu plantilla incluye encabezados de medios o componentes personalizados como botones, formularios, etc., estos no se mostrarán en el selector de plantillas de WhatChat.
Ahora que estás listo para gestionar tu cuenta de WhatsApp Business con WhatChat, ¡comienza a aprovechar todas estas características!