Vývoj4 min čtení
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í.
GAutorGeorge

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 |
|---|---|
|
|
|
|
| (odstraněno) |
| (odstraněno) |
|
|
|
|
|
|
|
|
| (odstraněno) |
| (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.


