# E-mailové šablony, popis všech polí a zástupných textů

Každá e-mailová šablona: komu a kdy se posílá, co jde upravit, které zástupné texty v ní fungují a co se stane, když je smažete.

## Kde to je

V panelu v nabídce otevřete E-mailové šablony (adresa `/Admin/EmailTemplates`). Stránka ukazuje seznam karet, jednu pro každou šablonu. Tlačítko Upravit otevře editor šablony (adresa `/Admin/EmailTemplates?edit={typ}`).

## K čemu stránka slouží

Šablony určují předmět a text všech e-mailů, které systém posílá zákazníkům a vám. Každý poskytovatel má vlastní kopii všech šablon ve výchozím znění. Upravit lze předmět a tělo, text je HTML. Jméno odesílatele, odesílací adresa a adresa pro odpověď se tady nenastavují (jméno odesílatele je název provozovny z Profil).

## Všechny šablony

Každá karta v seznamu ukazuje název, štítek příjemce (Zákazník nebo Poskytovatel), popis situace a aktuální předmět. Šablon je sedmnáct:

| Šablona | Komu | Kdy se posílá |
| --- | --- | --- |
| Potvrzení rezervace zákazníkovi | Zákazník | Jen když je zapnutá volba Zákazník musí potvrdit rezervaci e-mailem. Posílá se ihned po vytvoření rezervace a obsahuje odkaz pro potvrzení (magic link). |
| Rezervace automaticky potvrzena | Zákazník | Ve výchozím nastavení: rezervace se potvrdí hned, bez klikání na odkaz. |
| Rezervace čeká na schválení | Zákazník | Když rezervace čeká na schválení provozovatelem. |
| Rezervace potvrzena poskytovatelem | Zákazník | Po ručním potvrzení rezervace provozovatelem. |
| Opakovaná rezervace potvrzena (série termínů) | Zákazník | Po zadání opakované rezervace v panelu, jeden e-mail za celou sérii se seznamem všech termínů. U každého termínu je odkaz Zrušit tento termín, ale jen když je povoleno zrušení zákazníkem. |
| Rezervace odmítnuta | Zákazník | Když provozovatel rezervaci odmítne. |
| Rezervace zrušena | Zákazník | Po zrušení rezervace zákazníkem nebo provozovatelem. |
| Připomínka před návštěvou | Zákazník | Automaticky před termínem. Předstih v hodinách určuje pole E-mailová připomínka (hodin před rezervací) v Nastavení, Rezervace. |
| Nová rezervace (pro poskytovatele) | Poskytovatel | Při každé nové rezervaci. Informuje o zákazníkovi, službě a čase. |
| Rezervace ke schválení (pro poskytovatele) | Poskytovatel | Když zákazník potvrdil e-mail a rezervace čeká na schválení. |
| Magic link – potvrzení e-mailu | Zákazník | E-mail s odkazem pro ověření adresy zákazníka. Odkaz platí 15 minut. |
| Potvrzení registrace na event | Zákazník | Po registraci na skupinovou akci, například workshop nebo kurz. |
| Nová registrace na event (pro poskytovatele) | Poskytovatel | Při nové registraci na skupinovou akci. |
| Zrušení zaplacené objednávky vstupenek | Zákazník | Když pořadatel zruší zaplacenou objednávku vstupenek, v panelu i přes API pro platby. Vstupenky přestanou platit, místa se uvolní a zpráva uvádí kontakt na pořadatele kvůli vrácení peněz. |
| Přístupový kód k zámku | Zákazník | S přístupovým kódem u rezervací se zámkem. Obsahuje kód, dobu platnosti a údaje o rezervaci. |
| Změna termínu rezervace | Zákazník | Po přesunu rezervace na jiný termín provozovatelem. Obsahuje původní i nový termín. |
| Platba předem – text v potvrzovacím e-mailu | Zákazník | Text o platbě celé ceny v prvním e-mailu. |
| Záloha – text v potvrzovacím e-mailu | Zákazník | Text o záloze v prvním e-mailu. |

