Späť na blog

Riešenie chýb pri spracovaní a odosielaní e-mailov

M. Pecho
M. Pecho
Aktualizované:

Faktúra neodišla, zákazník čaká na potvrdenie alebo sa časť správ z kampane vrátila s chybou. Pred ďalším pokusom potrebujete vedieť, kde sa komunikácia zastavila. V doMail nájdete pri jednej komunikácii údaje o spracovaní, jednotlivých adresátoch aj záznamy chýb. Ukážeme si, ako tieto informácie využiť a kedy správu znovu poslať alebo opakovane spracovať.

1. Nájdite komunikáciu a rozlíšte typ problému

Otvorte Komunikácie a vyhľadajte záznam podľa ID komunikácie, adresy príjemcu alebo času. Ak posielate požiadavky z vlastnej aplikácie, pri dohľadávaní pomáha aj externé ID, ktoré ste k požiadavke priradili. Otvorte detail a pozrite si stav odoslania aj stav doručenia.

  • Chyba pri spracovaní: skontrolujte scenár, skript, šablónu a vstupné dáta. E-mail ešte nemusel vzniknúť.
  • Chyba pri odosielaní: správa mohla vzniknúť, ale jej odovzdanie SMTP serveru zlyhalo. Príčinu hľadajte v logu odosielania.
  • Nedoručenie po odoslaní: e-mail bol odoslaný, ale následne bolo zaznamenané jeho nedoručenie. Stav odoslania preto môže byť odoslané, zatiaľ čo stav doručenia je doručenie zlyhalo.

Ak má komunikácia viac príjemcov alebo viac behov spracovania, prejdite aj na záložku Adresy. Overte výsledok konkrétnej adresy a behu, ktorého sa problém týka.

2. Prečítajte si príčinu v logoch

V detaile otvorte záložku Logy. Pozrite si čas a text chyby v súvislosti s príslušným pokusom. Rozlišujte medzi problémom jednej adresy a problémom, ktorý sa opakuje pri viacerých komunikáciách.

Príklady príčin zlyhania a čo pri nich overiť
Čo zistíte Čo overiť pred opakovaním
Chýbajúci údaj alebo chyba šablóny Vstupné dáta, názvy parametrov a spracovanie šablóny.
Chyba skriptu Miesto zlyhania v logu, spracovateľskú logiku a vstupné hodnoty.
Požiadavku sa nepodarilo načítať zo súboru Dostupnosť pôvodného súboru požiadavky a príčinu zlyhania jeho načítania.

Opakovanie má zmysel až po odstránení príčiny. Ak chýba vstupný údaj alebo súbor požiadavky, samotné spustenie rovnakého spracovania ho nedoplní.

Logy komunikácie č. 16: komponent MIME_PROC hlási zlyhanie načítania požiadavky zo súboru.

3. Vyberte: znovu poslať alebo opakovane spracovať?

Po odstránení príčiny sa v detaile vráťte na prvú záložku a otvorte ponuku Akcia. Dostupné možnosti závisia od stavu komunikácie a vašich oprávnení.

Znovu poslať (Resend)

Použite, keď už máte správne vytvorenú správu a potrebujete zopakovať jej odoslanie. Vychádza z už vytvoreného obsahu; neslúži na nové vygenerovanie opravenej šablóny.

Príklad: po obnovení spojenia so SMTP serverom chcete odoslať pripravený e-mail.

Opakovane spracovať (Reprocess)

Použite, keď potrebujete požiadavku znovu spracovať cez scenár a skript, napríklad po oprave spracovateľskej logiky.

Pred spustením overte aj vstupné dáta. Opakovanie pôvodnej požiadavky automaticky neprevezme zmenené údaje z vašej aplikácie.

Komunikácia č. 16 má stav Error a stav doručenia None. Ponuka obsahuje Reprocess, ale nie Resend: tento príklad vyžaduje nové spracovanie požiadavky po odstránení príčiny chyby.

Komunikácia č. 16 v stave Error a None s otvorenou ponukou Action obsahujúcou Reprocess a Export.

Ak sa problém týka iba jedného príjemcu, skontrolujte aj akciu pri jeho zázname v záložke Adresy. Pred potvrdením si overte rozsah operácie, aby ste zbytočne neposielali ďalšiu kópiu aj ostatným príjemcom.

Záložka Addresses v doMail: adresát má stav Dispatched, doručenie Delivery failed a dostupnú akciu Resend.

4. Skontrolujte obsah a výsledok nového pokusu

Pri odoslanej správe môžete na záložke Náhľad skontrolovať vzhľad e-mailu. Ak potrebujete preveriť hlavičky, MIME štruktúru alebo prílohy, otvorte EML zdroj a vyberte príslušný beh. Dostupný EML súbor si môžete aj stiahnuť. Náhľad aj EML zdroj zostávajú dostupné aj pri následnom zlyhaní doručenia. Ak však komunikácia zlyhala už počas spracovania, náhľad je prázdny a EML zdroj nie je dostupný.

Po opakovaní obnovte detail a skontrolujte nový beh, adresátov aj logy. Potvrdenie prijatia akcie samo osebe neznamená úspešné odoslanie. Ani stav odoslané nepotvrdzuje, že správu príjemca prečítal; informácie o neskoršom nedoručení môžu pribudnúť dodatočne.

Keď sa rovnaká chyba opakuje

Ak zlyháva viac správ naraz, skontrolujte spoločnú príčinu: rovnaký scenár, šablónu, SMTP server alebo cieľovú doménu. Najprv overte opravu na jednej komunikácii a až potom zvážte hromadnú akciu. Ak problém neviete vyriešiť, neváhajte nás kontaktovať na domail@domail.io. Do e-mailu uveďte ID komunikácie, čas pokusu, číslo behu a presné znenie chyby.

Ako si všimnúť rastúci počet chýb skôr, než sa ozve zákazník, opisujeme v článku Monitoring e-mailov: od prehľadu ku konkrétnej chybe.