Prehľad služieb

E-mailová služba je prepojenie Frontmailu s poskytovateľom e-mailu. Frontmail za vás nikdy neposiela e-maily z vlastnej infraštruktúry – vyrenderuje šablónu a správu odovzdá vášmu poskytovateľovi. Doručiteľnosť, reputácia odosielateľa aj ceny poskytovateľa tak zostávajú pod vašou kontrolou.

Podporovaní poskytovatelia

Poskytovateľ	Typ	Vhodné pre	Webhooky o doručení
SMTP (Seznam, Zoho, vlastný)	smtp	Existujúce schránky, vlastné poštové servery	–
Mailgun	mailgun	Transakčné e-maily, región EU alebo US	✓
Amazon SES	ses	Veľké objemy za nízku cenu, používatelia AWS	✓ (cez SNS)
Postmark	postmark	Rýchle doručovanie transakčných e-mailov	✓
Mailjet	mailjet	Transakčné e-maily so zázemím v EÚ	✓
Brevo	brevo	Zázemie v EÚ, štedrý bezplatný tarif	✓
Resend	resend	API priateľské k vývojárom	✓
Gmail (OAuth)	gmail	Osobné schránky a schránky Google Workspace	–
Outlook / Microsoft 365 (OAuth)	outlook	Schránky Outlook.com a Microsoft 365	–

Osobné služby (SMTP schránky, Gmail, Outlook) nastavíte rýchlo a e-maily odchádzajú z vašej skutočnej schránky, majú však nízke denné limity a žiadne sledovanie doručenia. Transakční poskytovatelia vyžadujú nastavenie DNS, no zato škálujú, posielajú udalosti o doručení, bounce a otvorení a majú lepšiu doručiteľnosť.

Pridanie služby

Služby spravujú vlastník, administrátori a vývojári na stránke E-mailové služby.

1. Kliknite na Pridať službu a vyberte poskytovateľa.
2. Pri Gmaile a Outlooku kliknite na Pripojiť Gmail / Pripojiť Outlook / Microsoft 365 a v okne poskytovateľa povoľte prístup. Pri ostatných zadajte prihlasovacie údaje a kliknite na Overiť a uložiť – Frontmail ich pred uložením overí u poskytovateľa (bez odoslania e-mailu). Ak ich chcete overiť neskôr, použite Uložiť bez overenia. Údaje sú šifrované pomocou AWS KMS (envelope encryption, AES-256-GCM) a už sa nikdy znova nezobrazia – môžete ich len nahradiť.
3. Na stránke služby môžete rovnakú kontrolu kedykoľvek spustiť znova tlačidlom Otestovať pripojenie.
4. Voliteľne nastavte URL webhooku, ktorú nájdete na stránke služby (pozri nižšie).
5. Prvá služba sa automaticky stane predvolenou; zmeníte to tlačidlom Nastaviť ako predvolenú. Používajú ju šablóny bez explicitne nastavenej služby a volania API bez service_id. Ak zmažete službu, ktorú používajú šablóny, prejdú na predvolenú službu.

Predvolený odosielateľ (From)

Každá služba môže mať Predvolený e-mail odosielateľa a Predvolené meno odosielateľa (vo formulári na pridanie aj na stránke služby v časti Nastavenia). Adresa odosielateľa každého e-mailu sa určí v tomto poradí:

1. E-mail odosielateľa / Meno odosielateľa v nastaveniach šablóny (môžu obsahovať parametre),
2. predvolený e-mail / meno odosielateľa služby,
3. pri Gmaile a Outlooku pripojený účet; pri SMTP používateľské meno, ak je to e-mailová adresa.

Kým má šablóna e-mail odosielateľa prázdny, editor šablóny ukazuje, kto bude odosielateľom. Samotná zmena predvoleného odosielateľa znova nespúšťa test pripojenia. Ak adresu neposkytne ani jeden krok, testovacie odoslanie skončí chybou sender_not_configured a skutočné odoslanie trvalou chybou (kredit sa vráti).

Upozornenie

Predvolený odosielateľ musí byť adresa, z ktorej vám poskytovateľ dovolí posielať – pri Amazon SES, Postmarku, Mailgune, Resende, Brevo a Mailjete overená identita (doména alebo adresa), pri SMTP, Gmaile a Outlooku schránka alebo povolený alias.

Záložná služba (failover)

Každá šablóna má primárnu službu a voliteľne záložnú službu; obe vyberiete v editore šablóny v Nastavenia → Doručovanie (Služba a Záložná služba). Odosielač najprv skúsi primárnu. Ak zlyhá na chybe autentifikácie alebo na trvalej chybe, rovnaká správa sa okamžite odošle cez záložnú službu. Na časovej osi správy sa objaví udalosť failover a v histórii správ uvidíte, ktorá služba ju skutočne odoslala.

