SMTP chybové kódy 4xx a 5xx: co znamenají 421, 450, 451, 452, 550, 552 a 554 a co s nimi dělat

Když cílový server e-mail nepřijme, odpoví třímístným kódem a textem. Kód začínající 4 znamená „teď ne, zkus to znovu", kód začínající 5 znamená „nikdy, nezkoušej". To je celý rozdíl mezi soft a hard bounce a zároveň klíč k tomu, co s odmítnutím dělat. Tenhle článek prochází kódy, které v doručenkách uvidíte nejčastěji, a vysvětluje, jak je TopEmail převádí na stavy deferred a bounced.

Jak číst odpověď SMTP serveru

Odpověď vypadá třeba takhle:

550 5.1.1 <jan.novak@gmial.com>: Recipient address rejected: User unknown

• 550 je základní kód podle RFC 5321. První číslice říká, jak dopadlo (2 úspěch, 4 dočasná chyba, 5 trvalá chyba), druhá přibližně čeho se týká (x.0.x syntaxe, x.2.x spojení, x.5.x poštovní systém).
• 5.1.1 je rozšířený stavový kód podle RFC 3463 (enhanced status code). Je přesnější než základní kód a nese třídu, předmět a detail: 5.1.x se týká adresy, 5.2.x schránky, 5.7.x bezpečnosti a politiky. Ne každý server ho posílá, ale velcí poskytovatelé ano.
• Text je volný a každý server si ho píše po svém. Gmail, Microsoft a Seznam do něj často dávají odkaz na vysvětlení; to je nejrychlejší cesta k příčině.

Důležité je, že kód přiřazuje cílový server, ne relay. Relay ho jen předá dál. U nás ho najdete v poli reason u každého e-mailu ve stavu deferred nebo bounced v doručenkách a webhooku.

Dočasné chyby 4xx: soft bounce

Všechny 4xx u nás končí stavem deferred. Relay opakuje doručení s rostoucím odstupem až 24 hodin. Když se do té doby e-mail nepodaří předat, přejde do stavu bounced a v reason zůstane poslední odpověď serveru. Stav deferred dostanete i webhookem, takže v aplikaci můžete zákazníkovi zobrazit „e-mail odesíláme" místo ticha.

Co s opakovanými 4xx dělat jako odesílatel: nic s konkrétní adresou (zůstává platná), ale sledovat, jestli se nehromadí na jednom poskytovateli. Několik dní po sobě odkládaná pošta na Seznam nebo Microsoft není náhoda, ale měkký způsob, jak vám server říká, že se mu nelíbí objem nebo reputace. Víc v článku o doručování na Seznam.cz.

Trvalé chyby 5xx: hard bounce

Všechny 5xx u nás končí stavem bounced okamžitě, bez opakování, a adresa příjemce jde na blokovaný seznam. Další pokus odeslat na ni skončí stavem suppressed a neúčtuje se.

Hard vs. soft bounce v jedné větě

Soft bounce (4xx) je vlastnost okamžiku: schránka je plná, server má moc práce, greylisting. Adresa je v pořádku, e-mail se pokusíme doručit znovu. Hard bounce (5xx) je vlastnost adresy nebo vašeho odesílání: adresa neexistuje, nebo vás server nechce. Opakování nepomůže a škodí reputaci.

Hranice není vždy ostrá. Některé servery hlásí plnou schránku jako 552 (trvale), jiné jako 452 (dočasně). Některé firemní servery po migraci odpovídají 550 na adresy, které za týden zase fungují. Proto u hard bounce vždy čtěte text, ne jen kód.

Dvě pětistovky, které se často pletou

550 5.1.1 a 550 5.7.1 mají stejný základní kód a úplně jiný význam.

• 5.1.1 říká: tahle adresa neexistuje. Problém je na straně příjemce (překlep), vy s tím nic neuděláte, kromě toho, že na ni přestanete posílat.
• 5.7.1 říká: tuhle zprávu od vás nechceme. Adresa může být v pořádku. Problém je ve vaší autentizaci, obsahu, nebo reputaci. Pokud byste zprávu poslali z jiné domény s čistou historií, nejspíš by prošla.

Když ve filtru doručenek uvidíte nárůst 5.7.1 během jednoho dne, zastavte se a zjistěte, co se změnilo: nová šablona s podezřelým odkazem, nová služba posílající z vaší domény bez DKIM, nebo prasklý SPF kvůli překročení limitu dotazů.

Co dělat v aplikaci

1. Rozlišujte deferred a bounced. U deferred nic nedělejte (max. zobrazte „odesíláme"). U bounced označte adresu jako neplatnou a nabídněte opravu.
2. Čtěte reason, ne jen stav. Rozhodnutí „poslat SMS s žádostí o opravu adresy" dává smysl u 5.1.1, ale ne u 5.7.1, kde zákazníkova adresa za nic nemůže.
3. Agregujte podle poskytovatele. Tabulka „bounce za posledních 24 hodin podle domény příjemce a kódu" odhalí problém s reputací u jednoho poskytovatele dřív než cokoli jiného. Doručenky za 90 dní jsou k dispozici přes API i v dashboardu.
4. Nespouštějte opakování sami. Relay 4xx opakuje; když to navíc zopakuje vaše aplikace, pošlete duplikát a při 5xx si zbytečně zhoršíte reputaci.

Shrnutí

• 4xx = dočasně, soft bounce, stav deferred, opakujeme až 24 hodin.
• 5xx = trvale, hard bounce, stav bounced, adresa na blokovaný seznam.
• 5.1.1 je špatná adresa, 5.7.1 je odmítnutí vašeho e-mailu z důvodu politiky; řešení se úplně liší.
• 421 a 554 hned po připojení se týkají serveru, ne adresy.
• Text odpovědi je důležitější než kód; u velkých poskytovatelů obsahuje odkaz na vysvětlení.

Jak stavy přijímat webhookem a zpracovat je bez duplicit, popisuje článek o webhoocích a HMAC podpisu.