Riferimento

Tipi di evento

Tutti i tipi di evento webhook che Emailit invia, quando viene generato ciascuno, quale oggetto contiene e quali tipi mancano nel selettore del pannello.

Aggiornato il 1 ott 2026

Questo è l’elenco completo dei tipi di evento che Emailit invia ai webhook e registra nel flusso di eventi. Il data.object di ogni evento contiene la risorsa a cui l’evento si riferisce; la colonna Oggetto mostra il suo valore object. Seleziona il nome di un evento per vederne il payload completo, dove esiste una pagina di riferimento.

Un webhook con All events attivo riceve tutti i tipi elencati qui sotto. Quando scegli gli eventi nel pannello, alcuni tipi non compaiono nel selettore; sono indicati con «Non nel selettore» e puoi aggiungerli con Aggiorna un webhook.

Eventi delle email

Evento	Oggetto	Quando viene generato
`email.accepted`	`email`	Un’email inviata con l’API o con Compose è stata accettata e messa in coda. Non viene inviato per le email SMTP.
`email.scheduled`	`email`	È stata salvata un’email inviata con l’API con un `scheduled_at` nel futuro. Include `scheduled_at`.
`email.delivered`	`email`	Il server di posta del destinatario ha accettato il messaggio.
`email.attempted`	`email`	Un tentativo di consegna non è riuscito temporaneamente e verrà ritentato. Inviato per ogni tentativo; include `smtp_code`, `smtp_enhanced_code` e `smtp_response`.
`email.bounced`	`email`	La consegna non è riuscita in modo permanente, è arrivato un report di bounce dopo la consegna, oppure i nuovi tentativi si sono esauriti.
`email.failed`	`email`	L’elaborazione non è riuscita a causa di un errore, non di una risposta del server del destinatario. Raro.
`email.rejected`	`email`	Emailit si è rifiutato di inviare a un destinatario perché il workspace non è verificato.
`email.suppressed`	`email`	Il destinatario è nella lista di soppressione, quindi l’email non è stata inviata.
`email.held`	`email`	L’email è stata trattenuta e non inviata: workspace sospeso, dominio in pausa, crediti insufficienti, punteggio spam pari o superiore a 7, oppure una chiave API impostata per trattenere le email. Non nel selettore.
`email.canceled`	`email`	L’email è stata annullata nel pannello o con l’API. Include `status` e `previous_status`. Non nel selettore.
`email.received`	`email`	Un messaggio è arrivato sul tuo sottodominio di ricezione. Contiene solo `id`, `from`, `to`, `subject` e `created_at`.
`email.complained`	`email`	Il destinatario ha segnalato l’email come spam tramite il feedback loop del suo provider.
`email.loaded`	`load`	L’immagine di tracciamento è stata caricata. Inviato per ogni caricamento, non solo per il primo.
`email.clicked`	`click`	È stato cliccato un link tracciato. Inviato per ogni clic; include `link.url`.
`email.unsubscribed`	`email`	Un destinatario si è disiscritto con il link o la pagina di disiscrizione di un’email di una campagna. Include `campaign`, `contact` e `unsubscribed_at`. Non nel selettore.
`email.resubscribed`	`email`	Un destinatario si è reiscritto dalla pagina di disiscrizione. Include `campaign`, `contact` e `resubscribed_at`. Non nel selettore.

Gli eventi di stato delle email (da email.accepted a email.complained qui sopra) contengono id, from, to, subject, status e meta dell’email, più i timestamp. Gli eventi di clic e di caricamento contengono il proprio id, l’email_id, un oggetto email annidato (rcpt_to, mail_from, subject, campaign, meta), il contact corrispondente se esiste, ip_address e user_agent. Per il significato di ogni stato delle email, vedi Stati delle email.

Eventi dei domini

Evento	Oggetto	Quando viene generato
`domain.created`	`domain`	È stato aggiunto un dominio di invio.
`domain.updated`	`domain`	Sono cambiate le impostazioni di un dominio, ad esempio il tracciamento o la chiave di un sottodominio. I risultati della verifica DNS non generano questo evento.
`domain.deleted`	`domain`	È stato eliminato un dominio.

