Tecnologia4 min di lettura
Stati delle email più semplici
Abbiamo sostituito i vecchi stati delle email con un sistema più chiaro e coerente. Ecco cosa è cambiato e come i nuovi stati corrispondono a quelli precedenti.
GDiGeorge

Gli stati delle email sono una delle parti più importanti dell’API: ti dicono esattamente a che punto si trova un’email nel suo ciclo di vita. Nel tempo, il nostro set originale di stati è cresciuto in modo organico ed è diventato confuso: qual è la differenza tra error e softfail? held è la stessa cosa di pending? Abbiamo deciso di fare pulizia.
I nuovi stati
Ora abbiamo 12 stati chiari, ognuno con un significato e un colore distinti:
Stato | Colore | Descrizione |
|---|---|---|
accepted | 🟡 | Accettata per la consegna |
scheduled | 🟡 | Programmata per una consegna futura |
delivered | 🟢 | Consegnata al server di posta del destinatario |
bounced | 🔴 | Fallita definitivamente (hard bounce) |
attempted | 🟠 | Tentativo di consegna fallito temporaneamente |
failed | 🔴 | Consegna fallita a causa di un errore specifico |
rejected | 🔴 | Inizialmente accettata, poi rifiutata |
loaded | 🔵 | Il contenuto dell’email è stato caricato (tracciamento aperture) |
clicked | 🟣 | Un link nell’email è stato cliccato |
suppressed | ⚪ | Il destinatario è nella lista di soppressione |
received | 🟢 | Email in entrata accettata |
complained | 🔴 | È stata registrata una segnalazione di spam |
Cosa è cambiato rispetto ai vecchi stati
I vecchi stati sono deprecati. Ecco come corrispondono ai nuovi:
Vecchio stato (deprecato) | Nuovo stato |
|---|---|
|
|
|
|
| (rimosso) |
| (rimosso) |
|
|
|
|
|
|
|
|
| (rimosso) |
| (rimosso) |
Gli stati rinominati sono più descrittivi: loaded chiarisce che stiamo tracciando il caricamento del contenuto dell’email (non necessariamente l’apertura da parte di una persona), attempted è meno ambiguo di softfail, e bounced è universalmente compreso.
Compatibilità con le versioni precedenti
Tutte le email esistenti e le loro consegne sono state migrate ai nuovi stati. Non vedrai più i vecchi nomi degli stati nei record delle email o delle consegne, indipendentemente da quando sono stati creati.
L’unico posto in cui i vecchi nomi degli stati potrebbero ancora comparire sono gli eventi e le richieste webhook già generati, inviati prima di questa modifica. Quei payload storici sono immutabili e manterranno i valori di stato originali con cui sono stati creati.
Se nel tuo codice stai filtrando o confrontando i valori degli stati, aggiorna le tue integrazioni per utilizzare i nuovi nomi.


