Credencial WhatsApp Business - API de Mensajeria

Que es una credencial WhatsApp Business

Una credencial de WhatsApp Business permite a tus workflows enviar y recibir mensajes a traves de la API oficial de WhatsApp Business. Se integra con Meta Business Suite y requiere una cuenta de desarrollador de Meta.

---

Campos de configuración

Campo	Descripción	Ejemplo
Access Token	Token de acceso permanente de Meta	EAAGn...
Phone Number ID	ID del número de telefono registrado	1234567890
Business Account ID	ID de la cuenta de WhatsApp Business	9876543210

---

Como obtener las credenciales

Paso 1: Crear cuenta de Meta Business

1. Ve a business.facebook.com
2. Crea una cuenta de Meta Business si no tienes una
3. Completa la verificación del negocio

Paso 2: Crear aplicación en Meta Developers

1. Ve a developers.facebook.com
2. Haz clic en My Apps > Create App
3. Selecciona el tipo Business
4. Nombra tu aplicación y asociala a tu cuenta de negocio
5. En el dashboard de la app, busca WhatsApp y haz clic en Set Up

Paso 3: Configurar WhatsApp

1. En la configuración de WhatsApp, selecciona o crea tu cuenta de WhatsApp Business
2. Agrega un número de telefono (puedes usar el número de prueba proporcionado por Meta para testing)
3. Anota el Phone Number ID que aparece en la configuración

Paso 4: Obtener el Access Token

1. En tu app de Meta, ve a System Users en la configuración del negocio
2. Crea un System User con rol de administrador
3. Asigna los permisos: whatsapp_business_management y whatsapp_business_messaging
4. Genera un token permanente para el System User
5. Copia el token generado

Paso 5: Obtener el Business Account ID

1. En Meta Business Suite, ve a WhatsApp Manager
2. El Business Account ID aparece en la URL o en la sección de configuración
3. También puedes encontrarlo en Business Settings > Accounts > WhatsApp Accounts

---

Configuración de Webhooks

Para recibir mensajes entrantes, configura un webhook:

1. En tu app de Meta, ve a WhatsApp > Configuration
2. En la sección de Webhooks, configura la URL de callback de Floogos
3. Suscribete a los eventos: messages, message_deliveries, message_reads

---

Solución de problemas

Error 190: Token expirado

• Los tokens temporales expiran cada 24 horas
• Genera un token permanente a traves de System Users

Error 131030: Número no registrado

• Verifica que el número de telefono este correctamente registrado en WhatsApp Business
• El número debe completar el proceso de verificación

Mensajes no se envian

• Verifica que el destinatario haya iniciado una conversación (ventana de 24 horas) o usa una plantilla aprobada
• Confirma que tu app de Meta este en modo Live (no en Development)

Error de permisos

• Asegurate de que el System User tenga los permisos correctos asignados
• Verifica que la app tenga acceso a la cuenta de WhatsApp Business

---

Seguridad

• Usa siempre tokens de System Users en lugar de tokens personales
• Nunca expongas el Access Token en código del lado del cliente
• Configura la verificación de firma en los webhooks
• Limita los permisos del System User a lo estrictamente necesario
• Monitorea el uso y costos desde Meta Business Suite
• Rota los tokens periódicamente