Vai al contenuto
Docs

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_idstring

ID 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.

typestring

Sempre template.created.

objectobject

La versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto template

idstring

ID della versione del template (tem_…).

objectstring

Sempre template.

namestring

Nome del template.

aliasstring

Alias condiviso da tutte le versioni del template.

fromstring | null

Mittente predefinito.

subjectstring | null

Riga dell’oggetto predefinita.

reply_tostring[] | null

Indirizzi di risposta (Reply-To) predefiniti.

htmlstring | null

Corpo HTML.

textstring | null

Corpo in testo semplice.

editorstring

html, text, dragit o tiptap.

published_atstring | null

Quando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.

created_atstring

Quando è stata creata la versione, in formato ISO 8601 con offset UTC.

updated_atstring

Quando è stata aggiornata l’ultima volta la versione.

JSON
{
  "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_idstring

ID 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.

typestring

Sempre template.updated.

objectobject

La versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto template

idstring

ID della versione del template (tem_…).

objectstring

Sempre template.

namestring

Nome del template.

aliasstring

Alias condiviso da tutte le versioni del template.

fromstring | null

Mittente predefinito.

subjectstring | null

Riga dell’oggetto predefinita.

reply_tostring[] | null

Indirizzi di risposta (Reply-To) predefiniti.

htmlstring | null

Corpo HTML.

textstring | null

Corpo in testo semplice.

editorstring

html, text, dragit o tiptap.

published_atstring | null

Quando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.

created_atstring

Quando è stata creata la versione, in formato ISO 8601 con offset UTC.

updated_atstring

Quando è stata aggiornata l’ultima volta la versione.

JSON
{
  "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_idstring

ID 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.

typestring

Sempre template.deleted.

objectobject

La versione del template descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto template

idstring

ID della versione del template (tem_…).

objectstring

Sempre template.

namestring

Nome del template.

aliasstring

Alias condiviso da tutte le versioni del template.

fromstring | null

Mittente predefinito.

subjectstring | null

Riga dell’oggetto predefinita.

reply_tostring[] | null

Indirizzi di risposta (Reply-To) predefiniti.

htmlstring | null

Corpo HTML.

textstring | null

Corpo in testo semplice.

editorstring

html, text, dragit o tiptap.

published_atstring | null

Quando è stata pubblicata questa versione, oppure null se non è la versione pubblicata.

created_atstring

Quando è stata creata la versione, in formato ISO 8601 con offset UTC.

updated_atstring

Quando è stata aggiornata l’ultima volta la versione.

JSON
{
  "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"
    }
  }
}

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.