Inicio rápido - Notifique

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 todos los 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. Push: aplicación. Voz: número ACTIVE
Autenticación: Authorization: Bearer sk_live_... o x-api-key
URL base: https://api.notifique.dev

1. Crear plantilla

1A, a través del panel

Plantillas → Nueva plantilla
Habilitar canales (SMS, correo, 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.

POST /v1/templates
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "name": "alerta_pedido",
  "category": "TRANSACTIONAL",
  "language": "pt_BR",
  "sms": {
    "enabled": true,
    "payload": { "content": "Pedido {{codigo}} despachado." }
  },
  "email": {
    "enabled": true,
    "payload": {
      "subject": "Pedido {{codigo}}",
      "html": "<p>Hola {{name}}, tu pedido salió.</p>"
    }
  },
  "whatsapp": { "enabled": false, "payload": {} },
  "telegram": { "enabled": false, "payload": {} },
  "rcs": { "enabled": false, "payload": {} },
  "push": { "enabled": false, "payload": {} },
  "voice": { "enabled": false, "payload": {} },
  "instagram": { "enabled": false, "payload": {} },
  "whatsapp_call": { "enabled": false, "payload": {} }
}

Respuesta esperada: 201 con enabledChannels (por ejemplo, ["email","sms"]).

Canal con enabled: false usa payload: {}. Pedir canal deshabilitado al enviar → 400 (TEMPLATE_CHANNEL_NOT_ENABLED).

Otras cargas útiles del canal: Variables y CRUD.

2. Enviar por plantilla

Ámbitos en este ejemplo: sms:send, email:send.

POST /v1/templates/send
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "template": "alerta_pedido",
  "channels": ["sms", "email"],
  "to": ["5511999999999", "cliente@email.com"],
  "variables": {
    "codigo": "12345",
    "name": "Maria"
  },
  "email": {
    "from": "Equipo Notifique <hola@midominio.com>"
  }
}

Respuesta esperada: 202

{
  "success": true,
  "data": {
    "messageIds": ["clsms1...", "clemail1..."],
    "status": "QUEUED",
    "count": 2
  }
}

La respuesta incluye messageIds con los IDs de todos los envíos creados.

WhatsApp en la misma plantilla

Incluya whatsapp en channels e informe whatsapp.from (si no hay predeterminado en el workspace):

{
  "template": "alerta_pedido",
  "channels": ["whatsapp", "sms"],
  "to": ["5511999999999"],
  "variables": { "codigo": "12345", "name": "Maria" },
  "whatsapp": {
    "from": "cuid_instancia_whatsapp"
  }
}

Línea oficial: la plantilla debe estar vinculada/aprobada en Meta (WHATSAPP_OFFICIAL, APPROVED). Ver Metaplantillas oficiales.

Push, Voz, Instagram y WhatsApp Call

Push: channels: ["push"] + push.from + device IDs en to
Voz: channels: ["voice"] + voice.from + números con prefijo + en to (ej.: +5511999887766)
Instagram: channels: ["instagram"] + instagram.from (si no hay predeterminado) + peer id o @username en to
WhatsApp Call: channels: ["whatsapp_call"] + whatsapp_call.from (o from en el bloque) + teléfono E.164 en to

3. Campos principales del envío

Campo	Requerido	Descripción
`template`	Sí	ID o nombre de la plantilla
`channels`	Sí	Canales habilitados en la plantilla
`to`	Sí	Hasta 500 destinatarios
`variables`	Según plantilla	Valores para `{{clave}}`
`whatsapp.from`	Si `whatsapp` sin predeterminado	Instancia o pool
`email.from`	Si correo sin predeterminado	Remitente verificado (RFC 5322)
`push.from`	Si `push`	App de push
`voice.from`	Si `voice`	Número de origen
`instagram.from`	Si `instagram` sin predeterminado	Instancia Instagram
`schedule.sendAt`	No	Programación (ISO 8601)

4. Seguimiento de resultados

Qué	Dónde
Entrega SMS, correo, WhatsApp…	Webhooks del canal (`sms.delivered`, `message.sent`, …)
Meta aprobó/rechazó plantilla	Webhooks *`template.`**, Eventos de webhook
Errores de validación / Meta	Respuestas de error

Errores comunes

HTTP	Significado
400	Canal no habilitado, variable faltante, plantilla Meta no aprobada
403	Ámbito ausente o créditos insuficientes
404	Plantilla, instancia o app no encontrada

Próximos pasos

Metaplantillas oficiales: sincronización y aprobación
Variables y CRUD: fusión y edición
Ámbitos: permisos
Eventos de webhook: template.*

​En resumen

​Antes de empezar

​1. Crear plantilla

​1A, a través del panel

​1B, a través de API

​2. Enviar por plantilla

​WhatsApp en la misma plantilla

​Push, Voz, Instagram y WhatsApp Call

​3. Campos principales del envío

​4. Seguimiento de resultados

​Errores comunes

​Próximos pasos

En resumen

Antes de empezar

1. Crear plantilla

1A, a través del panel

1B, a través de API

2. Enviar por plantilla

WhatsApp en la misma plantilla

Push, Voz, Instagram y WhatsApp Call

3. Campos principales del envío

4. Seguimiento de resultados

Errores comunes

Próximos pasos