Transakční Viber zprávy se posílají přes šablony, které předem schválí Viber. Šablonu zaregistrujete přímo v portálu: vyplníte znění a proměnné, portál ji odešle Viberu ke schválení a po schválení ji můžete použít v modulech i v API. Jak se šablony účtují, popisuje stránka [Typy Viber zpráv](https://www.bulkgate.com/cs/centrum-napovedy/viber/typy-viber-business-zprav/). ## Než začnete Šablona se vždy registruje pod konkrétním Viber odesílatelem, takže nejdřív potřebujete mít [zaregistrovaného Viber odesílatele](https://www.bulkgate.com/cs/centrum-napovedy/viber/registrace-viber-odesilatele/). Dokud žádného nemáte, sekce se šablonami místo formuláře zobrazí jen upozornění. ## Založení šablony 1. V portálu otevřete **SMS a Viber → Šablony Viberu**. 2. Klikněte na **Nová šablona**. 3. Vyplňte formulář podle tabulky níže a případně přidejte [proměnné](#promenne). 4. Klikněte na **Vytvořit**. Portál šablonu odešle Viberu ke schválení. | Pole | Co vyplnit | |:-------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Klíč šablony | Vaše vlastní označení šablony, max. 64 znaků. Portál ho uloží malými písmeny, bez diakritiky a místo mezer a dalších znaků použije pomlčky. Přesnou podobu uvidíte v seznamu šablon pod názvem, s `@` na začátku — pod ní šablonu voláte z API | | Jméno | Název šablony, max. 64 znaků. Povolená jsou jen písmena, číslice a mezery — ostatní znaky portál odstraní | | Odesílatel | Viber odesílatel, pod kterým se šablona schvaluje a ze kterého se pak zprávy posílají | | Typ | `Transactional` pro oznámení, `OTP` pro jednorázové ověřovací kódy | | Jazyk | Jazyk znění šablony. Předvyplní se jazyk, ve kterém máte portál | | Text zprávy | Znění šablony, max. 875 znaků | U jednoho odesílatele nemůže mít stejný klíč dvě šablony ve stejném jazyce. Další jazyk ke stejné šabloně přidáte jako [jazykovou verzi](#jazykove-verze). ## Proměnné Proměnná je místo v textu, které se při odeslání nahradí konkrétní hodnotou, třeba číslem objednávky. - Proměnnou přidáte tlačítkem **Přidat proměnnou**. Šablona jich může mít nejvýš 8. - U každé vyplníte **Název proměnné** (max. 50 znaků) a **Příklad hodnoty** (max. 125 znaků). Příklad je povinný — posílá se Viberu spolu se šablonou ke schválení. - Do textu se proměnná zapisuje jako `{{název}}`. Můžete ji napsat ručně, nebo ji vložit tlačítkem `{}` vedle proměnné — vloží se na konec textu. Příklad textu se dvěma proměnnými `cislo` a `datum`: > Vaše objednávka {{cislo}} byla odeslána a doručíme ji {{datum}}. Děkujeme za nákup. ### Pravidla pro proměnné - Každá proměnná ze seznamu musí být v textu použitá. - Text nesmí obsahovat `{{…}}` s názvem, který v seznamu proměnných není. - Proměnná nesmí stát na úplném začátku textu. U typu `Transactional` nesmí stát ani na úplném konci. > [!TIP] > Když proměnná stojí na začátku nebo na konci textu, portál nezobrazí žádnou hlášku — jen tlačítko **Vytvořit** zůstane neaktivní. Pokud nejde šablonu vytvořit a chyba není vidět, zkontrolujte nejdřív okraje textu. ### OTP šablona U typu `OTP` portál sám přidá proměnnou `pin` s ukázkovou hodnotou `0451`. Do ní se při odeslání doplní ověřovací kód. Proměnnou `pin` nelze přejmenovat ani odebrat a musí být v textu použitá. Na rozdíl od transakční šablony smí stát i na konci textu. ## Schválení šablony Po vytvoření se šablona objeví v seznamu. U každé jazykové verze vidíte její text, stav a vedle stavu ID šablony u Viberu. - **Čekající** — Viber šablonu ještě posuzuje. - **Schváleno** — šablonu můžete používat. - Zamítnutou šablonu Viber neschválil a použít ji nelze. Stav se v seznamu změní sám, jakmile Viber šablonu posoudí. > [!IMPORTANT] > Dokud šablona není ve stavu **Schváleno**, portál přes ni zprávu neodešle a v modulech ji nenabídne. Schválenou ani zamítnutou šablonu v portálu upravit nejde. Chcete-li změnit znění, jazykovou verzi smažte a založte ji znovu se stejným klíčem — nové znění opět projde schválením. > [!NOTE] > Šablona, která pro vašeho odesílatele vznikne u Viberu mimo portál, se do seznamu doplní automaticky a dostane vygenerovaný klíč. ## Jazykové verze Jedna šablona může mít znění ve více jazycích. Další jazyk přidáte ikonou ⊕ **Přidat jazykovou verzi** u šablony v seznamu. Klíč, jméno, odesílatel a typ zůstávají stejné — vyberete jen jazyk, napíšete text a vyplníte proměnné. Každá jazyková verze se schvaluje zvlášť a má vlastní stav. Při odesílání vždy vybíráte konkrétní jazykovou verzi. Jazykovou verzi smažete ikonou koše u ní. Po potvrzení se smaže v portálu i u Viberu. ## Použití šablony ### V modulech V sekci **Moduly a API** otevřete nastavení notifikací a u Viber kanálu přepněte text zprávy z volného textu na registrovanou šablonu. Pak ji vyberte ze seznamu — nabízejí se jen schválené šablony odesílatele, kterého má notifikace nastaveného, každá jazyková verze zvlášť. U každé proměnné šablony se zobrazí pole, do kterého můžete vložit proměnné modulu. Když pole necháte prázdné, doplní se hodnota proměnné modulu se stejným názvem. Výsledek uvidíte v náhledu pod poli. ### Přes API V [Advanced transactional API](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-viber-transakcni/) se šablona odesílá v objektu `viber` těmito parametry: | Parametr | Hodnota | |:----------------------|:------------------------------------------------------------------------------------------------------------------------------| | `template_id` | Klíč šablony s `@` na začátku, např. `@potvrzeni-objednavky`, nebo ID šablony u Viberu ze seznamu šablon | | `template_language` | Kód jazykové verze, kterou chcete poslat. Bez vyplnění se použije `en` | | `template_parameters` | Hodnoty všech proměnných šablony pod jejich názvy, např. `{"cislo": "12345", "datum": "v pátek"}`. Každá se zkrátí na 125 znaků | Většina jazyků má dvoupísmenný kód (`cs`, `sk`, `en`, `de`…). Výjimkou jsou francouzština `fr_FR`, španělština `es_ES`, portugalština `pt_BR` a `pt_PT` a čínština `zh-Hans` a `zh-Hant`. Zprávu přes šablonu API neodešle, když šablona neexistuje, nemá požadovanou jazykovou verzi, není schválená, nebo když nedostane všechny její proměnné.