Reference

Stavy e-mailů

Všechny stavy e-mailu v Emailitu – co znamenají, jestli se ještě mohou změnit, kterou událost webhooku odesílají a co dělat dál.

Aktualizováno 1. 10. 2026

Každý e-mail má jeden stav, který ukazuje, kde se v životním cyklu nachází. Tato stránka uvádí všech 14 stavů, jak mezi nimi e-mail přechází a co dělat, když se e-mail zastaví tam, kde jste to nečekali. Stav je jen poslední stav; celá historie je v detailu e-mailu a v událostech.

Přehled stavů

„Konečný“ znamená, že Emailit už stav sám nezmění. Konečný e-mail lze stále odeslat znovu, čímž vznikne nový e-mail s novým ID.

Stav	Popisek ve webovém rozhraní	Konečný	Událost webhooku	Význam a co dělat
`accepted`	Accepted for delivery	Ne	`email.accepted`	Uložený a zařazený do fronty k doručení. Obvykle se během několika sekund posune dál. E-maily odeslané přes SMTP událost `email.accepted` nevyvolávají.
`scheduled`	Scheduled for delivery in the future	Ne	`email.scheduled`	Čeká na čas `scheduled_at`. Čas můžete změnit, nebo e-mail zrušit nejpozději 3 minuty před odesláním.
`delivered`	Delivered to the recipient’s mail server	Ne	`email.delivered`	Přijímající server zprávu přijal. Ještě může přejít do stavu `loaded` nebo `clicked` a pozdější zpráva o nedoručení nebo stížnost ho může změnit na `bounced` nebo `complained`.
`loaded`	Email content was loaded by the recipient	Ne	`email.loaded`	Načetl se měřicí obrázek (otevření). Vyžaduje měření načtení na ověřené doméně pro měření.
`clicked`	A link in the email was clicked	Ne	`email.clicked`	Někdo klikl na měřený odkaz. Vyžaduje měření prokliků na ověřené doméně pro měření.
`attempted`	Delivery attempted but resulted in a temporary failure	Ne	`email.attempted`	Přijímající server odpověděl dočasnou chybou. Emailit to automaticky zkouší znovu; viz plán opakování.
`bounced`	Email permanently failed to deliver	Ano	`email.bounced`	Přijímající server zprávu trvale odmítl, později dorazila zpráva o nedoručení, nebo došly pokusy. Než na adresu znovu odešlete, zkontrolujte ji. Kdy se adresa automaticky zablokuje, popisuje stránka Nedoručení a stížnosti.
`failed`	Failed to deliver due to a specific error	Ano	`email.failed`	Chyba zpracování, ne odpověď serveru příjemce. Vzácné. Odešlete e-mail znovu přes API.
`rejected`	Accepted for delivery but rejected after	Ano	`email.rejected`	Emailit ho po přijetí odmítl odeslat, protože neověřený workspace může odesílat jen členům.
`suppressed`	Recipient is on the suppression list	Ano	`email.suppressed`	Neodesláno, protože adresa je na vašem seznamu blokovaných adres. Blokaci odeberte, jen pokud jste si jistí, a pak e-mail odešlete znovu.
`received`	Incoming email was accepted	Ano	`email.received`	Na vaší příchozí subdoméně byla přijata příchozí zpráva.
`complained`	A complaint was registered for this email	Ano	`email.complained`	Příjemce e-mail označil jako spam a jeho poskytovatel to nahlásil. Adresa se přidá mezi blokované adresy, pokud vaše nastavení automatického blokování adres stížnosti nevylučuje. Znovu na ni nepište.
`canceled`	Canceled: pulled from the send queue when possible	Ano	`email.canceled`	Zrušili jste ho ve webovém rozhraní nebo přes API. Zrušení je bez záruky.
`held`	Email is being held	Ano	`email.held`	Emailit ho neodeslal. Zjistěte, proč je e-mail zadržen, odstraňte příčinu a pak e-mail odešlete znovu.

Webhooky dostávají email.canceled a email.held, pokud odebírají všechny události, nebo pokud tyto události přidáte do seznamu událostí webhooku přes API. Viz Typy událostí.

Životní cyklus

Většina e-mailů prochází touto cestou:

Vytvoření. Odeslání přes API vytvoří e-mail ve stavu accepted, nebo scheduled, když je scheduled_at v budoucnosti. Odeslání přes SMTP také začínají ve stavu accepted. Příchozí pošta se vytvoří ve stavu received a už se nemění.
Kontrola. Před každým pokusem o doručení Emailit zkontroluje workspace, doménu, API klíč, kredity, seznam blokovaných adres a skóre spamu. Neúspěšná kontrola ukončí e-mail ve stavu held, rejected nebo suppressed, aniž by byl odeslán.
Doručení, nebo odložení. Pokus o doručení buď uspěje (delivered), dočasně selže (attempted a následuje opakování), nebo trvale selže (bounced).
Zapojení. Pokud je zapnuté měření, otevření a prokliky posunou doručený e-mail do stavu loaded a pak clicked.
Pozdní hlášení. Zpráva o nedoručení, která dorazí po doručení, změní stav na bounced. Stížnost na spam ho změní na complained.

