Conexión avanzada con tu propia app de Meta

Lo que necesitas

• Una cuenta de Facebook con acceso de administrador al portafolio comercial (Meta Business) de tu negocio.
• Un número de teléfono para WhatsApp Business que pueda recibir un SMS o una llamada de verificación. Si ese número ya tiene WhatsApp instalado, tendrás que liberarlo antes (consulta la nota más abajo).
• Rol de admin u owner en tu workspace de Masterflow.

1. Crea la app de Meta

1. Entra a developers.facebook.com → Mis apps y pulsa el botón verde «Crear app», arriba a la derecha.
2. Ponle un nombre (por ejemplo, el de tu negocio), elige el caso de uso Conectar con los clientes a través de WhatsApp y asóciala al portafolio comercial de tu negocio.
3. Al terminar, tu app aparece en Mis apps → Apps de administración con su Identificador de la app (App ID), el modo «En desarrollo» y el negocio al que pertenece. Copia el identificador: lo vas a necesitar en Masterflow.
4. Abre la app y entra a Casos de uso → Conectar con los clientes a través de WhatsApp → Personalizar. Ahí verás el identificador del número (Phone number ID) y el de la cuenta de WhatsApp Business (WABA ID). Agrega tu número real con «Agregar número de teléfono» y verifícalo con el código que te llegue.
5. En Configuración de la app → Básica, pulsa «Mostrar» junto a la clave secreta de la app (App Secret) y cópiala.

2. Genera un token permanente

1. En business.facebook.com → Configuración → Usuarios del sistema, crea un usuario del sistema con rol de administrador.
2. Asígnale los activos: tu app y tu cuenta de WhatsApp Business, ambos con control total.
3. Pulsa «Generar token», elige tu app, caducidad «Nunca» y los permisos whatsapp_business_messaging y whatsapp_business_management. Copia el token: Meta no lo vuelve a mostrar.

3. Conéctalo en Masterflow

1. Ve a WhatsApp → Conectar número y abre «Conexión avanzada (app propia de Meta)».
2. Llena los campos: un nombre para reconocerlo (p. ej. «Recepción»), App ID, WABA ID, Phone number ID, el token permanente y el App Secret.
3. Pulsa «Probar token»: Masterflow comprueba el acceso y muestra el número y el nombre verificado.

Masterflow guarda el token y el App Secret cifrados y nunca los vuelve a mostrar. Si los renuevas en Meta, actualízalos desde la misma pantalla.

4. Configura el webhook

Meta usa webhooks para avisar a Masterflow cuando llegan mensajes nuevos o cambia el estado de los mensajes. Se configura una sola vez por app.

1. En Masterflow, ve a WhatsApp y, en la tarjeta de tu número, pulsa «Configurar webhook». Copia la URL de devolución de llamada y el token de verificación.
2. Entra a developers.facebook.com → Mis apps y selecciona tu app.
3. En el menú izquierdo abre Casos de uso y, en Conectar con los clientes a través de WhatsApp, pulsa Personalizar.
4. Entra a Configuración básica → Paso 2: Configuración de producción.
5. En Configurar webhooks, pega la URL de devolución de llamada y el token de verificación de Masterflow.
6. Pulsa Verificar y guardar.
7. En los campos de suscripción del webhook, activa messages y message_template_status_update.
8. Regresa a Masterflow y pulsa «Registrar webhook del número» para suscribir tu cuenta de WhatsApp Business. En unos segundos la conexión pasará a Conectado.

¿Algo no funciona? Revisa Problemas frecuentes.