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 configuracion

Campo	Descripcion	Ejemplo
Access Token	Token de acceso permanente de Meta	EAAGn...
Phone Number ID	ID del numero 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 verificacion del negocio

Paso 2: Crear aplicacion 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 aplicacion 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 configuracion de WhatsApp, selecciona o crea tu cuenta de WhatsApp Business
2. Agrega un numero de telefono (puedes usar el numero de prueba proporcionado por Meta para testing)
3. Anota el Phone Number ID que aparece en la configuracion

Paso 4: Obtener el Access Token

1. En tu app de Meta, ve a System Users en la configuracion 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 seccion de configuracion
3. Tambien puedes encontrarlo en Business Settings > Accounts > WhatsApp Accounts

---

Configuracion de Webhooks

Para recibir mensajes entrantes, configura un webhook:

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

---

Solucion de problemas

Error 190: Token expirado

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

Error 131030: Numero no registrado

• Verifica que el numero de telefono este correctamente registrado en WhatsApp Business
• El numero debe completar el proceso de verificacion

Mensajes no se envian

• Verifica que el destinatario haya iniciado una conversacion (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 codigo del lado del cliente
• Configura la verificacion 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 periodicamente