Přehled služeb

Služba je propojení Frontmailu s poskytovatelem e-mailu. Frontmail za vás nikdy neposílá e-maily z vlastní infrastruktury – vyrenderuje šablonu a zprávu předá vašemu poskytovateli. Doručitelnost, reputace odesílatele i ceny poskytovatele tak zůstávají pod vaší kontrolou.

Podporovaní poskytovatelé

Poskytovatel	Typ	Hodí se pro	Webhooky o doručení
SMTP (Seznam, Zoho, vlastní)	smtp	Existující schránky, vlastní poštovní servery	–
Mailgun	mailgun	Transakční e-maily, region EU nebo US	✓
Amazon SES	ses	Velké objemy za nízkou cenu, uživatelé AWS	✓ (přes SNS)
Postmark	postmark	Rychlé doručování transakčních e-mailů	✓
SendGrid	sendgrid	Transakční i marketingové e-maily	✓
Mailjet	mailjet	Transakční e-maily se zázemím v EU	✓
Brevo	brevo	Zázemí v EU, štědrý bezplatný tarif	✓
Resend	resend	API přívětivé k vývojářům	✓
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 rychle a e-maily odcházejí z vaší skutečné schránky, mají ale nízké denní limity a žádné sledování doručení. Transakční poskytovatelé vyžadují nastavení DNS, zato škálují, posílají události o doručení, bouncích a otevření a mají lepší doručitelnost.

Přidání služby

Služby spravují vlastník, admini a vývojáři na stránce E-mailové služby.

1. Klikněte na Přidat službu a vyberte poskytovatele.
2. U Gmailu a Outlooku klikněte na Připojit Gmail / Připojit Outlook / Microsoft 365 a v okně poskytovatele povolte přístup. U ostatních zadejte přihlašovací údaje a klikněte na Ověřit a uložit – Frontmail je před uložením ověří u poskytovatele (aniž by poslal e-mail). Pokud to chcete ověřit později, použijte Uložit bez ověření. Údaje jsou šifrované pomocí AWS KMS (envelope encryption, AES-256-GCM) a už nikdy se znovu nezobrazí – můžete je jen nahradit.
3. Na stránce služby můžete tutéž kontrolu kdykoli spustit znovu tlačítkem Otestovat spojení.
4. Volitelně nastavte URL webhooku, kterou najdete na stránce služby (viz níže).
5. První služba se automaticky stane výchozí; změníte to tlačítkem Nastavit jako výchozí. Používají ji šablony bez explicitně nastavené služby a volání API bez service_id. Když smažete službu, kterou používají šablony, přejdou na výchozí službu.

Výchozí odesílatel (From)

Každá služba může mít Výchozí e-mail odesílatele a Výchozí jméno odesílatele (ve formuláři pro přidání i na stránce služby v části Nastavení). Adresa odesílatele každého e-mailu se určí v tomto pořadí:

1. E-mail / jméno odesílatele v nastavení šablony (může obsahovat parametry),
2. výchozí e-mail / jméno odesílatele služby,
3. u Gmailu a Outlooku připojený účet; u SMTP uživatelské jméno, pokud je to e-mailová adresa.

Když má šablona e-mail odesílatele prázdný, editor šablony ukáže, kdo bude odesílatelem. Samotná změna výchozího odesílatele nespouští znovu test spojení. Pokud adresa nevyjde z žádného kroku, testovací odeslání skončí chybou sender_not_configured a skutečné odeslání trvalou chybou (kredit se vrátí).

Upozornění

Výchozí odesílatel musí být adresa, ze které vám poskytovatel dovolí posílat – u Amazon SES, Postmarku, SendGridu, Mailgunu, Resendu, Brevo a Mailjetu ověřená identita (doména nebo adresa), u SMTP, Gmailu a Outlooku schránka nebo povolený alias.

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

Každá šablona má primární službu a volitelně záložní službu; obě vyberete v editoru šablony v Nastavení → Doručování (Služba a Záložní služba). Odesílač nejdřív zkusí primární. Pokud selže kvůli chybě autentizace nebo trvalé chybě, stejná zpráva se okamžitě odešle přes záložní službu. Na časové ose zprávy se objeví událost failover a v historii uvidíte, která služba ji skutečně odeslala.

