Stavy zpráv

Stav	Význam	Kredit
queued	Přijato, čeká na odesílač	rezervovaný
sending	Odesílač zprávu renderuje a komunikuje s poskytovatelem	rezervovaný
sent	Poskytovatel zprávu přijal	spotřebovaný
delivered	Poskytovatel potvrdil doručení na server příjemce (vyžaduje webhooky)	spotřebovaný
bounced	Server příjemce zprávu odmítl; při hard bounce se adresa přidá na suppression list	spotřebovaný
complained	Příjemce zprávu označil jako spam; adresa se blokuje	spotřebovaný
failed	Trvalá chyba, nebo dočasné chyby vyčerpaly všechny opakované pokusy	vrácený (ne, pokud zprávu už mohl přijmout vlastní SMTP server, nebo když selhává neobvykle velký podíl odeslání organizace)
held	Čeká na kredity v hold frontě	zatím žádný
held_service_error	Čeká na opravu nefunkční služby	vrácený, při uvolnění se znovu rezervuje
discarded	Odstraněno z hold fronty – vypršela platnost, nebo bylo zahozeno ručně	žádný

Při odeslání vrací API queued, nebo held. Všechny ostatní stavy uvidíte přes getStatus() / GET /v1/messages/:id, v Historii v dashboardu nebo přes history() v Node SDK.

Typické průběhy

queued → sending → sent → delivered
queued → sending → sent → bounced
queued → sending → (retry …) → sent
queued → sending → (failover to fallback service) → sent
queued → sending → failed
held → (credits added) → queued → sending → sent
held → (hold duration over) → discarded
queued → sending → (auth error, no fallback) → held_service_error → (service fixed) → queued → …

Události v časové ose

Každá zpráva má časovou osu událostí s časovými razítky. Detail zprávy v Historii je v dashboardu zobrazuje s těmito popisky:

Událost	Popisek v Historii	Význam
`held`	Pozdrženo	Zpráva se uložila mezi pozdržené
`released`	Uvolněno	Zpráva se uvolnila z pozdržených
`queued`	Ve frontě	Čeká na odesílač
`sending`	Odesílá se	Předává se poskytovateli
`sent`	Odesláno	Poskytovatel zprávu přijal
`failover`	Přepnuto na záložní službu	Hlavní služba selhala, použila se záložní
`retry`	Naplánován další pokus	Dočasná chyba, následuje další pokus
`auto_reply`	Vytvořena automatická odpověď	K této zprávě vznikla automatická odpověď
`delivered`	Doručeno	Doručení potvrzené webhookem
`bounced`	Odraženo	Trvalý odraz (stav `bounced`) nebo dočasný odraz (jen událost, poskytovatel to zkouší dál)
`complained`	Označeno jako spam	Příjemce si stěžoval
`opened` / `clicked`	Otevřeno / Kliknuto na odkaz	Sledování otevření a kliknutí od poskytovatele
`failed`	Selhalo	Trvalá chyba
`refunded`	Kredit vrácen	Zarezervovaný kredit se vrátil do svého grantu
`discarded`	Zahozeno	Zpráva byla odstraněna z pozdržených

opened a clicked jsou události, ne stavy – doručená zpráva, která byla otevřena, zůstává ve stavu delivered. Sledování otevření závisí na poskytovateli a na tom, jestli příjemce načte obrázky, takže ho berte jako odhad.

Doba uchování

Zprávy a jejich vyrenderovaný obsah se uchovávají po dobu historie podle tarifu, na kterém odešly (7 až 180 dní, viz Tarify), a pak se smažou.