Ve výchozím nastavení se rezervace potvrdí hned a zákazník dostane zprávu Rezervace automaticky potvrzena. Šablona Potvrzení rezervace zákazníkovi s odkazem na potvrzení se posílá jen při zapnuté volbě Zákazník musí potvrdit rezervaci e-mailem. Při ručním schvalování dostane zákazník zprávu Rezervace čeká na schválení a po vašem rozhodnutí zprávu Rezervace potvrzena poskytovatelem nebo Rezervace odmítnuta. Co se děje v jednotlivých stavech rezervace, popisuje soubor Stavy rezervace.

Oznámení poskytovateli se posílá majiteli. Je-li rezervace přiřazená zaměstnanci s e-mailem, dostává oznámení o nové rezervaci, zrušení, přesunu a připomínku i on. Zda je majitel dostane také, určuje pole Posílat mi e-maily i o rezervacích, o kterých už dostal e-mail zaměstnanec. Zaměstnanec bez e-mailu nebo neaktivní oznámení nedostane, oznámení o nové rezervaci pak dostane majitel.

## Pole stránky E-mailové šablony

### Upravit

- **Co dělá:** Odkaz na kartě šablony, který otevře editor té šablony. Odkaz Zpět na seznam se z editoru vrací bez uložení.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Odkaz.
- **Platí pro:** všechny šablony.
- **Na co má vliv:** Jen otevření editoru. Šablona se mění až uložením.

### Předmět e-mailu

- **Co dělá:** Předmět zprávy, který zákazník nebo majitel uvidí v poště. Zástupné texty se v něm dosazují stejně jako v těle.
- **Výchozí hodnota:** Výchozí předmět dané šablony. Každý účet má vlastní kopii šablon.
- **Povolené hodnoty:** Libovolný text, povinné. Prázdný předmět nebo prázdné tělo vrátí chybu „Vyplňte předmět i tělo e-mailu.“ a nic se neuloží.
- **Platí pro:** všechny šablony.
- **Na co má vliv:** Předmět odeslaných e-mailů. Změna se projeví u dalších odeslaných zpráv, už odeslané se nemění. Pozor, dopad: text vidí všichni zákazníci, kterým se zpráva odešle. Před ostrým použitím si šablonu vyzkoušejte zkušební rezervací na vlastní e-mail, původní podobu vrátíte tlačítkem Načíst výchozí šablonu, pozor, vaše úpravy tím zmizí.

### Tělo e-mailu (HTML)

- **Co dělá:** Text zprávy ve formátu HTML. Zástupné texty ve dvojitých složených závorkách se při odeslání nahradí skutečnými údaji.
- **Výchozí hodnota:** Výchozí tělo dané šablony.
- **Povolené hodnoty:** HTML, povinné. Běžný text mezi značkami `<p>` a `</p>` můžete psát po svém, značky samotné ponechte. Pod editorem je seznam zástupných textů platných pro danou šablonu. Aplikace při uložení nevaruje před překlepem v zástupném textu. Neexistující nebo chybně napsaný zástupný text se v odeslaném e-mailu nahradí prázdným místem.
- **Platí pro:** všechny šablony.
- **Na co má vliv:** Obsah odeslaných e-mailů. Smazaný zástupný text znamená, že údaj v e-mailu chybí, například bez odkazu pro potvrzení nebo schválení zákazník či vy akci z e-mailu neprovedete.
- **Časté omyly:** U šablon Záloha a Platba předem se upravuje jen text. QR kód a tabulku platebních údajů doplní systém vždy pod něj a smazat se nedají.

### Uložit šablonu

- **Co dělá:** Uloží předmět a tělo šablony. Po uložení se zobrazí hláška „Šablona byla uložena.“
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny šablony.
- **Na co má vliv:** Další odeslané e-maily této šablony.

### Načíst výchozí šablonu

- **Co dělá:** Vrátí předmět i tělo šablony do výchozího znění. Před provedením se zobrazí dotaz „Obnovit výchozí šablonu? Vaše úpravy budou ztraceny.“
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** vždy jen právě otevřenou šablonu.
- **Na co má vliv:** Smaže vaše úpravy této šablony. Ostatních šablon se nedotkne.

