Semplificare gli Stati delle Email
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 consegna futura |
| delivered | 🟢 | Consegnata al server di posta del destinatario |
| bounced | 🔴 | Fallita definitivamente (rimbalzo permanente) |
| 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 arrivo accettata |
| complained | 🔴 | È stata registrata una segnalazione spam |
Cosa è cambiato rispetto ai vecchi stati
I vecchi stati sono deprecati. Ecco come corrispondono ai nuovi:
| Vecchio stato (deprecato) | Nuovo stato |
|---|---|
pending | accepted o scheduled |
sent | delivered |
held | (rimosso) |
hold_cancelled | (rimosso) |
softfail | attempted |
hardfail | bounced |
opened | loaded |
error | failed |
delayed | (rimosso) |
processed | (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 dove i vecchi nomi degli stati potrebbero ancora apparire è negli eventi e richieste webhook già attivati che sono stati 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.
Blog
Le ultime novità e aggiornamenti, direttamente da Emailit.
Rimani aggiornato con gli ultimi articoli del Blog di Emailit.
