WhatsApp Cloud API (WABA Oficial)

La integración con WhatsApp Cloud API (WABA Oficial) conecta tus números empresariales directamente a través de la infraestructura oficial de Meta, ofreciendo máxima estabilidad, soporte para alto volumen transaccional y envío de plantillas aprobadas (HSM) fuera de la ventana de 24 horas.

Requisitos Previos

Cuenta verificada en Meta Business Suite (Portafolio comercial).
Aplicación de tipo Empresa (Business) en Meta for Developers con el producto WhatsApp habilitado.
Identificador del número de teléfono (phoneNumberId), identificador de la cuenta de WhatsApp Business (wabaId) y un Token Permanente de Usuario del Sistema con permisos whatsapp_business_messaging y whatsapp_business_management.

Proceso de Conexión

Obtén las credenciales en Meta for Developers

Genera un usuario del sistema administrador en Configuración del Negocio → Usuarios → Usuarios del sistema, asígnale el activo WABA con control total y emite un token permanente.
Registra la conexión en Matias Impulso

Desde Administración → Conexiones → WhatsApp Cloud API (o vía POST /whatsapp-business/connections), ingresa el nombre interno del canal, phoneNumberId, wabaId y el token de acceso.

Matias Impulso valida en tiempo real las credenciales contra Graph API, cifra el token con AES-256-GCM y suscribe automáticamente la aplicación a los eventos de la cuenta WABA.
Configura el Webhook Oficial en Meta

En el panel de Meta (WhatsApp → Configuración → Webhook), registra:
- URL de devolución de llamada: https://api.matiasimpulso.com/whatsapp-business/webhook
- Token de verificación: el token configurado en tu entorno o conexión.
- Campos suscritos: messages (incluyendo estados sent, delivered, read y failed).

Regla de Ventana de Atención de 24 Horas

Meta aplica una ventana estándar de 24 horas contadas desde el último mensaje enviado por el cliente:

Estado de la Ventana	Mensajes Permitidos	Consulta por API
Abierta (`<= 24h`)	Texto libre, imágenes, documentos, notas de voz, listas interactivas y botones de respuesta rápida.	`GET /tickets/:ticketId/channel-window`
Cerrada (`> 24h`)	Únicamente Plantillas Oficiales Aprobadas (HSM) de categoría Utilidad, Autenticación o Marketing.	`POST /messages/send/:ticketId` (con plantilla)