Prechodné chyby (timeouty, throttling, 5xx) failover nespúšťajú – najprv sa opakujú na primárnej službe, pretože sa zvyčajne vyriešia samy.

Tip

Použite dvoch rôznych poskytovateľov (napríklad Postmark ako primárnu a SES ako záložnú službu), aby výpadok alebo pozastavený účet u jedného z nich nezastavil vaše formuláre. Pri oboch musí byť overená doména odosielateľa (From).

Ako sa spracúvajú chyby poskytovateľa

Frontmail každú chybu poskytovateľa zaradí do jednej z troch skupín:

Trieda	Príklady	Čo Frontmail urobí
Autentifikácia	neplatný alebo zrušený API kľúč, expirovaný OAuth token (Google invalid_grant), SMTP 535	Označí službu ako unhealthy (Nefunguje), pošle e-mail vlastníkovi a administrátorom a zobrazí banner v dashboarde. Ak existuje záložná služba, odošle správu cez ňu; inak vráti kredit a ponechá správu v stave held_service_error.
Trvalá	neplatný príjemca, neoverený odosielateľ alebo doména, správa odmietnutá pre pravidlá	Ak existuje záložná služba, skúsi ju; inak správa prejde do stavu failed a kredit sa vráti. Tvrdé bounce pridajú adresu do zoznamu blokovaných adries.
Prechodná	timeout, prerušené spojenie, 5xx od poskytovateľa, throttling 429, SMTP 421/450/451	Opakuje pokusy s exponenciálnym backoffom (s ohľadom na rate limity poskytovateľa). Ak zlyhajú všetky pokusy, správa prejde do stavu failed a kredit sa vráti.

Návod ku každému poskytovateľovi uvádza jeho najčastejšie chyby a to, ako sú zaradené.

Správy pozdržané pre chybu služby

Správy v stave held_service_error čakajú vo fronte pozdržaných e-mailov spolu so správami pozdržanými pre nedostatok kreditov a sú označené dôvodom service. Hneď ako je služba znova v poriadku – po aktualizácii prihlasovacích údajov, opätovnom pripojení OAuth alebo úspešnom health checku – automaticky sa uvoľnia: znova sa pre ne rezervuje kredit a odošlú sa v pôvodnom poradí. Môžete ich tiež uvoľniť alebo zahodiť ručne. Exspirujú rovnako ako ostatné pozdržané správy (Free 3 dni, platené tarify 14 dní) a predtým vám príde e-mail.

Health checky

• Denne: Frontmail overí každú službu (rovnaká kontrola ako Otestovať pripojenie).
• Okamžite po chybe autentifikácie pri odosielaní.
• Pri uložení: vždy, keď upravíte prihlasovacie údaje alebo znova pripojíte OAuth.

Služba je v stave healthy (Funguje), unhealthy (Nefunguje) alebo unknown (Neoverené). Keď služba prestane fungovať, vlastník a administrátori dostanú e-mail a dashboard zobrazuje banner Jedna z e-mailových služieb nefunguje s tlačidlom Opraviť službu, kým sa služba nezotaví; keď je znova v poriadku a jej pozdržané správy sa uvoľnia, príde ďalší e-mail.

Webhooky o doručení

Transakční poskytovatelia vedia hlásiť, čo sa so správou stalo potom, ako ju prijali. Skopírujte URL webhooku zo stránky služby (sú tam uvedené aj udalosti, ktoré treba zapnúť) do konzoly poskytovateľa:

https://api.frontmail.dev/webhooks/providers/<type>/<token>

<type> je typ poskytovateľa z tabuľky vyššie (napr. mailgun), <token> je náhodný token jedinečný pre danú službu – celú URL berte ako tajomstvo. Ak to poskytovateľ podporuje, Frontmail navyše overuje jeho podpis.

Udalosti sa premietajú do stavov správ a štatistík:

Udalosť poskytovateľa	Frontmail
delivered	stav delivered
hard bounce	stav bounced + adresa pridaná do zoznamu blokovaných adries
soft bounce	len udalosť (poskytovateľ to skúša znova)
spam complaint	stav complained + adresa pridaná do zoznamu blokovaných adries
open / click	udalosti opened / clicked na časovej osi a v štatistikách

Bez webhookov skončí správa v stave sent – to znamená, že ju poskytovateľ prijal.

V dashboarde

Pridanie, otestovanie aj opravu služieb popisuje časť E-mailové služby.