# 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.

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](/cs/docs/logs/email-details/) a v [událostech](/cs/docs/logs/events/).

## 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](/cs/docs/api-reference/emails/update/), 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í](/cs/docs/tracking/). |
| `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í](#retry-schedule-for-attempted). |
| `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](/cs/docs/deliverability/bounces-and-complaints/). |
| `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](#why-an-email-is-rejected) 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](/cs/docs/suppressions/). 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í](/cs/docs/inbound/) 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](#why-an-email-is-held), 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í](/cs/docs/webhooks/event-types/).

## Životní cyklus

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

1. **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í.
2. **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.
3. **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`).
4. **Zapojení.** Pokud je zapnuté měření, otevření a prokliky posunou doručený e-mail do stavu `loaded` a pak `clicked`.
5. **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](/cs/docs/suppressions/manage/) 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í](/cs/docs/deliverability/sending-health/) 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í](/cs/docs/deliverability/sending-health/). |
| Nedostatek kreditů | Workspace has not enough email credits to send this email. | [Kupte kredity](/cs/docs/billing/credits/), nebo zapněte [automatické dobíjení](/cs/docs/billing/auto-refill/). |
| 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](/cs/docs/logs/email-details/#spam-checks) 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](/cs/docs/api-reference/emails/retry/). 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](/cs/docs/workspaces/production-access/), 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](/cs/docs/api-reference/emails/retry/) |
| --- | --- | --- |
| 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](/cs/docs/data-retention/) | 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](/cs/docs/suppressions/manage/), jinak se i opakované odeslání zablokuje.

## Související

  - [Detail e-mailu](/cs/docs/logs/email-details/)
  - [Nedoručení a stížnosti](/cs/docs/deliverability/bounces-and-complaints/)
  - [Opakované odeslání a přeposlání](/cs/docs/email-api/retry-and-forward/)
  - [Typy událostí webhooků](/cs/docs/webhooks/event-types/)

---
Zdroj: https://emailit.com/cs/docs/logs/email-statuses/