Stati dei messaggi

Stato	Significato	Credito
queued	Accettato, in attesa del mittente	riservato
sending	Il mittente lo sta renderizzando e sta comunicando con il provider	riservato
sent	Il provider l’ha accettato	usato
delivered	Il provider ha confermato il recapito al server del destinatario (richiede i webhook)	usato
bounced	Il server del destinatario l’ha rifiutato; gli hard bounce aggiungono l’indirizzo alla lista di soppressione	usato
complained	Il destinatario l’ha segnalato come spam; l’indirizzo viene soppresso	usato
failed	Errore permanente, oppure gli errori temporanei hanno esaurito tutti i tentativi	rimborsato (non quando un server SMTP personalizzato potrebbe aver già ricevuto il messaggio, né quando fallisce una quota insolitamente alta degli invii dell’organizzazione)
held	In attesa di crediti nella coda dei messaggi in attesa	non ancora
held_service_error	In attesa che un servizio non funzionante venga sistemato	rimborsato, riservato di nuovo al rilascio
discarded	Rimosso dalla coda dei messaggi in attesa – il tempo di attesa è scaduto o qualcuno l’ha scartato manualmente	nessuno

Al momento dell’invio l’API restituisce queued o held. Tutto il resto lo vedi tramite getStatus() / GET /v1/messages/:id, nella Cronologia o con history() dell’SDK Node.

Flussi tipici

queued → sending → sent → delivered
queued → sending → sent → bounced
queued → sending → (nuovo tentativo …) → sent
queued → sending → (passaggio al servizio di riserva) → sent
queued → sending → failed
held → (crediti aggiunti) → queued → sending → sent
held → (tempo di attesa scaduto) → discarded
queued → sending → (errore di autenticazione, nessuna riserva) → held_service_error → (servizio sistemato) → queued → …

Eventi della cronologia

Ogni messaggio ha una cronologia di eventi con data e ora. Il dettaglio della Cronologia nella dashboard li mostra con queste etichette:

Evento	Etichetta nella Cronologia	Significato
`held`	In attesa	Salvato nella coda dei messaggi in attesa
`released`	Rilasciata	Rilasciato dalla coda dei messaggi in attesa
`queued`	In coda	In attesa del mittente
`sending`	Invio in corso	Consegnato al provider
`sent`	Inviata	Il provider l’ha accettato
`failover`	Passata al servizio di riserva	Il servizio principale non ha funzionato, è stato usato quello di riserva
`retry`	Nuovo tentativo pianificato	Errore temporaneo, seguirà un altro tentativo
`auto_reply`	Risposta automatica creata	Per questo messaggio è stata creata una risposta automatica
`delivered`	Recapitata	Recapito confermato tramite webhook
`bounced`	Non recapitata	Hard bounce (stato `bounced`) o soft bounce (solo evento, il provider continua a riprovare)
`complained`	Segnalata come spam	Il destinatario ha inviato una segnalazione
`opened` / `clicked`	Aperta / Link cliccato	Tracciamento di aperture e clic da parte del provider
`failed`	Non riuscita	Errore permanente
`refunded`	Credito rimborsato	Il credito riservato è tornato alla sua assegnazione
`discarded`	Scartata	Rimosso dalla coda dei messaggi in attesa

opened e clicked sono eventi, non stati: un messaggio recapitato e poi aperto resta delivered. Il tracciamento delle aperture dipende dal provider e dal fatto che il destinatario carichi le immagini, quindi consideralo una stima.

Conservazione

I messaggi e il loro contenuto renderizzato vengono conservati per il periodo di cronologia del piano con cui sono stati inviati (da 7 a 180 giorni, vedi Piani), poi eliminati.