E-mailer

E-mailer je centrální rozhraní pro veškerou odchozí e-mailovou komunikaci organizace — sjednocuje přehled odeslaných zpráv, aktuální technický stav odesílací služby, statistiky doručitelnosti a nástroje pro ruční odesílání. Většina ostatních částí systému je s tímto modulem propojena: transakční potvrzovací e-maily z objednávek, notifikace o stížnostech, zprávy z E-mailových šablon a E-mailových rozvržení a hromadné e-maily z Newsletterových kampaní – to vše sem spadá jako specifické odchozí zprávy ve frontě. Operátor tak má jedno místo, kde může zkontrolovat, zda bylo vše správně odesláno, zda se nevyskytují systémové chyby a zda je doručitelnost na očekávané úrovni.

Stav systému

Horní část stránky slouží jako rychlý "dashboard" pro sledování stavu e-mailové služby. Operátor zde okamžitě zjistí, zda je systém vůbec schopen odesílat e-maily, jak se mu v poslední době dařilo a zda aktuálně běží velká kampaň, která by mohla ovlivnit dostupnou kapacitu.

• Stav odesílání — indikátor, zda je služba SMTP správně nakonfigurována pro organizaci. Bez nakonfigurovaného SMTP nelze odesílat žádné zprávy.
• Statistiky odesílání — souhrnná čísla za aktuální období: počet odeslaných, doručených, otevřených, selhaných zpráv a zpráv ve frontě.
• Běžící kampaně — pokud je aktuálně spuštěna newsletterová kampaň, zobrazí se zde odkaz na její detaily.

⚠️ Pokud indikátor hlásí nekonfigurované SMTP, všechny nové zprávy zůstanou ve frontě a systém je nebude odesílat. Otevřete Konfiguraci SMTP a vyplňte přihlašovací údaje k odesílacímu serveru, než fronta naroste do nezvladatelných rozměrů.

Přehled e-mailů

Pod sekcí stavu se nachází hlavní tabulka se všemi odeslanými a zařazenými zprávami. Jedná se o auditní přehled — každá zpráva, která kdy opustila systém (nebo se o to alespoň pokusila), má svůj vlastní řádek, takže je možné zpětně dohledat, kdy a komu bylo co odesláno. Tento záznam je klíčový, zejména při řešení stížností, podpory nebo sporů ohledně doručení.Jednotlivé sloupce uvádějí:

• Příjemce — odkaz na detail kontaktu, pokud je adresa propojena s existujícím zákazníkem.
• Předmět — normalizovaný text předmětu (převedený na jeden řádek).
• Stav — aktuální stav zpracování zprávy.
• Datum — čas zařazení do fronty nebo čas odeslání.
• Tag — volitelný textový štítek pro filtrování (např. "stížnost-42", "kampaň-2026-04").

Tabulka se automaticky obnovuje každých 5 sekund a nad ní je k dispozici filtr podle stavu zprávy, tagu a konkrétního kontaktu příjemce — což umožňuje okamžitě zobrazit všechny zprávy odeslané jednomu zákazníkovi napříč různými moduly.

Stavy zpráv

Každá zpráva prochází sekvencí stavů, které popisují její aktuální fázi zpracování. Stavy nejsou jen dekorativní — určují, zda má smysl ruční zásah a zda by chyba měla být považována za dočasnou nebo trvalou.

• Ve frontě (inQueue) — zpráva čeká na odeslání; runner ji zpracovává podle priority a naplánovaného času.
• Nepřipraveno (notReadyToQueue) — chybí povinné parametry (např. obsah šablony); zpráva je dočasně zpožděna.
• Čeká na další pokus (waitingForNextAttempt) — předchozí pokus selhal na úrovni SMTP a systém automaticky naplánoval další pokus se zpožděním.
• Odesláno (sent) — zpráva úspěšně opustila SMTP server.
• Chyba přípravy (preparingError) — obsah nelze sestavit (např. chybí proměnná v šabloně).
• Chyba odesílání (sendingError) — SMTP server zprávu odmítl nebo došlo k selhání sítě.
• Nedoručitelné (undeliverable) — adresa je anonymní nebo prokazatelně neplatná; další pokusy jsou zbytečné.

💡 Každá zpráva má prioritu od 1 do 9 (výchozí 5). Nižší číslo znamená dřívější zpracování ve frontě — systémové notifikace, jako je reset hesla, mají prioritu 1, aby dorazily bez ohledu na to, kolik marketingových zpráv čeká na odeslání.

Fronta (Scheduler)

Odchozí zprávy nikdy nejdou přímo na internet; nejprve jsou umístěny do interní fronty, kterou runner zpracovává podle promyšlené posloupnosti pravidel. Účelem fronty je zabránit přetížení SMTP serveru a zároveň zajistit, aby kritické zprávy (např. potvrzení plateb) nečekaly za hromadou marketingových e-mailů.

1. Priorita — zprávy s nižším číslem (vyšší priorita) jsou zpracovány jako první.
2. Plánovaný čas — sendEarliestAt určuje nejčasnější možnou dobu odeslání; typické použití je naplánování zprávy na všední den ráno.
3. Počet pokusů — pokud předchozí pokus selhal, systém čeká na zpoždění, aby se zabránilo přetížení chybného serveru.
4. Souběžnost — paralelně může pracovat více runnerů; každou zprávu zpracovává přesně jeden.

