Stránka /emailer-template slouží ke správě e-mailových šablon, které systém používá pro automatické odesílání zpráv. Typickými příklady jsou potvrzení objednávky, resetování hesla, uvítací e-mail nového zákazníka nebo upozornění na změnu stavu reklamace.
Šablona určuje předmět a obsah jedné konkrétní události v konkrétním jazyce. V kombinaci s Rozložením e-mailů (společný layout s logem a patičkou) vznikne výsledná zpráva, která se odešle přes E-mailer.
Přehled šablon
Tabulka obsahuje tyto sloupce:
- Název a popis — lidsky čitelné pojmenování šablony (například „Potvrzení objednávky"), doplněné o předmět e-mailu, který příjemce uvidí.
- Typ — interní kód události, pro kterou je šablona určena (např.
order-confirmation,contact-reset-password). - Jazyk — jazyková mutace (CZ, SK, EN, DE apod.).
- Aktivní — zelená ikona znamená, že šablona je používána; šedá, že je vypnutá.
- Platné od / Platné do — časové omezení, kdy je šablona platná (například sezónní nabídka, přechodná verze textu).
- Datum změny — kdy byla šablona naposledy upravena.
Jak systém vybírá šablonu
Při odeslání transakční nebo notifikační zprávy systém vyhledává šablonu v následujícím pořadí:
- Podle typu události — např. nová objednávka → hledá se typ
order-confirmation. - Podle jazyka příjemce — přednost má šablona v jazyce zákazníka; pokud není, bere se první dostupná jiná jazyková mutace.
- Podle varianty — některé typy mají více variant (například oznámení o stavu objednávky pro různé stavové kódy). Pokud je specifikovaná varianta, použije se přednostně.
- Pouze aktivní šablony — vypnuté šablony se nikdy nepoužijí.
- Výchozí šablona — pokud organizace nemá vlastní, použije se systémová výchozí šablona pro daný jazyk.
ℹ️ Díky tomuto řetězci můžete bezpečně přepínat mezi starou a novou verzí šablony pomocí příznaku Aktivní nebo pomocí Platnosti od/do, aniž by hrozilo, že některá zpráva zůstane bez obsahu.
Platnost a aktivace
Šablona má dvě nezávislé úrovně řízení, kdy je v provozu:
- Aktivní příznak — jednoduchý ruční přepínač. Neaktivní šablona se vždy přeskočí.
- Platné od / Platné do — časové okno. Šablona začne platit automaticky v určený den a skončí po vypršení. Umožňuje připravit změnu dopředu (např. nový text k Vánocům).
Obě úrovně lze kombinovat: šablona musí být aktivní a v platném časovém okně.
💡 Pro plánované kampaňové texty doporučujeme vždy nastavit Platné do — zabráníte tím nechtěnému odeslání zastaralého obsahu.
Jazykové mutace
Jedna událost (typ) může mít libovolný počet jazykových mutací. Systém automaticky volí tu, která odpovídá jazyku příjemce:
- Pokud zákazník má v profilu nastavenou češtinu, použije se CZ varianta.
- Pokud v daném jazyce šablona neexistuje, nabídne se jiná libovolná aktivní verze.
- Pokud žádná varianta není, použije se výchozí systémová šablona.
⚠️ Vždy se ujistěte, že alespoň jedna jazyková mutace je aktivní. V opačném případě systém použije obecný výchozí text, který se nemusí hodit k vaší značce.
Proměnné
Obsah šablony se sestavuje pomocí proměnných uzavřených do dvojitých složených závorek, například {{customerName}} nebo {{order.number}}. Systém tyto zástupné znaky při odesílání nahrazuje skutečnými hodnotami z databáze.
Dostupné proměnné se liší podle typu šablony — u objednávky jsou to čísla položek, adresy a celkové částky; u resetu hesla jde o odkaz s jednorázovým tokenem. Seznam všech proměnných pro aktuální typ šablony je zobrazen přímo v editoru včetně ukázkových hodnot.
Validace proměnných
Systém před odesláním kontroluje:
- zda jsou všechny použité proměnné definované pro daný typ šablony,
- zda existují data, která se mají dosadit (pokud chybí, šablona se pokusí načíst výchozí hodnotu),
- formát datumů, částek a čísel (automatické lokalizované zobrazení).
Nerozpoznaná proměnná zůstane v textu v doslovné podobě — to je záměr, aby šlo snadno odhalit překlep. V takovém případě dostane zpráva stav chyba při přípravě a nebude odeslána.
Vytvoření nové šablony
Tlačítko Add v pravém horním rohu otevře formulář pro založení nové šablony:
- Typ události — výběr z katalogu podporovaných typů (potvrzení objednávky, reset hesla, newsletter onboarding atd.).
- Unikátní kód šablony — např.
order-confirmed-v2. Slouží jako interní identifikátor pro další úpravy a propojení. - Varianta (volitelně) — suffix pro odlišení více šablon stejného typu (např. podle objednávkové skupiny).
- Název — lidsky čitelné označení zobrazené v administraci.
- Předmět — výchozí text předmětu e-mailu. Může obsahovat proměnné.
- Jazyk — primární lokalizace šablony.
Volitelně lze při vytváření rovnou přiřadit šablonu k objednávkové skupině a stavu (například „Potvrzení — skupina VIP — stav ZAPLACENO"). Tím se automaticky aktivuje pro příslušný scénář.
Detail a editace šablony
Kliknutím na řádek se otevře editor:
- Předmět — jednořádkový text, může obsahovat proměnné.
- Obsah — HTML editor s podporou formátování, obrázků a vložených proměnných. V náhledu vidíte, jak bude zpráva vypadat po zabalení do layoutu organizace.
- Typ a varianta — základní identifikace.
- Jazyk a platnost — kdy a komu je šablona určena.
- Aktivní — okamžité zapnutí nebo vypnutí.
Tlačítko Poslat testovací e-mail odešle zprávu aktuálně přihlášenému uživateli s dosazenými testovacími hodnotami. Používejte před každou důležitou změnou, abyste ověřili vzhled i funkčnost odkazů.
Filtrování
V horním panelu lze filtrovat šablony podle:
- Typu události
- Jazyka
- Stavu aktivity
💡 Pokud potřebujete rychle najít šablonu, která by se měla použít při konkrétní akci, filtrujte podle typu. Výsledkem je úplný seznam variant včetně platnosti, a rychle odhalíte, kdo je „aktivní vítěz" pro daný jazyk.
Správa většího počtu šablon
V rozsáhlejších organizacích (desítky šablon) se osvědčuje tato disciplína:
- Pojmenovávat šablony verzí (např.
-v1,-v2) a starší verze deaktivovat, nikoli mazat. Historie odeslaných zpráv tak zůstává dohledatelná. - Udržovat konzistentní tón předmětu napříč jazyky.
- Přílohy (například všeobecné obchodní podmínky jako PDF) připojovat přímo k šabloně; systém je pak automaticky přibalí ke každé odeslané zprávě.
- Testovat každou změnu pomocí Poslat testovací e-mail před aktivací.