De cero al primer despacho en la cola: crea la plantilla, habilita los canales que necesitas y llama a POST /v1/templates/send. La administración (templates:*) y el envío (ámbitos por canal) son familias de permisos diferentes.
En resumen
- Una plantilla no necesita los siete canales, habilita solo los que usas.
- Al enviar,
channels debe ser un subconjunto de canales habilitados.
- 202 respuesta = en cola. Entrega → webhooks de cada canal. Meta aprobación →
template.* webhooks.
Contexto: Introducción. Alcances: Alcances de clave API. WhatsApp oficial: Metaplantillas oficiales.
Antes de empezar
- Gestión:
templates:create (crear), templates:read (lista)
- Enviar: alcance para cada canal utilizado (
sms:send, email:send, whatsapp:send,…)
- WhatsApp: instancia activa. Correo electrónico: dominio verificado. Empujar: aplicación. Voz: Número ACTIVO
- Autenticación:
Authorization: Bearer sk_live_... o x-api-key
- URL base:
https://api.notifique.dev
1. Crear plantilla
1A, a través del tablero
- Plantillas → Nueva plantilla
- Habilitar canales (SMS, email, WhatsApp,…)
- Escribe contenido con
{{variables}} y guarda.
Para WhatsApp oficial: después de crear, usa Sincronizar o Publicar en Meta en la instancia oficial, guía completa.
1B, a través de API
Alcance: templates:create.
Respuesta esperada: 200 con enabledChannels (por ejemplo, ["email","sms"]).
Otras cargas útiles del canal: Variables y CRUD.
2. Enviar por plantilla
Ámbitos en este ejemplo: sms:send, email:send.
Respuesta esperada: 202
Only IDs for channels that generated sends appear. Per channel: messageIds (WhatsApp), smsIds, emailIds, telegramIds, rcsIds, pushIds, voiceCallIds.
WhatsApp in the same template
Include whatsapp in channels and instanceId (if no workspace default):
Línea oficial: la plantilla debe estar vinculada/aprobada en Meta (WHATSAPP_OFFICIAL, APPROVED). Ver Metaplantillas oficiales.
3. Seguimiento de resultados
Próximos pasos
