# Zjednodušení stavů e-mailů

> Nahradili jsme staré stavy e-mailů jasnějším a konzistentnějším systémem. Zde je přehled změn a způsob, jak se nové stavy mapují na ty původní.

2026-02-25 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Stavy e-mailů patří mezi nejdůležitější části API – přesně vám říkají, v jaké fázi životního cyklu se e-mail nachází. Postupem času naše původní sada stavů rostla organicky a stala se matoucí: jaký je rozdíl mezi `error` a `softfail`? Je `held` totéž co `pending`? Rozhodli jsme se to vyčistit.

## Nové stavy

Nyní máme **12 jasných stavů**, každý s odlišným významem a barvou:

| Stav | Barva | Popis |
| --- | --- | --- |
| **accepted** | 🟡 | Přijato k doručení |
| **scheduled** | 🟡 | Naplánováno k budoucímu doručení |
| **delivered** | 🟢 | Doručeno na mailový server příjemce |
| **bounced** | 🔴 | Trvale selhalo (tvrdý odraz) |
| **attempted** | 🟠 | Pokus o doručení, ale dočasně selhalo |
| **failed** | 🔴 | Selhalo doručení kvůli konkrétní chybě |
| **rejected** | 🔴 | Zpočátku přijato, poté odmítnuto |
| **loaded** | 🔵 | Obsah e-mailu byl načten (sledování otevření) |
| **clicked** | 🟣 | Na odkaz v e-mailu bylo kliknuto |
| **suppressed** | ⚪ | Příjemce je na seznamu potlačených |
| **received** | 🟢 | Příchozí e-mail byl přijat |
| **complained** | 🔴 | Byla zaregistrována stížnost na spam |

## Co se změnilo oproti starým stavům

Staré stavy jsou zastaralé. Zde je jejich mapování na nové:

| Starý stav (zastaralý) | Nový stav |
| --- | --- |
| `pending` | `accepted` nebo `scheduled` |
| `sent` | `delivered` |
| `held` | _(odstraněno)_ |
| `hold_cancelled` | _(odstraněno)_ |
| `softfail` | `attempted` |
| `hardfail` | `bounced` |
| `opened` | `loaded` |
| `error` | `failed` |
| `delayed` | _(odstraněno)_ |
| `processed` | _(odstraněno)_ |

Přejmenované stavy jsou výstižnější: `loaded` jasně ukazuje, že sledujeme načítání obsahu e-mailu (nemusí to nutně znamenat, že ho otevřel člověk), `attempted` je méně nejednoznačné než `softfail` a `bounced` je všeobecně srozumitelné.

## Zpětná kompatibilita

Všechny existující e-maily a jejich doručení byly migrovány na nové stavy, neuvidíte žádné staré názvy stavů v záznamech e-mailů nebo doručení, bez ohledu na to, kdy byly vytvořeny.

Jediné místo, kde se staré názvy stavů mohou stále objevit, jsou **dříve spuštěné události a webhook požadavky**, které byly odeslány před touto změnou. Tyto historické payloady jsou neměnné a zachovají si původní hodnoty stavů, se kterými byly vytvořeny.

Pokud ve svém kódu filtrujete nebo porovnáváte hodnoty stavů, aktualizujte své integrace, aby používaly nové názvy.

---

Source: https://emailit.com/cs/blog/zjednoduseni-stavu-emailu/
