Eventi dei template
Versioni dei template create, aggiornate, pubblicate o eliminate.
template.created
Inviato quando viene creata una versione di un template: con Crea un template, importando un template nel pannello o salvando una campagna come template. Una versione creata per un nuovo alias viene pubblicata subito; controlla published_at.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre template.created.
objectobjectLa versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto template
idstringID della versione del template (tem_…).
objectstringSempre template.
namestringNome del template.
aliasstringAlias condiviso da tutte le versioni del template.
fromstring | nullMittente predefinito.
subjectstring | nullRiga dell’oggetto predefinita.
reply_tostring[] | nullIndirizzi di risposta (Reply-To) predefiniti.
htmlstring | nullCorpo HTML.
textstring | nullCorpo in testo semplice.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullQuando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.
created_atstringQuando è stata creata la versione, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la versione.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.created",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
}
}
}template.updated
Inviato quando una versione di un template cambia con Aggiorna un template. Anche la pubblicazione genera questo evento: una volta per la versione che pubblichi e una volta per ogni versione dell’alias che è stata ritirata. Usa published_at per distinguerle.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre template.updated.
objectobjectLa versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto template
idstringID della versione del template (tem_…).
objectstringSempre template.
namestringNome del template.
aliasstringAlias condiviso da tutte le versioni del template.
fromstring | nullMittente predefinito.
subjectstring | nullRiga dell’oggetto predefinita.
reply_tostring[] | nullIndirizzi di risposta (Reply-To) predefiniti.
htmlstring | nullCorpo HTML.
textstring | nullCorpo in testo semplice.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullQuando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.
created_atstringQuando è stata creata la versione, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la versione.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.updated",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-10-01T10:02:14.307000+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-10-01T10:02:14.307000+00:00"
}
}
}template.deleted
Inviato quando viene eliminata una versione di un template con Elimina un template. Il payload è la versione com’era prima di essere eliminata. Se era la versione pubblicata, l’alias resta senza versione pubblicata finché non ne pubblichi un’altra.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.
typestringSempre template.deleted.
objectobjectLa versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto template
idstringID della versione del template (tem_…).
objectstringSempre template.
namestringNome del template.
aliasstringAlias condiviso da tutte le versioni del template.
fromstring | nullMittente predefinito.
subjectstring | nullRiga dell’oggetto predefinita.
reply_tostring[] | nullIndirizzi di risposta (Reply-To) predefiniti.
htmlstring | nullCorpo HTML.
textstring | nullCorpo in testo semplice.
editorstringhtml, text, dragit o tiptap.
published_atstring | nullQuando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.
created_atstringQuando è stata creata la versione, in formato ISO 8601 con offset UTC.
updated_atstringQuando è stata aggiornata l’ultima volta la versione.
{
"event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
"type": "template.deleted",
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
},
"data": {
"object": {
"id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
"object": "template",
"name": "Welcome email",
"alias": "welcome-email",
"from": "Acme <hello@acme.com>",
"subject": "Welcome to Acme, {{ first_name }}",
"reply_to": [
"support@acme.com"
],
"html": "<h1>Welcome, {{ first_name }}</h1>",
"text": "Welcome, {{ first_name }}",
"editor": "html",
"published_at": "2026-09-30T10:30:00.482119+00:00",
"created_at": "2026-09-30T10:30:00.482119+00:00",
"updated_at": "2026-09-30T10:30:00.482119+00:00"
}
}
}