Conectar WhatsApp Cloud API
Agentes SaaS usa la WhatsApp Cloud API (Meta) para enviar confirmaciones de cita, recordatorios 24 horas antes y el link de pago al cliente. Necesitas un número de WhatsApp Business verificado por Meta.
Requisitos previos
- Cuenta de Meta for Developers activa.
- App de tipo Business con el producto WhatsApp agregado.
- Número de WhatsApp Business verificado (no puede ser un número personal activo en WhatsApp).
- WABA ID (WhatsApp Business Account ID).
Paso 1 — Obtener credenciales en Meta for Developers
1. Ve a developers.facebook.com → tu app → WhatsApp → API Setup.
2. Copia el Phone Number ID del número que quieres usar.
3. Copia el WhatsApp Business Account ID (WABA ID).
4. Genera un System User Token con permisos whatsapp_business_messaging y whatsapp_business_management. Los tokens temporales de prueba expiran en 24 horas — usa un token de sistema permanente para producción.
Paso 2 — Configurar en el dashboard
1. Ve a /dashboard/settings → pestaña Canales.
2. En la sección WhatsApp Cloud, haz clic en Configurar.
3. Ingresa:
- Phone Number ID
- WABA ID
- Access Token (token de sistema permanente)
4. Haz clic en Guardar y verificar. El sistema enviará un mensaje de plantilla de prueba.
Variables de entorno equivalentes (self-hosted)
WHATSAPP_PHONE_NUMBER_ID=1234567890123456
WHATSAPP_WABA_ID=9876543210987654
WHATSAPP_ACCESS_TOKEN=EAAxxxxxxxxxxxxxxx
Plantillas de mensaje
WhatsApp exige que los mensajes iniciados por el negocio usen plantillas aprobadas por Meta. Agentes SaaS incluye las siguientes plantillas pre-aprobadas:
| Plantilla | Uso |
|---|---|
| confirmacion_cita | Confirmación inmediata post-agendamiento |
| recordatorio_24h | Recordatorio automático 24 horas antes |
| link_pago | Envío del enlace de pago PayPal |
| modificacion_cita | Notificación de reprogramación o cancelación |
Si necesitas plantillas adicionales, debes crearlas en el Meta Business Manager y esperar aprobación (generalmente 24-48 horas).
Verificar que funciona
1. Agenda una cita de prueba desde /a/[slug].
2. Cuando el agente pida el teléfono, da un número con WhatsApp activo.
3. Deberías recibir la confirmación en menos de 1 minuto.
> Los mensajes de WhatsApp Cloud tienen un costo por conversación. Revisa la tarifa de Meta para tu país.