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

2026-02-25 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

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.

---

Source: https://emailit.com/it/blog/semplificare-stati-email/
