Vai al contenuto

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.

GDi

Stati delle email più semplici

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

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

Condividi

Prova quello di cui hai appena letto.

3000 email al mese gratis. Nessuna carta di credito richiesta.

3000 email al mese gratis · Nessuna carta di credito