Stavy správ

Stav	Význam	Kredit
queued	Prijatá, čaká na odosielač	rezervovaný
sending	Odosielač správu renderuje a komunikuje s poskytovateľom	rezervovaný
sent	Poskytovateľ správu prijal	spotrebovaný
delivered	Poskytovateľ potvrdil doručenie na server príjemcu (vyžaduje webhooky)	spotrebovaný
bounced	Server príjemcu správu odmietol; pri trvalom nedoručení (hard bounce) sa adresa pridá na zoznam blokovaných adries	spotrebovaný
complained	Príjemca správu označil ako spam; adresa sa zablokuje	spotrebovaný
failed	Trvalá chyba alebo dočasné chyby vyčerpali všetky opakované pokusy	vrátený (nie, ak správu už mohol prijať vlastný SMTP server, alebo keď zlyháva nezvyčajne veľký podiel odoslaní organizácie)
held	Čaká na kredity vo fronte pozdržaných e-mailov	zatiaľ žiadny
held_service_error	Čaká na opravu nefunkčnej služby	vrátený, pri uvoľnení sa znova rezervuje
discarded	Odstránená z fronty pozdržaných e-mailov – uplynula doba pozdržania alebo ju niekto ručne zahodil	žiadny

Pri odoslaní vracia API queued alebo held. Všetky ostatné stavy uvidíte cez getStatus() / GET /v1/messages/:id, v Histórii v dashboarde alebo cez history() v Node SDK.

Typické priebehy

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 → …

Udalosti v časovej osi

Každá správa má časovú os udalostí s časovými pečiatkami. Detail správy v Histórii ich v dashboarde zobrazuje s týmito popismi:

Udalosť	Popis v Histórii	Význam
`held`	Pozdržaný	Správa sa uložila do fronty pozdržaných e-mailov
`released`	Uvoľnený	Správa sa uvoľnila z fronty pozdržaných e-mailov
`queued`	Zaradený do poradia	Čaká na odosielač
`sending`	Odosiela sa	Odovzdáva sa poskytovateľovi
`sent`	Odoslaný	Poskytovateľ správu prijal
`failover`	Prepnuté na záložnú službu	Hlavná služba zlyhala, použila sa záložná
`retry`	Naplánovaný ďalší pokus	Dočasná chyba, nasleduje ďalší pokus
`auto_reply`	Vytvorená automatická odpoveď	K tejto správe vznikla automatická odpoveď
`delivered`	Doručený	Doručenie potvrdené webhookom
`bounced`	Nedoručený	Trvalé nedoručenie (stav `bounced`) alebo dočasné nedoručenie (len udalosť, poskytovateľ to skúša ďalej)
`complained`	Označený ako spam	Príjemca sa sťažoval
`opened` / `clicked`	Otvorený / Kliknutie na odkaz	Sledovanie otvorení a kliknutí od poskytovateľa
`failed`	Neúspešný	Trvalá chyba
`refunded`	Kredit vrátený	Rezervovaný kredit sa vrátil do svojho grantu
`discarded`	Zahodený	Správa bola odstránená z fronty pozdržaných e-mailov

opened a clicked sú udalosti, nie stavy – doručená správa, ktorá bola otvorená, zostáva v stave delivered. Sledovanie otvorení závisí od poskytovateľa a od toho, či príjemca načíta obrázky, takže ho berte ako odhad.

Doba uchovávania

Správy a ich vyrenderovaný obsah sa uchovávajú počas doby histórie podľa tarifu, v ktorom boli odoslané (7 až 180 dní, pozrite Tarify), a potom sa zmažú.