Přejít na obsah

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

GAutor

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.

Sdílet

Vyzkoušejte, o čem jste právě četli.

3 000 e-⁠mailů měsíčně zdarma. Bez platební karty.

3 000 e-⁠mailů měsíčně zdarma · Bez platební karty