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.

Credenciales Requeridas de Meta for Developers

Para conectar tu canal oficial necesitas 3 parámetros desde la consola de Meta:

1. Phone Number ID: El identificador único del número telefónico registrado en tu WhatsApp Business Account (WABA).
2. WABA ID (WhatsApp Business Account ID): El identificador de la cuenta comercial de WhatsApp en Meta Business Manager.
3. Token de Acceso Permanente (System User Token): Un token de usuario del sistema con permisos whatsapp_business_messaging y whatsapp_business_management.

️ Configuración Paso a Paso

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}}).