DocumentacionFlujo de publicacion

Flujo de publicacion

POST .../publish, CSS inline y despublicar.

Publicar bloquea una version de plantilla para uso en produccion y prepara el HTML para clientes de correo.

Publicar una version

POST /templates/{templateId}/versions/{versionId}/publish
Authorization: Bearer <accessToken>
X-Tenant-Id: clxxxxxxxx

Requiere JWT del panel (la gestion de plantillas no esta disponible con API key actualmente).

Que ocurre al publicar

  1. CSS inline — los bloques <style> externos y hojas enlazadas se inlinedan en atributos HTML cuando es posible. Mejora el render en clientes que eliminan estilos del <head> (Gmail, Outlook).
  2. El estado pasa de Draft a Published.
  3. El ID de version es valido para templateVersionId en POST /emails/send y campanas.
{
  "id": "clxversion...",
  "status": "PUBLISHED",
  "publishedAt": "2026-06-30T10:00:00.000Z"
}

Despublicar

Para editar una version publicada, despublica primero:

POST /templates/{templateId}/versions/{versionId}/unpublish

La version vuelve a Draft. Los envios ya en cola no se ven afectados; los nuevos deben usar otra version publicada o htmlBody inline.

Flujo recomendado

Editar draft  →  Preview  →  Publicar  →  Enviar con templateVersionId
                  ↑                              |
                  └──── Despublicar para editar ─┘

Notas sobre CSS inline

  • Prefiere CSS simple y compatible con email (tablas, propiedades inline-friendly).
  • Layouts complejos (mucho flexbox) pueden no inlinedarse bien — prueba en clientes reales.
  • Se admiten exportaciones MJML y Unlayer via mjmlSource y unlayerDesign en la version.

Relacionado