Template e versioni

Draft vs Published e invio con templateVersionId.

I template MailingCore usano contenuto versionato. Ogni template puo avere piu versioni; solo una versione Published puo essere usata negli invii di produzione.

Draft vs Published

Stato	Modificabile	Usabile in `POST /emails/send`
Draft	Si	No
Published	No (crea un nuovo draft o annulla pubblicazione)	Si

Flusso:

Crea template (POST /templates) con versione iniziale (Draft).
Modifica HTML, oggetto e variabili nel pannello o con PATCH /templates/:id/versions/:versionId.
Pubblica la versione quando e pronta — vedi Flusso di pubblicazione.
Invia con templateVersionId impostato sull'ID della versione pubblicata.

{
  "to": "[email protected]",
  "subject": "Ordine confermato",
  "htmlBody": "<p>Fallback se non usi il template</p>",
  "templateVersionId": "clxversion_published..."
}

Con templateVersionId, MailingCore renderizza HTML e oggetto pubblicati. Puoi sovrascrivere subject nel payload se serve.

Varianti per lingua

Le versioni possono includere locale (es, en, it, fr, ca, de) e localeGroupId per raggruppare traduzioni equivalenti. Le campagne possono scegliere la migliore corrispondenza per contatto.

Endpoint di gestione

Azione	Endpoint	Auth
Elenca template	`GET /templates`	JWT
Crea template	`POST /templates`	JWT
Aggiungi versione	`POST /templates/:id/versions`	JWT
Aggiorna versione	`PATCH /templates/:id/versions/:versionId`	JWT
Pubblica	`POST /templates/:id/versions/:versionId/publish`	JWT

Il CRUD template richiede JWT del pannello, non API key. L'invio usa API key con email:send.

Prossimi passi

Pubblicare una versione (CSS inline, produzione)
Variabili nei template ({{name}}, {{unsubscribeUrl}})
Inviare email con templateVersionId