Přechodné chyby (timeouty, throttling, 5xx) failover nespouštějí – nejdřív se opakují na primární službě, protože se obvykle vyřeší samy.

Tip

Použijte dva různé poskytovatele (třeba Postmark jako primární a SES jako záložní), aby výpadek nebo pozastavený účet u jednoho z nich nezastavil vaše formuláře. U obou musí být ověřená doména odesílatele (From).

Jak se zpracovávají chyby poskytovatele

Frontmail každou chybu poskytovatele zařadí do jedné ze tří skupin:

Třída	Příklady	Co Frontmail udělá
Autentizace	neplatný nebo zneplatněný API klíč, vypršený OAuth token (Google invalid_grant), SMTP 535	Označí službu jako unhealthy (Nefunguje), pošle e-mail vlastníkovi a adminům a zobrazí banner v dashboardu. Pokud existuje záložní služba, odešle zprávu přes ni; jinak vrátí kredit a ponechá zprávu ve stavu held_service_error.
Trvalá	neplatný příjemce, neověřený odesílatel nebo doména, zpráva odmítnutá kvůli pravidlům	Pokud existuje záložní služba, zkusí ji; jinak zpráva přejde do stavu failed a kredit se vrátí. Tvrdé bouncy přidají adresu na seznam potlačených adres.
Přechodná	timeout, přerušené spojení, 5xx od poskytovatele, throttling 429, SMTP 421/450/451	Opakuje pokusy s exponenciálním backoffem (s ohledem na rate limity poskytovatele). Pokud selžou všechny pokusy, zpráva přejde do stavu failed a kredit se vrátí.

Návod ke každému poskytovateli uvádí jeho nejčastější chyby a to, jak jsou zařazené.

Zprávy držené kvůli chybě služby

Zprávy ve stavu held_service_error čekají v hold frontě spolu se zprávami drženými kvůli kreditům a jsou označené důvodem service. Jakmile je služba znovu v pořádku – po aktualizaci přihlašovacích údajů, znovupřipojení OAuth nebo úspěšném health-checku – automaticky se uvolní: znovu se pro ně zarezervuje kredit a odešlou se v původním pořadí. Můžete je také uvolnit nebo zahodit ručně. Vyprší stejně jako ostatní držené zprávy (Free 3 dny, placené tarify 14 dní) a předtím vám přijde e-mail.

Health-checky

• Denně: Frontmail ověří každou službu (stejná kontrola jako Otestovat spojení).
• Okamžitě po chybě autentizace při odesílání.
• Při uložení: kdykoli upravíte přihlašovací údaje nebo znovu připojíte OAuth.

Služba je ve stavu healthy (Funguje), unhealthy (Nefunguje) nebo unknown (Neověřeno). Když služba přestane fungovat, vlastník a admini dostanou e-mail a dashboard ukazuje banner Jedna z e-mailových služeb nefunguje s tlačítkem Opravit službu, dokud se služba nevzpamatuje; jakmile je zase v pořádku a pozdržené zprávy se uvolní, přijde další e-mail.

Webhooky o doručení

Transakční poskytovatelé umí hlásit, co se se zprávou stalo poté, co ji přijali. URL webhooku najdete na stránce služby a nastavíte ji v konzoli poskytovatele:

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

<type> je typ poskytovatele z tabulky výše (např. mailgun), <token> je náhodný token jedinečný pro danou službu – celou URL berte jako tajemství. Pokud to poskytovatel podporuje, Frontmail navíc ověřuje jeho podpis.

Události se promítají do stavů zpráv a statistik:

Událost poskytovatele	Frontmail
delivered	stav delivered
hard bounce	stav bounced + adresa přidána na seznam potlačených adres
soft bounce	jen událost (poskytovatel to zkouší znovu)
spam complaint	stav complained + adresa přidána na seznam potlačených adres
open / click	události opened / clicked na časové ose a ve statistikách

Bez webhooků skončí zpráva ve stavu sent – to znamená, že ji poskytovatel přijal.

V dashboardu

Přidání, otestování i opravu služeb popisuje část E-mailové služby.