Stati delle email

Ogni email ha uno stato che indica a che punto è del suo ciclo di vita. Questa pagina elenca tutti i 14 stati, come un’email passa dall’uno all’altro e cosa fare quando un’email si ferma dove non te lo aspettavi. Lo stato è solo la condizione più recente; lo storico completo si trova nella pagina di dettaglio dell’email e negli eventi.

Riferimento degli stati

«Definitivo» significa che Emailit non cambierà più lo stato di sua iniziativa. Un’email in uno stato definitivo si può comunque ritentare, e questo crea una nuova email con un nuovo ID.

I webhook ricevono email.canceled ed email.held quando sono iscritti a tutti gli eventi, oppure quando li aggiungi all’elenco di eventi del webhook con l’API. Vedi Tipi di evento.

Ciclo di vita

La maggior parte delle email segue questo percorso:

1. Creazione. Un invio via API crea l’email come accepted, oppure scheduled quando scheduled_at è nel futuro. Anche gli invii SMTP partono come accepted. La posta in entrata viene creata come received e non cambia mai.
2. Controlli. Prima di ogni tentativo di consegna, Emailit controlla workspace, dominio, chiave API, crediti, lista di soppressione e punteggio spam. Un controllo non superato chiude l’email come held, rejected o suppressed senza inviarla.
3. Consegnata o rinviata. Il tentativo di consegna riesce (delivered), non riesce temporaneamente (attempted, poi ritentata) o non riesce in modo permanente (bounced).
4. Engagement. Se il tracciamento è attivo, aperture e clic portano un’email consegnata a loaded e poi a clicked.
5. Report tardivi. Un report di bounce che arriva dopo la consegna cambia lo stato in bounced. Una segnalazione di spam lo cambia in complained.

In qualsiasi momento prima della consegna, un’email scheduled, accepted o attempted può diventare canceled.

La scala dell’engagement

Gli stati di consegna e di engagement possono solo avanzare:

accepted, scheduled o attempted → delivered → loaded → clicked

Un evento successivo non fa mai scendere un’email lungo la scala. Se viene registrato un clic, l’email resta clicked anche quando arrivano altre aperture. Un’apertura o un clic possono saltare oltre delivered, perché dimostrano che il messaggio è arrivato. Gli stati che chiudono la consegna (bounced, failed, rejected, suppressed, complained e canceled) non vengono mai sovrascritti da aperture o clic.

Calendario dei nuovi tentativi per attempted

Quando un server ricevente risponde con un errore temporaneo (una risposta 4xx come 421 o 451, un timeout o un errore di connessione), l’email diventa attempted ed Emailit riprova. Ogni attesa è lunga il doppio della precedente:

In tutto sono 7 tentativi di consegna in circa 21 ore. Quando si esauriscono, l’email viene segnata come bounced con «Maximum number of delivery attempts (7) has been reached», e il destinatario viene aggiunto alle soppressioni con il motivo too many soft fails, a meno che le impostazioni di soppressione automatica non escludano i bounce.

Ogni tentativo è elencato nella scheda Deliveries dell’email con la risposta del server, e ognuno invia un evento email.attempted che include smtp_code, smtp_enhanced_code e smtp_response. Alcune risposte temporanee che indicano chiaramente un problema permanente, come una casella disattivata, vengono trattate subito come bounce. Quando un provider limita la velocità, Emailit può anche sospendere brevemente la consegna verso di esso; quelle righe dicono «Delivery delayed due to…».

Perché un’email viene trattenuta

Un’email trattenuta è stata tolta dalla coda di invio senza essere inviata. La scheda Deliveries dell’email mostra quale motivo si è applicato:

Le email trattenute non vengono rilasciate automaticamente. Dopo aver risolto la causa, seleziona Retry sull’email, oppure chiama Ritenta un’email. Il nuovo tentativo crea una nuova email con lo stesso contenuto e addebita di nuovo i crediti.

Perché un’email viene rifiutata

Finché il tuo workspace non ha l’accesso alla produzione, puoi inviare solo agli indirizzi email degli account dei membri del workspace. Per gli altri destinatari, l’API restituisce 403 e SMTP restituisce 550 al momento dell’invio, quindi di solito vedi l’errore invece di un’email. Lo stato rejected compare quando lo stesso controllo non viene superato più tardi, al momento della consegna, ad esempio per un’email programmata in precedenza. La scheda Deliveries mostra «Unverified workspaces can only send to workspace members’ account emails» e l’indirizzo bloccato.

Regole per i nuovi tentativi

Per un’email soppressa, rimuovi prima l’indirizzo dalla lista di soppressione, altrimenti anche il nuovo tentativo viene soppresso.

Vedi anche