Panoramica
Ogni email in Emailit ha uno stato che ti indica esattamente dove si trova nel suo ciclo di vita. Ci sono 12 stati, ognuno con un colore e un significato distinti. Lo stato riflette sempre la condizione più recente dell’email.
Riferimento Stati
| Stato | Colore | Descrizione |
|---|---|---|
| accepted | 🟡 | L’email è stata accettata per la consegna ed è in elaborazione. |
| scheduled | 🟡 | L’email è programmata per la consegna in un momento futuro specificato da scheduled_at. |
| delivered | 🟢 | L’email è stata consegnata con successo al server di posta del destinatario. |
| bounced | 🔴 | L’email non è riuscita a essere consegnata definitivamente. Il server di posta del destinatario ha rifiutato il messaggio (rimbalzo permanente). |
| attempted | 🟠 | È stato tentato l’invio ma si è verificato un errore temporaneo. Il sistema potrebbe riprovare automaticamente. |
| failed | 🔴 | L’email non è riuscita a essere consegnata a causa di un errore specifico durante il processo di invio. |
| rejected | 🔴 | L’email è stata inizialmente accettata per la consegna ma è stata successivamente rifiutata. |
| loaded | 🔵 | Il contenuto dell’email è stato caricato dal destinatario. Viene utilizzato per il tracciamento delle aperture e richiede che il tracciamento sia abilitato sul dominio mittente. |
| clicked | 🟣 | Un link all’interno dell’email è stato cliccato dal destinatario. Richiede che il tracciamento dei clic sia abilitato sul dominio mittente. |
| suppressed | ⚪ | L’indirizzo email del destinatario è nella lista di soppressione e l’email non è stata inviata. |
| received | 🟢 | Un’email in arrivo è stata ricevuta sul tuo dominio. |
| complained | 🔴 | È stato registrato un reclamo per spam (feedback loop) per questa email da parte del destinatario. |
Flusso degli Stati
Un’email tipica attraversa il seguente flusso:
- accepted — l’email entra nel sistema
- delivered — il server di posta del destinatario la accetta
- loaded — il destinatario apre l’email (se il tracciamento è abilitato)
- clicked — il destinatario clicca su un link (se il tracciamento è abilitato)
Se qualcosa va storto, l’email potrebbe finire in uno degli stati di errore:
- attempted — errore temporaneo, potrebbe essere ritentato
- bounced — errore permanente, non verrà ritentato
- failed — errore di consegna
- rejected — rifiutata dopo l’accettazione iniziale
Email Programmate
Quando invii un’email con un timestamp scheduled_at nel futuro, entra nello stato scheduled invece di accepted. L’email verrà elaborata e consegnata all’orario specificato.
Puoi annullare un’email programmata prima che venga inviata, o aggiornare l’orario programmato.
Email Soppresse
Se il destinatario è nella lista di soppressione del tuo workspace, l’email riceverà immediatamente lo stato suppressed e non verrà consegnata. Questo protegge la tua reputazione di mittente evitando indirizzi notoriamente problematici.
Stati di Tracciamento
Gli stati loaded e clicked richiedono che il tracciamento sia abilitato sul tuo dominio mittente. Quando abilitato:
- loaded viene registrato quando il pixel di tracciamento nell’email viene caricato
- clicked viene registrato quando un link tracciato nell’email viene seguito
Questi stati includono metadati aggiuntivi come l’indirizzo IP del destinatario e lo user agent.
Verificare lo Stato dell’Email
Puoi verificare lo stato attuale di qualsiasi email utilizzando l’endpoint Ottieni Email, o consultare gli stati delle email nella Dashboard di Emailit.