Integración Fluida de WhatsApp Business con DosilBOT
Esta guía le ayudará a conectar su Cuenta de WhatsApp Business (WABA) a DosilBOT utilizando Meta, desde la configuración del webhook hasta la prueba completa de mensajes. Esta pantalla proporciona detalles clave relacionados con la autenticación, números de teléfono, capacidades de mensajería y la salud de la cuenta.
Ya sea que sea un inquilino (tenant) o un cliente, esta guía paso a paso asegura que usted pueda:
- Configurar correctamente su webhook y verificarlo con Meta.
- Conectar su aplicación de Meta y sus canales de DosilBOT.
- Probar el envío de mensajes utilizando plantillas aprobadas.
- Solucionar problemas y verificar su integración.
Configuración de la Integración de WhatsApp
Para completar su integración con DosilBOT, debe proporcionar dos credenciales esenciales obtenidas de su cuenta de Meta Developer:
- WhatsApp Business Account (WABA) ID
- Token de Acceso Permanente
Para obtener el ID y el Token de Acceso
El primer paso para crear un bot de WhatsApp es vincularlo a nuestro módulo. Además, debe crear una API de WhatsApp Cloud. Visite Facebook for Developers para iniciar una nueva aplicación y seleccione la pestaña "Mis Apps".
Aparecerá instantáneamente una página llamada "Crear una App" con una lista de tipos de aplicaciones disponibles. Seleccione "Empresa" (Business) como el tipo de aplicación y luego presione el botón siguiente.
Complete el formulario ingresando sus detalles básicos y haga clic en "Crear App". Agregue el producto "WhatsApp" a la aplicación desplazándose hacia abajo y haciendo clic en el botón "Configurar" (Set up).
Añadir Número de Teléfono
Vaya a la configuración de la API (API Setup) en el menú de la izquierda y haga clic en el botón "Añadir número de teléfono" (Add phone number) para la API de WhatsApp Cloud.
Aparecerá un formulario modal. Proporcione la información de perfil visible para las personas en WhatsApp (Nombre para mostrar, Zona horaria, Categoría) y haga clic en siguiente.
Ingrese su número de teléfono y elija cómo desea verificarlo (mensaje de texto o llamada telefónica). Luego haga clic en "Guardar cambios" (Save changes).
Habilite el modo en vivo (live mode) haciendo clic en el botón de alternancia.
Recopilar Token de Acceso
Necesita un token de acceso permanente. En el paso 5 de la configuración de la API, haga clic en el botón "Ver la página de información general" (See the overview page).
Seleccione "Configuración del negocio" (Business Settings) en el menú de la página de resumen.
Cree un usuario seleccionando "Usuarios del sistema" (System user) en la barra lateral izquierda y haga clic en Añadir. Asígnele un rol (empleado o administrador).
Después de crear el usuario, añada activos (Add Assets). Seleccione "Apps", elija su aplicación y dele control total. Haga clic en Guardar cambios.
Genere un token de acceso haciendo clic en el botón "Generar nuevo token" (Generate new token). Seleccione los permisos: business_management, whatsapp_business_messaging y whatsapp_business_management.
Copie y guarde el token de acceso generado.
Vaya a la pestaña de Configuración del negocio para obtener el WhatsApp Business Account ID. Cópielo.
Conectar en el Panel de DosilBOT
Vaya al panel (dashboard). Haga clic en el menú "Conectar WhatsApp" en el área de WhatsApp de la barra lateral. Ingrese el ID de la cuenta comercial de WhatsApp y el token de acceso, luego haga clic en "Connect" (Conectar).
Después de una conexión exitosa, aparecerá un mensaje de éxito. Podrá ver la siguiente pantalla de información:
Detalles de la Integración Activa
- 1. Información del Token de Acceso: Muestra el token (parcialmente oculto), los alcances de permisos, fecha de emisión y la URL del Webhook para integraciones externas.
- 2. Información del Teléfono: Muestra el número predeterminado, el nombre comercial verificado, el indicador de calidad (Status: GREEN indica buen cumplimiento de políticas) y el límite de mensajes diarios.
- 3. Salud y Estado de la Cuenta (WABA): Proporciona un resumen de la salud de la cuenta. Un estado "AVAILABLE" indica que no hay problemas importantes.
- 4. Envío de Mensajes de Prueba: Le permite enviar un mensaje de WhatsApp de prueba a cualquier número de teléfono para verificar la integración.
- 5. Verificación del Webhook: Un botón para asegurar que el webhook esté correctamente configurado y activo.
- 6. Código QR para Chat de WhatsApp: Escanee el código QR para iniciar un chat rápidamente.