Fronta automaticky odstraňuje zprávy s evidentně nedoručitelnými adresami (např. domény @anonymous interně generované systémem), čímž se předchází plýtvání kapacitou.

ℹ️ Fronta je odolná vůči pádům aplikace — pokud je zpráva přerušena během odesílání, vrátí se do stavu "čeká na další pokus" a bude znovu zařazena do fronty. Žádná zpráva se "neztratí" jen kvůli restartu procesu.

Vytvořit nový e-mail

Většina zpráv je generována automaticky z jiných modulů, ale operátoři občas potřebují odeslat jednorázovou ruční zprávu — ať už se jedná o individuální komunikaci se zákazníkem, oznámení o změně nebo technickou zprávu mimo standardní šablony. Tlačítko Vytvořit e-mail otevře editor, kde můžete vyplnit předmět, napsat HTML obsah (systém automaticky vygeneruje textovou verzi), připojit soubory z úložiště a vybrat, zda zpráva půjde jednomu příjemci nebo více kontaktům najednou. Příjemci se vybírají pomocí automatického doplňování podle ID kontaktu.Po potvrzení je zpráva přidána do fronty s výchozí prioritou a její obsah je komprimován a uložen do úložiště — tak, aby zůstal k dispozici pro auditní přístup v budoucnu, i když se mezitím šablona nebo obrázky změnily.

Detail e-mailu

Kliknutím na libovolnou zprávu se otevře její detail, který operátorovi poskytne kompletní obrázek o tom, co se se zprávou stalo od jejího vytvoření až po konečný stav. Jedná se o hlavní nástroj pro řešení dotazů typu "Nedostal jsem váš e-mail" — operátor může ověřit, zda zpráva vůbec vznikla, zda opustila SMTP server a zda příjemce mohl odpovědět.

• Obsah zprávy — přesný HTML, včetně vloženého rozvržení a zápatí, tak, jak byl "zmrazen" v době odeslání.
• Seznam příjemců — primární adresa (To), kopie (Cc, Bcc), odesílatel a adresa pro odpověď.
• Přílohy — stáhnout jednotlivé soubory přesně tak, jak byly připojeny k e-mailu.
• Log doručení — kroky přípravy a odesílání, včetně odpovědí SMTP serveru.
• Systémový log — interní události (zařazení do fronty, pokusy, chyby).
• AI Vysvětlení — asistent umělé inteligence, který shrnuje technické chybové zprávy do srozumitelného formátu.

Detail také obsahuje akce Odeslat ihned, které obcházejí frontu a zprávu okamžitě odešlou, a Odeslat znovu pro opětovné odeslání již odeslané nebo selhané zprávy.

⚠️ Akce "Odeslat ihned" ignoruje naplánovaný čas a limity rychlosti. Používejte ji pouze pro jednotlivé testovací nebo naléhavé zprávy, nikoli pro hromadné rozesílání — jinak se můžete setkat s limity poskytovatele a poškodit doručitelnost ostatních zpráv.

Konfigurace SMTP

Kontextové menu obsahuje položku Konfigurace SMTP, kde se zadávají přihlašovací údaje odesílacího serveru — tedy kam má systém odesílat zprávy, aby se dostaly k příjemcům. Typicky se jedná o službu jako SendGrid, Resend, Postmark nebo vlastní Postfix. Při uložení konfigurace systém odešle testovací e-mail na zadanou testovací adresu; nastavení jsou potvrzena pouze jeho úspěšným doručením.

• Host — název domény SMTP serveru (např. smtp.example.com).
• Port — obvykle 465 (SSL) nebo 587 (STARTTLS).
• Adresa odesílatele (from) — e-mailová adresa, kterou příjemci vidí jako odesílatele.
• Uživatelské jméno a heslo — ověřování u poskytovatele.
• Testovací adresa — při uložení konfigurace je na tuto adresu odeslán testovací e-mail k potvrzení správnosti nastavení.

💡 Organizace může samostatně konfigurovat transakční (objednávky, hesla) a marketingové (newslettery) odesílací adresy. Toto oddělení chrání reputaci domény — marketingové kampaně nikdy neovlivní doručitelnost kritických notifikací, které zákazník očekává během několika sekund.

Logo, zápatí a vzhled

Odchozí zprávy jsou automaticky obaleny do rozvržení organizace — tj. přidává se logo, zápatí a responzivní šířka, aby e-mail vypadal konzistentně bez ohledu na to, z jakého modulu pochází. Vzhled samotného rozvržení se konfiguruje na stránce E-mailová rozvržení (/emailer-layout) a konkrétní šablony pro jednotlivé typy zpráv se konfigurují v E-mailových šablonách (/emailer-template). E-mailer tedy nepřepisuje obsah, ale pouze jej vkládá do obalu definovaného organizací.

Tagy

Každá zpráva může mít textový tag, což umožňuje snadno dohledat všechny zprávy související s konkrétní objednávkou, stížností nebo kampaní — například customer-1234, complaint-42 nebo job-newsletter-2026-04. Tagy se zobrazují v tabulce a lze podle nich filtrovat, takže při řešení konkrétního případu operátor okamžitě vidí kompletní historii komunikace napříč moduly.