U šablon Záloha a Platba předem editor navíc ukazuje dvě upozornění. První říká, že výchozí text mluví o první rezervaci, takže při režimu Všichni klienti je třeba text upravit. Druhé připomíná, že editovatelný je jen text, QR kód a tabulku platebních údajů doplní systém pod něj a že použitelné zástupné texty jsou `{castka}`, `{vs}` a `{ucet}` (v jednoduchých závorkách).

## Zástupné texty

Zástupné texty se píší ve dvojitých složených závorkách. Společné pro všechny šablony jsou tyto:

| Zástupný text | Co se dosadí |
| --- | --- |
| `{{customerName}}` | Jméno zákazníka |
| `{{procedureName}}` | Název služby |
| `{{bookingDate}}` | Datum rezervace |
| `{{bookingTime}}` | Čas rezervace |
| `{{providerName}}` | Název vaší provozovny |
| `{{primaryColor}}` | Hlavní barva z nastavení formuláře |

Další zástupné texty podle šablony (přesně ty, které ukazuje seznam pod editorem):

| Šablona | Další zástupné texty |
| --- | --- |
| Potvrzení rezervace zákazníkovi | `{{confirmLink}}`, `{{cancelButton}}`, `{{checkOutRow}}`, `{{personCountRow}}`, `{{staffRow}}`, `{{zaloha_blok}}` |
| Rezervace automaticky potvrzena | `{{cancelSection}}`, `{{checkOutRow}}`, `{{personCountRow}}`, `{{staffRow}}`, `{{zaloha_blok}}` |
| Rezervace potvrzena poskytovatelem | `{{personCountRow}}`, `{{staffRow}}` |
| Opakovaná rezervace potvrzena (série termínů) | `{{terminy_serie}}` |
| Rezervace čeká na schválení | `{{personCountRow}}`, `{{staffRow}}`, `{{zaloha_blok}}` |
| Rezervace ke schválení (pro poskytovatele) | `{{customerEmail}}`, `{{approveLink}}`, `{{rejectLink}}`, `{{personCountRow}}`, `{{staffRow}}`, `{{zaloha_radek}}` |
| Připomínka před návštěvou | `{{personCountText}}` |
| Změna termínu rezervace | `{{originalBookingDate}}`, `{{originalBookingTime}}` |
| Rezervace zrušena | `{{cancellationReasonBlock}}` |
| Nová rezervace (pro poskytovatele) | `{{customerEmail}}`, `{{bookingNoteRow}}`, `{{personCountRow}}`, `{{staffRow}}`, `{{zaloha_radek}}` |
| Magic link – potvrzení e-mailu | `{{confirmLink}}` |
| Přístupový kód k zámku | `{{accessCode}}`, `{{codeValidity}}`, `{{checkOutRow}}`, `{{personCountRow}}`, `{{staffRow}}`, `{{providerAddressRow}}` |
| Potvrzení registrace na event | `{{eventTitle}}`, `{{eventDate}}`, `{{eventTime}}`, `{{ticketCount}}`, `{{confirmationCode}}` |
| Nová registrace na event (pro poskytovatele) | `{{eventTitle}}`, `{{eventDate}}`, `{{eventTime}}`, `{{ticketCount}}`, `{{confirmationCode}}`, `{{customerEmail}}` |
| Zrušení zaplacené objednávky vstupenek | `{{eventTitle}}`, `{{eventDate}}`, `{{eventTime}}`, `{{ticketCount}}`, `{{providerContact}}` |
| Rezervace odmítnuta | žádné další |
| Platba předem a Záloha (text) | jen `{castka}`, `{vs}`, `{ucet}` v jednoduchých závorkách |

Význam dalších zástupných textů:

