Conectar la API de WhatsApp Business Cloud a AssistFlow: Guía Paso a Paso

Tiempo: ~10 minutos · Nivel de habilidad: Intermedio · Costo: Gratis con el número de prueba proporcionado por Meta

En esta guía, crearemos una aplicación de API de WhatsApp Business Cloud en Meta para Desarrolladores, la conectaremos a AssistFlow y activaremos respuestas automáticas de IA para los mensajes entrantes. Cada paso ha sido probado en vivo.

Requisitos previos

• Una cuenta de Meta (Facebook) con una cuenta de Meta Business activa
• Un número de teléfono que no esté registrado actualmente en WhatsApp (Meta también te proporciona un número de prueba gratuito)
• Una cuenta de AssistFlow con acceso al panel de desarrollador (/dashboard/whatsapp-settings)

1. Crear una aplicación en Meta para Desarrolladores

1. Ve a developers.facebook.com/apps y haz clic en Crear aplicación.
2. Elige el caso de uso "Otro" y el tipo de aplicación "Business".
3. Introduce un nombre para la aplicación (por ejemplo, "AssistFlow WhatsApp") y tu correo de contacto, luego selecciona tu cuenta de negocio.

2. Añadir el producto de WhatsApp

1. Desde la barra lateral del panel de la aplicación, haz clic en "Añadir producto" y selecciona "Configurar" en la tarjeta de WhatsApp.
2. Selecciona un Portafolio de Negocios (o crea uno).
3. Meta auto-provisionará un número de teléfono de prueba y una Cuenta de Negocios de WhatsApp (WABA) — puedes enviar mensajes gratuitos con él durante el desarrollo.

3. Obtén tu ID de Número de Teléfono, ID de WABA y número de visualización

Desde la barra lateral abre WhatsApp → Configuración de API:

• ID de Número de Teléfono — cadena de dígitos largos bajo "De" (por ejemplo, 527144740475098)
• ID de Cuenta de Negocios de WhatsApp — en la parte superior, junto al menú desplegable
• Número de teléfono de visualización — tu número de prueba o verificado en formato E.164 (por ejemplo, +90 555 724 22 44)
• Nombre de negocio verificado — el nombre de tu empresa en el Administrador de Negocios

Copia estos cuatro valores en un lugar seguro — los pegaremos en AssistFlow a continuación.

4. Generar un Token de Acceso Permanente

El "token de acceso temporal" en Configuración de API expira en 24 horas. Para producción, crea un Usuario del Sistema en Meta Business y emite un token permanente para él:

1. business.facebook.com → Configuración → Usuarios → Usuarios del Sistema
2. Añadir → nómbralo (por ejemplo, "AssistFlow Token"), establece el rol en Admin.
3. Selecciona el nuevo usuario → Añadir Activos → Aplicaciones → elige tu aplicación de AssistFlow → otorga Gestionar aplicación.
4. Añade Cuentas de WhatsApp como un activo también → otorga Gestionar cuenta de WhatsApp.
5. Generar Nuevo Token → selecciona tu aplicación → habilita al menos:
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. Activa "Nunca expira" → Generar → copia el token inmediatamente (Meta no lo mostrará de nuevo).

5. Pega las credenciales en AssistFlow

1. Inicia sesión en tu Panel de Desarrollador de AssistFlow → WhatsApp AI → Configuración de WhatsApp.
2. En la tarjeta de Credenciales de API de Meta Cloud pega:
   • ID de Número de Teléfono
   • ID de Cuenta de Negocios de WhatsApp
   • Token de Acceso Permanente
   • Número de Teléfono de Visualización
   • Nombre de Negocio Verificado
3. Haz clic en Guardar al final. El sistema genera automáticamente un Token de Verificación de Webhook para ti.

6. Conecta el webhook en el lado de Meta

Después de guardar, la tarjeta de Configuración de Webhook muestra dos valores:

URL de Callback : https://<project>.supabase.co/functions/v1/whatsapp-webhook Token de Verificación : (generado automáticamente, haz clic en "Copiar")

Ahora de vuelta al Portal de Desarrolladores de Meta:

1. Barra lateral → WhatsApp → Configuración → Webhook.
2. Pega URL de Callback y Token de Verificación → Verificar y guardar.
3. En "Campos de Webhook" Suscribirse a messages. (Opcional: también suscribirse a message_template_status_update y account_update.)

7. Habilitar respuestas de IA

AssistFlow → Configuración de WhatsApp → tarjeta de Configuración de Respuesta Automática:

• Activar Integración → encendido
• Respuestas de IA Activas → encendido
• Widget Predeterminado → elige qué base de conocimiento + persona debe usar la IA (puedes elegir tu widget de chat existente).
• Límite Diario de Mensajes → 1000 (o lo que se ajuste a tu plan).
• Mensaje Fuera de Horario → texto enviado automáticamente fuera de tu horario laboral.

Haz clic en Guardar de nuevo.

8. Pruébalo

1. Desde el panel de "Enviar y recibir mensajes" del número de prueba, envía un mensaje — escribe al número desde tu propio WhatsApp.
2. En 30 segundos deberías ver la respuesta de la IA en tu WhatsApp.
3. Abre Mensajes de WhatsApp en AssistFlow → confirma que el mensaje se registró como entrante + saliente.

9. Ir a producción

1. Portal de Desarrolladores de Meta → Revisión de Aplicación → Permisos y Funciones → Solicitar Acceso Avanzado para whatsapp_business_messaging y whatsapp_business_management.
2. WhatsApp → Números de Teléfono → Añadir número de teléfono → añade tu número de negocio real, verifica vía SMS/voz.
3. Actualiza el nuevo ID de Número de Teléfono en AssistFlow (reemplaza el de prueba).
4. Cambia el modo de la aplicación a En Vivo.

Problemas comunes

"Verificación de webhook fallida"

El Token de Verificación no coincide o no guardaste primero en AssistFlow. Guarda Configuración, luego pégalo en Meta.

Los mensajes llegan pero la IA no responde

"Respuestas de IA Activas" podría estar apagado. Además, si "Widget Predeterminado" no está configurado, la IA no sabe qué persona usar.

Error de "Re-engagement" / ventana de 24 horas

Política de WhatsApp: si un cliente no te ha enviado un mensaje en 24 horas, solo puedes contactarlo con una plantilla aprobada. Sincroniza plantillas desde Meta en la pestaña Plantillas.

Token expirado

Usaste el token temporal (24h). Usa el flujo de Usuario del Sistema en el paso 4 para obtener un token permanente.

Próximos pasos

• Plantillas de WhatsApp: sincroniza tus plantillas de marketing aprobadas en la pestaña Plantillas.
• Campañas de WhatsApp: carga una lista de leads y ejecuta campañas de goteo.
• Analítica Conversacional: rastrea envíos diarios, aperturas y sesiones activas en la pestaña de Analítica.

¿Necesitas ayuda? Envía un correo a support@assistflow.ai — el soporte de configuración está incluido en tu plan.