Zjednodušení stavů e-mailů
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.
Blog
Nejnovější zprávy a aktualizace přímo od Emailitu.
Buďte v obraze s nejnovějšími články z blogu Emailit.