Kdykoli před doručením lze e-mail ve stavu scheduled, accepted nebo attempted zrušit (canceled).

Žebříček zapojení

Stavy doručení a zapojení se posouvají jen dopředu:

accepted, scheduled nebo attempted → delivered → loaded → clicked

Pozdější událost nikdy neposune e-mail po žebříčku zpět. Pokud se zaznamená proklik, e-mail zůstane ve stavu clicked, i když přijdou další otevření. Otevření nebo proklik může delivered přeskočit, protože dokazuje, že zpráva dorazila. Stavy, které doručení ukončují (bounced, failed, rejected, suppressed, complained a canceled), otevření ani prokliky nikdy nepřepíšou.

Plán opakování ve stavu attempted

Když přijímající server odpoví dočasnou chybou (odpověď 4xx, například 421 nebo 451, vypršení časového limitu nebo chyba spojení), e-mail dostane stav attempted a Emailit to zkusí znovu. Každé čekání je dvakrát delší než předchozí:

Po neúspěšném pokusu	Další krok
1	Nový pokus za 10 minut
2	Nový pokus za 20 minut
3	Nový pokus za 40 minut
4	Nový pokus za 80 minut
5	Nový pokus za 160 minut
6	Nový pokus za 320 minut
7	Čekání 640 minut, pak se e-mail označí jako `bounced`

To je 7 pokusů o doručení během přibližně 21 hodin. Když dojdou, e-mail se označí jako bounced s textem „Maximum number of delivery attempts (7) has been reached“ a příjemce se přidá mezi blokované adresy s důvodem too many soft fails, pokud vaše nastavení automatického blokování adres nedoručení nevylučuje.

Každý pokus je uvedený na kartě Deliveries u e-mailu s odpovědí serveru a každý odešle událost email.attempted, která obsahuje smtp_code, smtp_enhanced_code a smtp_response. Některé dočasné odpovědi, které jasně znamenají trvalý problém, například deaktivovanou schránku, se rovnou považují za nedoručení. Když poskytovatel zpomaluje příjem, může Emailit doručování k němu na chvíli pozastavit; takové řádky obsahují „Delivery delayed due to…“.

Proč je e-mail zadržen

Zadržený e-mail byl vyjmut z odesílací fronty, aniž by byl odeslán. Karta Deliveries u e-mailu ukazuje, který důvod nastal:

Důvod	Zpráva na kartě Deliveries	Co dělat
Zablokovaný workspace	Mail server has been suspended. No e-mails can be processed at present. Contact support for assistance.	Zkontrolujte kondici odesílání a kontaktujte podporu.
Pozastavená odesílací doména	Sending from this domain is paused. Contact support for assistance.	Míra nedoručení domény byla příliš vysoká. Viz Kondice odesílání.
Nedostatek kreditů	Workspace has not enough email credits to send this email.	Kupte kredity, nebo zapněte automatické dobíjení.
Příliš vysoké skóre spamu	Held because Rspamd scored this message 8.4, which is at or above the threshold of 7.	Přečtěte si kontroly spamu u e-mailu, upravte obsah a pak e-mail odešlete znovu.
API klíč nastavený na zadržování	Credential is configured to hold all messages authenticated by it.	Zprávy odeslané tímto klíčem se zadržují záměrně. Kontaktujte podporu.

Zadržené e-maily se automaticky neuvolňují. Po odstranění příčiny vyberte u e-mailu Retry, nebo zavolejte Opakované odeslání e-mailu. Opakované odeslání vytvoří nový e-mail se stejným obsahem a znovu účtuje kredity.

Proč je e-mail odmítnut

Dokud váš workspace nemá produkční přístup, můžete odesílat jen na e-maily účtů členů workspace. Pro ostatní příjemce vrátí API už při odeslání 403 a SMTP 550, takže většinou uvidíte chybu místo e-mailu. Stav rejected se objeví, když stejná kontrola selže později, v době doručení, například u e-mailu, který byl naplánován dříve. Karta Deliveries zobrazí „Unverified workspaces can only send to workspace members’ account emails“ a blokovanou adresu.

Pravidla pro opakované odeslání

	Tlačítko Retry ve webovém rozhraní	API pro opakované odeslání e-mailu
Stavy	`held`, `suppressed`	`bounced`, `failed`, `suppressed`, `held`
Stáří	Mladší než 30 dní	Mladší než 30 dní
Obsah	Nesmí být smazaný po uplynutí doby uchovávání dat	Nesmí být smazaný
Výsledek	Nový e-mail s novým ID; originál zůstane beze změny	Totéž, odpověď obsahuje `original_id`

U zablokovaného e-mailu nejdřív odeberte adresu ze seznamu blokovaných adres, jinak se i opakované odeslání zablokuje.

Detail e-mailu

Nedoručení a stížnosti

Opakované odeslání a přeposlání

Typy událostí webhooků