Conexión WhatsApp Cloud API (Oficial de Meta)

La integración con WhatsApp Cloud API de Meta es la solución recomendada para empresas que requieren alta tasa de transferencia de mensajes (TPS elevado), plantillas oficiales verificadas con botones interactivos y certificación oficial de marca.

⚡ Conexión Rápida en 1 Clic (Meta Embedded Signup) — Recomendado

Subflow incorpora el flujo oficial de Embedded Signup de Meta, permitiendo conectar una línea de WhatsApp Business en un solo clic sin necesidad de ingresar a la consola de desarrolladores ni copiar tokens a mano:

1. En Subflow Admin, dirígete a Canales y Conexiones > pestaña WhatsApp.
2. Haz clic en el botón verde “Conectar en 1 Clic (Oficial)”.
3. Se abrirá la ventana emergente segura de Meta (Facebook Login):
   • Selecciona o crea tu Cuenta Comercial (Meta Business Account).
   • Crea o elige tu cuenta de WhatsApp Business (WABA).
   • Añade el número telefónico y verifícalo mediante código SMS o llamada.
4. Al hacer clic en Finalizar, Subflow:
   • Canjea el código de autorización automáticamente.
   • Vincula el Phone Number ID y la WABA.
   • Auto-suscribe los Webhooks de mensajería instantánea.
   • Pone tu línea en estado Conectado al instante.

🛠️ Conexión Manual (Avanzada / Credenciales Propias)

Si tu equipo técnico ya dispone de credenciales generadas previamente en su propia consola de Meta for Developers:

1. Obtener Credenciales en Meta for Developers

2. Ingresa a developers.facebook.com e inicia sesión.

3. Crea o selecciona tu aplicación de tipo Business.

4. En el menú de productos, agrega WhatsApp.

5. En API Setup, copia el Phone Number ID y el WhatsApp Business Account ID.

6. Dirígete a Meta Business Manager > Usuarios del Sistema (System Users) y genera un token permanente que no expire.

7. Registrar el Canal en Subflow

8. En Subflow Admin, ingresa a Sesiones de WhatsApp > Agregar Canal Cloud API.

9. Completa los campos solicitados:

   • Nombre: Ej. WhatsApp Cloud Oficial - Soporte.
   • Phone Number ID: Pega el identificador del número.
   • WABA ID: Pega el identificador de la cuenta comercial.
   • Access Token: Pega el token permanente de Meta.

10. Haz clic en Verificar y Conectar.

11. Configurar el Webhook en Meta Subflow te proporcionará una URL de Webhook y un Token de Verificación:

• Callback URL: https://api.omniflou.com/api/v1/webhooks/whatsapp-cloud/[tenantId]
• Verify Token: Un string seguro generado automáticamente por Subflow.

Copia estos dos valores y pégalos en la sección de Webhooks de tu app de WhatsApp en Meta for Developers, y suscríbete al campo messages.

Plantillas de Mensajes (HSM) y Ventana de 24 Horas

• Ventana de Servicio (Customer Care Window): Cuando un cliente te escribe, se abre una ventana de 24 horas durante la cual puedes enviarle mensajes libres (texto, audio, imagen, documentos) sin restricciones de plantilla.
• Mensajes Iniciados por la Empresa (Outbound Marketing / Notificaciones): Fuera de la ventana de 24 horas, debes utilizar plantillas pre-aprobadas por Meta con variables dinámicas ({{1}}, {{2}}).