Crear y usar plantillas

Una plantilla guarda un nombre interno, asunto, cuerpo y tipo de contenido. Resulta útil cuando varias notificaciones comparten estructura y solo cambian algunos datos.

Crear una plantilla desde el panel

1. Abre Plantillas y pulsa Nueva plantilla.
2. Si aparece un ejemplo cercano a tu caso, selecciónalo como punto de partida.
3. Escribe un nombre descriptivo que no verá el destinatario.
4. Define el asunto y el mensaje.
5. Elige texto plano o HTML.
6. Añade variables de prueba y usa Vista previa.
7. Guarda la plantilla.

Después de guardarla, vuelve al listado y usa Ver ID para copiar el identificador requerido por la API.

Definir variables

Las variables usan la sintaxis de templates de Go:

Hola {{.Nombre}}, tu pedido {{.Pedido}} está listo

Un cuerpo de texto podría ser:

Hola {{.Nombre}},

Puedes retirar el pedido {{.Pedido}} desde {{.Fecha}}.

Los nombres distinguen mayúsculas y minúsculas. {{.Nombre}} y {{.nombre}} son variables diferentes.

Probar antes de guardar

En Variables de prueba, escribe una pareja por línea:

Nombre=Ana
Pedido=PED-1042
Fecha=10 de agosto

La vista previa utiliza esos datos únicamente para mostrar el resultado. Las variables de prueba no forman parte de la plantilla guardada ni se reutilizan en envíos reales.

Enviar usando la plantilla

curl -X POST https://notify.summitexplorerjd.ec/api/v1/notifications \
  -H "Authorization: Bearer $SUMMIT_NOTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "ana@example.com",
    "template_id": "c7a4e210-9d2b-4f6a-8e1c-3b5d7f9a0c2e",
    "variables": {
      "Nombre": "Ana",
      "Pedido": "PED-1042",
      "Fecha": "10 de agosto"
    }
  }'

Cuando incluyes template_id, la plantilla tiene prioridad sobre subject y body. La notificación hereda también el body_type, salvo que lo reemplaces explícitamente.

Trabajar con HTML

Para una plantilla HTML, selecciona HTML y escribe el marcado en el cuerpo:

<h1>Hola {{.Nombre}}</h1>
<p>Tu pedido <strong>{{.Pedido}}</strong> está listo.</p>

La vista previa se renderiza dentro de un marco aislado. Aun así, usa HTML sencillo y estilos compatibles con clientes de correo.

Evitar resultados incompletos

Si omites una variable referenciada, su lugar se renderiza como <no value>. Para evitar correos incorrectos:

• mantén una lista de variables esperadas junto al código que realiza el envío;
• prueba cada plantilla con valores representativos;
• no cambies el nombre de una variable sin actualizar a todos los consumidores;
• consulta el resultado renderizado desde el panel antes de publicar cambios.

Para el contrato completo, consulta la referencia de plantillas.