DocumentacionPlantillas y versiones

Plantillas y versiones

Draft vs Published y envio con templateVersionId.

Las plantillas de MailingCore usan contenido versionado. Cada plantilla puede tener varias versiones; solo una version Published puede usarse en envios de produccion.

Draft vs Published

Estado	Editable	Usable en `POST /emails/send`
Draft	Si	No
Published	No (crea un nuevo draft o despublica antes)	Si

Flujo:

Crear plantilla (POST /templates) con version inicial (Draft).
Editar HTML, asunto y variables en el panel o con PATCH /templates/:id/versions/:versionId.
Publicar la version cuando este lista — ver Flujo de publicacion.
Enviar con templateVersionId apuntando al ID de la version publicada.

{
  "to": "[email protected]",
  "subject": "Pedido confirmado",
  "htmlBody": "<p>Respaldo si no usas plantilla</p>",
  "templateVersionId": "clxversion_published..."
}

Con templateVersionId, MailingCore renderiza el HTML y asunto publicados. Puedes sobrescribir subject en el payload si tu integracion lo requiere.

Variantes por idioma

Las versiones pueden incluir locale (es, en, it, fr, ca, de) y localeGroupId para agrupar traducciones equivalentes. Las campanas pueden elegir la mejor coincidencia por contacto.

Endpoints de gestion

Accion	Endpoint	Auth
Listar plantillas	`GET /templates`	JWT
Crear plantilla	`POST /templates`	JWT
Anadir version	`POST /templates/:id/versions`	JWT
Actualizar version	`PATCH /templates/:id/versions/:versionId`	JWT
Publicar	`POST /templates/:id/versions/:versionId/publish`	JWT

El CRUD de plantillas requiere JWT del panel, no API key. El envio usa API key con email:send.

Siguientes pasos

Publicar una version (CSS inline, produccion)
Variables en plantillas ({{name}}, {{unsubscribeUrl}})
Enviar email con templateVersionId