| Zástupný text | Co se dosadí |
| --- | --- |
| `{{confirmLink}}` | Odkaz pro potvrzení rezervace nebo e-mailu. Bez něj zákazník rezervaci nepotvrdí a zůstane nepotvrzená. |
| `{{cancelButton}}` | Tlačítko pro zrušení. Zobrazí se jen když zrušení zákazníkem povolíte. |
| `{{cancelSection}}` | Blok se zrušením v e-mailu automaticky potvrzené rezervace. Podrobné chování při zakázaném rušení neověřeno. |
| `{{approveLink}}`, `{{rejectLink}}` | Odkazy pro schválení a odmítnutí z e-mailu. Bez nich rezervaci z e-mailu nerozhodnete. |
| `{{checkOutRow}}` | Řádky Odjezd a Počet nocí. U ubytování, jinak prázdné. |
| `{{personCountRow}}` | Řádek Počet osob. Jen u služeb, kde zákazník počet osob vybírá, jinak prázdné. |
| `{{personCountText}}` | Věta Počet osob v připomínce, stejné pravidlo. |
| `{{staffRow}}` | Řádek Specialista s přiřazenou osobou. Prázdné, když osoba není přiřazená. |
| `{{zaloha_blok}}` | Blok s požadavkem platby předem pro zákazníka (text z šablony Záloha nebo Platba předem, QR kód a tabulka). Bez něj zákazník platební údaje v e-mailu nedostane. |
| `{{zaloha_radek}}` | Řádek se zálohou v e-mailu poskytovateli. |
| `{{terminy_serie}}` | Tabulka termínů opakované rezervace s odkazy pro zrušení jednotlivých termínů. |
| `{{customerEmail}}` | E-mail zákazníka. |
| `{{bookingNoteRow}}` | Řádek s poznámkou zákazníka, když ji zadal. |
| `{{originalBookingDate}}`, `{{originalBookingTime}}` | Původní datum a čas přesunuté rezervace. |
| `{{cancellationReasonBlock}}` | Důvod zrušení, když ho při rušení zadáte. |
| `{{accessCode}}` | Přístupový kód k zámku. |
| `{{codeValidity}}` | Doba platnosti kódu (od, do). |
| `{{providerAddressRow}}` | Adresa provozovny v e-mailu s kódem. |
| `{{eventTitle}}`, `{{eventDate}}`, `{{eventTime}}`, `{{ticketCount}}`, `{{confirmationCode}}` | Název akce, datum, čas, počet vstupenek a kód rezervace u skupinové akce. |
| `{{providerContact}}` | E-mail a telefon pořadatele, na který se zákazník obrátí kvůli vrácení peněz po zrušení objednávky. |
| `{castka}`, `{vs}`, `{ucet}` | Částka, variabilní symbol a číslo účtu v textech Záloha a Platba předem. |

## Jak spolu pole souvisí

- Která z dvou potvrzovacích šablon odejde, závisí na volbě Zákazník musí potvrdit rezervaci e-mailem a na ručním schvalování v Nastavení, Rezervace.
- Šablony Záloha a Platba předem se vkládají do prvního e-mailu přes zástupný text `{{zaloha_blok}}`. Když ho smažete z těla potvrzovací šablony, zákazník platební údaje nedostane.
- Předstih připomínky se nenastavuje tady, ale v poli E-mailová připomínka (hodin před rezervací).
- Šablony s typem příjemce Poskytovatel jdou majiteli, případně i zaměstnanci.

## Příklady nastavení

**Osobní tón.** U šablony Rezervace automaticky potvrzena změňte předmět na `Děkujeme za rezervaci, {{customerName}}` a úvodní odstavec na `<p>Ahoj {{customerName}}, těšíme se na vás v {{providerName}}.</p>`. Zbytek těla nechte a uložte.

**Záloha pro všechny.** Při režimu Všichni klienti upravte text šablony Záloha, aby nemluvil jen o první rezervaci. QR kód a tabulka zůstanou.

**Návrat k původnímu.** Když si e-mail pokazíte, otevřete šablonu a stiskněte Načíst výchozí šablonu.

## Technická poznámka

Informace jsou převzaté ze zdrojového kódu (`EmailTemplates.cshtml`, `EmailTemplates.cshtml.cs`, `EmailTemplateService.cs`, `EmailNotificationService.cs`, `EmailTemplateType.cs`). Kde chování nebylo možné ověřit, je to napsáno výslovně slovem Neověřeno.

Verze nápovědy: 1.0.2.74, 2026-11-22
