Plantillas alojadas

Ciclo de vida

Una plantilla tiene un ID y una clave estables, un borrador editable, cero o más versiones publicadas inmutables y un ciclo de vida activo o archivado. Archivarla impide nuevos envíos por clave sin eliminar las versiones históricas ni el uso.

Variables

Declare las variables con claves, tipos, obligatoriedad y valores predeterminados opcionales. El renderizado falla con 422 cuando los datos proporcionados no cumplen el contrato publicado. Los valores insertados se escapan según el contexto.

Guardado automático optimista

Cada borrador lleva una revisión. Envíe la revisión actual a PUT /templates/:id/draft. Si otro editor guardó antes, SendHQ devuelve 409; vuelva a cargar antes de sobrescribir.

Previsualizar, probar, publicar

1. Renderice con datos de ejemplo representativos.
2. Resuelva todos los hallazgos de error.
3. Envíe una instantánea de prueba a una dirección que controle.
4. Publique el borrador exacto como versión inmutable.

Enviar por clave

{
  "from": "hello@example.com",
  "to": [
    "customer@example.net"
  ],
  "template": {
    "key": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

Un envío de plantilla personalizada requiere exactamente un destinatario To y ningún Cc ni Bcc. Use el endpoint de lotes para destinatarios individualizados.

Trazabilidad

Cada envío con plantilla registra la plantilla, la versión, la versión del compilador y el hash del contenido renderizado, de modo que un mensaje histórico se pueda rastrear hasta el contenido que lo generó.