# Šablony

> Navrhněte e-mail jednou a používejte ho opakovaně při odesílání přes API, v automatizacích a kampaních. Aliasy, verze, tři editory, proměnné Temple a API šablon.

Šablona uchovává předmět, údaje odesílatele a obsah e-mailu, takže ho navrhnete jednou a pak ho opakovaně používáte. Šablony vytváříte ve webovém rozhraní v drag & drop editoru, editoru formátovaného textu nebo HTML editoru, případně je spravujete přes API, a pak je odesíláte podle aliasu a osobní údaje doplníte při odeslání.

## Jak to funguje

1. **Vytvořte šablonu** v **Email Marketing → Templates** nebo přes API. Dejte jí název a alias, například `welcome-email`.
2. **Navrhněte obsah** v jednom ze tří editorů, s proměnnými jako `{{first_name}}` tam, kam patří osobní údaje.
3. **Publikujte ji.** První šablona s novým aliasem se publikuje automaticky. Šablony se stejným aliasem, které přidáte později, se stanou koncepty verzí, které publikujete, až budou připravené.
4. **Odešlete ji.** Zavolejte `POST /emails` s `"template": "welcome-email"` a objektem `variables`. Emailit vykreslí publikovanou verzi jazykem [Temple](/cs/docs/templates/temple/) a odešle ji.

Protože váš kód odkazuje na alias, a ne na konkrétní šablonu, můžete změnit design a publikovat novou verzi bez nasazování kódu.

## Co šablona obsahuje

| Pole | Podrobnosti |
| --- | --- |
| Název | Označení pro váš tým, až 191 znaků. |
| Alias | Identifikátor, který používá váš kód, až 191 znaků z `a–z`, `0–9`, `_` a `-`. Všechny verze šablony sdílejí jeden alias. |
| Editor | **Dragit** (drag & drop), **Rich Text**, nebo **HTML**. |
| Předmět | Výchozí předmět, až 191 znaků. Může obsahovat proměnné. |
| Odesílatel | Výchozí odesílatel, například `Acme <hello@acme.com>`. |
| Adresa pro odpověď | Volitelná adresa nebo adresy pro odpovědi. |
| Obsah | Tělo v HTML, volitelné tělo v prostém textu (přes API) a u šablon Dragit i design jako JSON pro Dragit. |

## Kde můžete šablony použít

| Kde | Jak šablonu používá | Proměnné |
| --- | --- | --- |
| [E-mailové API](/cs/docs/email-api/send-email/#send-with-a-template) | `template` přijímá alias (publikovaná verze), nebo ID `tem_` (přesně tato verze). Předmět, HTML, text a adresa pro odpověď se převezmou ze šablony, pokud je požadavek nepřepíše. Pole `from` v požadavku je vždy povinné. | [Temple](/cs/docs/templates/temple/), plněné z `variables` |
| [Automatizace](/cs/docs/automations/steps/) | Krok **Send email** odešle šablonu. Použije se odesílatel, předmět a adresa pro odpověď ze šablony, pokud je krok nepřepíše. | Temple, plněné z kontaktu a spouštěče |
| [Kampaně](/cs/docs/campaigns/create/) | **Choose from templates** zkopíruje obsah šablony do kampaně jako výchozí bod. **Save as template** udělá z kampaně šablonu. | [Slučovací značky kampaní](/cs/docs/campaigns/merge-tags/) |
| [SMTP relay](/cs/docs/smtp/) | Nedostupné. SMTP odešle zprávu přesně tak, jak jste ji sestavili. | Žádné |

## Co můžete dělat

  - [Editory](/cs/docs/templates/editors/): Vytvářejte šablony a navrhujte je v editoru Dragit, Rich Text nebo HTML.
  - [Jazyk Temple](/cs/docs/templates/temple/): Proměnné, výchozí hodnoty a podmínky a kde se vykreslují.
  - [Verze](/cs/docs/templates/versions/): Připravte novou verzi pod stejným aliasem a publikujte ji, až bude hotová.
  - [Import a export](/cs/docs/templates/import-export/): Naimportujte JSON pro Dragit, HTML nebo balíčky ZIP a zase je vyexportujte.

## API šablon

Šablony můžete spravovat z kódu přes [API šablon](/cs/docs/api-reference/templates/):

| Endpoint | Účel |
| --- | --- |
| [Vytvoření šablony](/cs/docs/api-reference/templates/create/) | Přidá šablonu, nebo novou verzi existujícího aliasu. |
| [Načtení šablony](/cs/docs/api-reference/templates/get/) | Načte jednu verzi včetně obsahu a seznamu ostatních verzí. |
| [Úprava šablony](/cs/docs/api-reference/templates/update/) | Změní pole nebo obsah verze. |
| [Výpis šablon](/cs/docs/api-reference/templates/list/) | Vypíše publikovanou verzi každého aliasu. |
| [Publikování šablony](/cs/docs/api-reference/templates/publish/) | Nastaví verzi jako aktivní pro její alias. |
| [Smazání šablony](/cs/docs/api-reference/templates/delete/) | Smaže jednu verzi. |

API potřebuje klíč **Full Access**. Změny vyvolávají webhookové události `template.created`, `template.updated` a `template.deleted`. Import a export souborů je dostupný jen ve webovém rozhraní.

## Dostupnost

Šablony jsou dostupné ve všech tarifech bez příplatku. Ukládání šablon nespotřebovává kredity; každý e-mail, který se šablonou odešlete, se účtuje jako každé jiné odeslání.

## Začínáme

  - [Vytvoření šablony](/cs/docs/templates/editors/#create-a-template): Nastavte název, alias a editor a pak šablonu navrhněte.
  - [Odeslání se šablonou](/cs/docs/email-api/send-email/#send-with-a-template): Odesílejte ze svého kódu podle aliasu s proměnnými.

---
Zdroj: https://emailit.com/cs/docs/templates/