Eventi delle liste e degli iscritti

Evento	Oggetto	Quando viene generato
`audience.created`	`audience`	È stata creata una lista.
`audience.updated`	`audience`	Una lista è stata rinominata.
`audience.deleted`	`audience`	È stata eliminata una lista.
`subscriber.created`	`subscriber`	Un contatto è stato aggiunto a una lista.
`subscriber.updated`	`subscriber`	Un iscritto è stato modificato, compresa la disiscrizione dalla lista o la reiscrizione.
`subscriber.deleted`	`subscriber`	Un contatto è stato rimosso da una lista, anche quando il contatto è stato eliminato.
`subscriber.resubscribed`	`subscriber`	Un contatto disiscritto è stato aggiunto di nuovo alla lista. Inviato insieme a `subscriber.updated`. Non nel selettore.

Gli oggetti iscritto includono subscribed, subscribed_at, unsubscribed_at, la lista in audience (id, name) e il contatto in contact (id, email, nomi e campi personalizzati).

Eventi di contatti, template e soppressioni

Evento	Oggetto	Quando viene generato
`contact.created`	`contact`	È stato creato un contatto.
`contact.updated`	`contact`	Sono cambiati i campi, i campi personalizzati o le liste di un contatto.
`contact.deleted`	`contact`	È stato eliminato un contatto.
`template.created`	`template`	È stato creato un template o una nuova versione di un template.
`template.updated`	`template`	Un template è stato modificato o pubblicato.
`template.deleted`	`template`	È stato eliminato un template.
`suppression.created`	`suppression`	È stata aggiunta una soppressione nel pannello, con l’API, tramite importazione CSV o da un’automazione.
`suppression.updated`	`suppression`	Sono cambiati il motivo o la scadenza di una soppressione.
`suppression.deleted`	`suppression`	È stata rimossa una soppressione.

Le soppressioni che la pipeline di consegna aggiunge automaticamente dopo un bounce o una segnalazione non generano suppression.created. Per tracciarle, ascolta gli eventi email.bounced e email.complained.

Eventi della verifica email

Evento	Oggetto	Quando viene generato
`email_verification.created`	`email_verification`	È stata richiesta la verifica di un singolo indirizzo.
`email_verification.updated`	`email_verification`	Una verifica è terminata e il suo esito è disponibile.
`email_verification_list.created`	`email_verification_list`	È stata creata una lista di verifica.
`email_verification_list.updated`	`email_verification_list`	È terminata l’elaborazione di una lista. Include `status` e `stats`.

Il selettore del pannello elenca anche email_verification.deleted e email_verification_list.deleted. Emailit non invia questi eventi.

Eventi delle campagne

Gli eventi delle campagne non sono nel selettore del pannello. Arrivano ai webhook con All events attivo, oppure puoi aggiungerli con l’API. Ognuno contiene un oggetto campaign con id, name, status, subject, from_email, from_name, scheduled_at, sent_at e created_at. I cambi di stato includono anche previous_status.

Evento	Quando viene generato
`campaign.created`	È stata creata una campagna.
`campaign.updated`	Sono cambiati il contenuto, il mittente o i destinatari di una campagna.
`campaign.deleted`	È stata eliminata una campagna.
`campaign.scheduled`	Una campagna è stata programmata per un momento futuro.
`campaign.queued`	Una campagna programmata ha raggiunto l’orario di invio ed è stata messa in coda.
`campaign.sending`	È iniziato l’invio di una campagna.
`campaign.testing`	Una campagna è entrata nello stato `testing`.
`campaign.sent`	È terminato l’invio di una campagna.
`campaign.canceled`	Una campagna è stata annullata.
`campaign.archived`	Una campagna è stata archiviata.

Nomi di eventi deprecati

Il gruppo Deprecated nel selettore del pannello elenca nomi di una versione precedente di Emailit: email.sent, email.opened, email.softfail, email.hardfail, email.error, email.delayed e email.processed. Non vengono più inviati. Usa invece email.delivered, email.loaded, email.attempted e email.bounced.

Richieste webhook

La struttura che racchiude ogni evento.

Configura un webhook

Scegli eventi e filtri.