Transakční šablony: vstupní pole a publikace
Transakční šablonu vytvoříte v Šablonách s účelem Transakční, přidáte vstupní pole pro údaje, které pošle váš systém, a publikujete konkrétní verzi. Transakční e-maily a API jsou jen v placených tarifech, tarif Free je nemá.
Šablona je předloha e-mailu, který váš systém posílá přes API jednomu příjemci, například potvrzení objednávky. Potřebujete ověřenou vlastní doménu, bez ní se neodesílá, a odesílatele projektu. Ceny najdete na stránce Ceník.
Účel šablony
Účel šablony vyberete při vytvoření v Šablonách: Marketingová, nebo Transakční. Později se nemění. Transakční šablona má kopírovatelné ID, vlastní vstupní pole a neměnnou publikovanou verzi. Nepoužije se v marketingové kampani ani v automatizaci. Publikovanou šablonu lze archivovat, ne smazat. V knihovně je pod názvem každé šablony štítek Marketingová nebo Transakční, u transakční i stav publikace a tlačítko ID pro kopírování.
Vstupní pole
Vstupní pole jsou údaje, které váš systém pošle spolu s požadavkem, například číslo objednávky nebo jméno. Vytvoříte je v editoru šablony. Pole může být text, číslo, ano/ne, datum, HTTPS odkaz nebo e-mail. U každého určíte povinnost, omezení a příklad. Šablona může mít nejvýše 64 polí. Hodnoty jsou vždy data, nikdy HTML ani kód.
Seznamy položek
Když má jedna zpráva obsahovat víc údajů stejného druhu, například řádky objednávky, použijte seznam položek. Definujete ho jednou v Nastavení → Vlastní pole v oddílu Seznamy položek. V Nastavení šablony pak v kartě Seznamy položek seznam jen vyberete. Šablona může mít nejvýše 8 seznamů, seznam nejvýše 50 položek a položka nejvýše 16 údajů. Opakování položek zatím funguje v šablonách s vlastním HTML.

Odesílatel a odkaz na doménu
- Ve šabloně vyplňte Předmět a Úvodní text. Mohou obsahovat vaše vstupní pole.
- Vyberte výchozího odesílatele z odesílatelů projektu a případně adresu pro odpovědi. Bez výchozího odesílatele šablonu nepublikujete, uložit ji jako koncept jde. Odesílatele nastavíte podle návodu Odesílatelé: jméno, adresa Od a adresa pro odpovědi.
- Zkontrolujte odkazy. Šablonu s odkazem na doménu NG Emailingu nepublikujete, příjemce smí vidět jen adresy na vaší doméně. Adresa pro odpovědi také nesmí patřit doméně platformy.
Náhled a publikace
Náhled zobrazíte při ručním testu na stránce Transakční e-maily (Otestovat zprávu, Zkontrolovat a zobrazit náhled). Ruční test používá publikovanou verzi.
Šablonu pak publikujete tlačítkem Publikovat uloženou revizi. Pozor: po publikaci už šablonu v aplikaci neupravíte. Publikovanou verzi používá ostré odesílání. Samotná publikace nic neodešle. Stav vidíte na štítku Publikováno: verze N nebo Nepublikováno. Šablonu s odhlašovacím odkazem a měřením otevření si nastavte před publikací.
Změna publikované šablony
Publikovaná šablona se otevře jen ke čtení se štítkem Jen ke čtení. Úpravu uděláte tlačítkem Upravit jako kopii…. Kopie dostane nové ID a převezme obsah, vstupní pole, odesílatele a další nastavení. Je nepublikovaná. Upravíte ji a publikujete. Původní šablona se nezmění a posílá se dál, dokud váš systém nepřejde na nové ID. Tak integrace posílající podle ID stále dostávají stejný obsah.
Název, popis a štítky publikované šablony změníte dál v Nastavení nebo ve Vlastnostech v knihovně, příjemcům se neposílají.
Sdílení do jiných projektů
Publikovanou transakční šablonu můžete nasdílet do jiných projektů své organizace, například z testovacího do produkčního. V knihovně otevřete nabídku šablony a zvolte Sdílet s projekty…. V cílovém projektu je šablona jen ke čtení, převezme ji vlastník nebo administrátor tlačítkem Převzít a vybere odesílatele z ověřené domény svého projektu. Sdílení nic neodešle.
Když to nejde
- Šablonu nejde publikovat. Zkontrolujte výchozího odesílatele a odkazy na doménu NG Emailingu. Chybu ukáže editor nad tlačítkem Publikovat uloženou revizi.
- Šablonu nejde upravit. Je publikovaná. Použijte Upravit jako kopii….
- Požadavek API vrátí chybu
409 template_published_locked. Integrace se pokusila změnit publikovanou šablonu. Vytvořte kopii a přejděte na její nové ID. - Chybí povinné pole. API požadavek odmítne a ukáže přesné místo chyby.
Časté dotazy
Mohu transakční šablonu použít v kampani?
Ne. Marketingové kampaně a automatizace transakční šablonu nepřijmou.
Čím se šablona s odkazem na odhlášení liší od servisní?
Zprávu s novinkami nebo nabídkou označte přepínačem Zpráva má odkaz na odhlášení. Zprávu, kterou příjemce potřebuje, například potvrzení nebo smlouvu, nechte bez něj. O souhlasu rozhoduje váš systém, aplikace stav odhlášení nevede.
Kde zjistím ID šablony?
V knihovně u každé transakční šablony, tlačítkem ID (Kopírovat ID).
Další krok
Až budete mít šablonu publikovanou, pošlete první zprávu podle návodu Transakční e-mail přes API. Co transakční e-maily nabízejí, shrnuje stránka Transakční e-maily.
Nevíte si rady? V aplikaci se zeptejte AI pomocníka nebo napište podpoře. Jak podpora funguje