Transakčné Viber správy sa posielajú cez šablóny, ktoré vopred schváli Viber. Šablónu zaregistrujete priamo v portáli: vyplníte znenie a premenné, portál ju odošle Viberu na schválenie a po schválení ju môžete použiť v moduloch aj v API. Ako sa šablóny účtujú, popisuje stránka [Typy Viber správ](https://www.bulkgate.com/sk/centrum-pomoci/viber/typy-viber-business-sprav/).

## Skôr než začnete

Šablóna sa vždy registruje pod konkrétnym Viber odosielateľom, takže najprv potrebujete mať [zaregistrovaného Viber odosielateľa](https://www.bulkgate.com/sk/centrum-pomoci/viber/registracia-viber-odosielatela/). Kým žiadneho nemáte, sekcia so šablónami namiesto formulára zobrazí len upozornenie.

## Založenie šablóny

1. V portáli otvorte **SMS a Viber správy → Šablóny Viberu**.
2. Kliknite na **Nová šablóna**.
3. Vyplňte formulár podľa tabuľky nižšie a prípadne pridajte [premenné](#premenne).
4. Kliknite na **Vytvoriť**. Portál šablónu odošle Viberu na schválenie.

| Pole | Čo vyplniť |
|:-------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Kľúč šablóny | Vaše vlastné označenie šablóny, max. 64 znakov. Portál ho uloží malými písmenami, bez diakritiky a namiesto medzier a ďalších znakov použije pomlčky. Presnú podobu uvidíte v zozname šablón pod názvom, s `@` na začiatku — pod ňou šablónu voláte z API |
| Meno | Názov šablóny, max. 64 znakov. Povolené sú len písmená, číslice a medzery — ostatné znaky portál odstráni |
| Odosielateľ | Viber odosielateľ, pod ktorým sa šablóna schvaľuje a z ktorého sa potom správy posielajú |
| Typ | `Transactional` pre oznámenia, `OTP` pre jednorazové overovacie kódy |
| Jazyk | Jazyk znenia šablóny. Predvyplní sa jazyk, v ktorom máte portál |
| Text správy | Znenie šablóny, max. 875 znakov |

Pri jednom odosielateľovi nemôžu mať rovnaký kľúč dve šablóny v rovnakom jazyku. Ďalší jazyk k rovnakej šablóne pridáte ako [jazykovú verziu](#jazykove-verzie).

## Premenné

Premenná je miesto v texte, ktoré sa pri odoslaní nahradí konkrétnou hodnotou, napríklad číslom objednávky.

- Premennú pridáte tlačidlom **Pridajte premennú**. Šablóna ich môže mať najviac 8.
- Pri každej vyplníte **Názov premennej** (max. 50 znakov) a **Príklad hodnoty** (max. 125 znakov). Príklad je povinný — posiela sa Viberu spolu so šablónou na schválenie.
- Do textu sa premenná zapisuje ako `{{názov}}`. Môžete ju napísať ručne, alebo ju vložiť tlačidlom `{}` vedľa premennej — vloží sa na koniec textu.

Príklad textu s dvoma premennými `cislo` a `datum`:

> Vaša objednávka {{cislo}} bola odoslaná a doručíme ju {{datum}}. Ďakujeme za nákup.

### Pravidlá pre premenné

- Každá premenná zo zoznamu musí byť v texte použitá.
- Text nesmie obsahovať `{{…}}` s názvom, ktorý v zozname premenných nie je.
- Premenná nesmie stáť na úplnom začiatku textu. Pri type `Transactional` nesmie stáť ani na úplnom konci.

> [!TIP]
> Keď premenná stojí na začiatku alebo na konci textu, portál nezobrazí žiadne hlásenie — len tlačidlo **Vytvoriť** zostane neaktívne. Ak sa šablóna nedá vytvoriť a chyba nie je vidieť, skontrolujte najprv okraje textu.

### OTP šablóna

Pri type `OTP` portál sám pridá premennú `pin` s ukážkovou hodnotou `0451`. Do nej sa pri odoslaní doplní overovací kód. Premennú `pin` nemožno premenovať ani odobrať a musí byť v texte použitá. Na rozdiel od transakčnej šablóny smie stáť aj na konci textu.

## Schválenie šablóny

Po vytvorení sa šablóna objaví v zozname. Pri každej jazykovej verzii vidíte jej text, stav a vedľa stavu ID šablóny u Viberu.

- **Čakajúci** — Viber šablónu ešte posudzuje.
- **Schválené** — šablónu môžete používať.
- Zamietnutú šablónu Viber neschválil a nedá sa použiť.

Stav sa v zozname zmení sám, len čo Viber šablónu posúdi.

> [!IMPORTANT]
> Kým šablóna nie je v stave **Schválené**, portál cez ňu správu neodošle a v moduloch ju neponúkne.

Schválenú ani zamietnutú šablónu v portáli upraviť nemožno. Ak chcete zmeniť znenie, jazykovú verziu zmažte a založte ju znova s rovnakým kľúčom — nové znenie opäť prejde schválením.

> [!NOTE]
> Šablóna, ktorá pre vášho odosielateľa vznikne u Viberu mimo portálu, sa do zoznamu doplní automaticky a dostane vygenerovaný kľúč.

## Jazykové verzie

Jedna šablóna môže mať znenie vo viacerých jazykoch. Ďalší jazyk pridáte ikonou ⊕ **Pridať jazykovú verziu** pri šablóne v zozname. Kľúč, meno, odosielateľ a typ zostávajú rovnaké — vyberiete len jazyk, napíšete text a vyplníte premenné.

Každá jazyková verzia sa schvaľuje zvlášť a má vlastný stav. Pri odosielaní vždy vyberáte konkrétnu jazykovú verziu.

Jazykovú verziu zmažete ikonou koša pri nej. Po potvrdení sa zmaže v portáli aj u Viberu.

## Použitie šablóny

### V moduloch

V sekcii **Moduly a API** otvorte nastavenie notifikácií a pri Viber kanáli prepnite text správy z voľného textu na registrovanú šablónu. Potom ju vyberte zo zoznamu — ponúkajú sa len schválené šablóny odosielateľa, ktorého má notifikácia nastaveného, každá jazyková verzia zvlášť.

Pri každej premennej šablóny sa zobrazí pole, do ktorého môžete vložiť premenné modulu. Keď pole necháte prázdne, doplní sa hodnota premennej modulu s rovnakým názvom. Výsledok uvidíte v náhľade pod poliami.

### Cez API

V [Advanced transactional API](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-viber-transakcne/) sa šablóna odosiela v objekte `viber` týmito parametrami:

| Parameter | Hodnota |
|:----------------------|:------------------------------------------------------------------------------------------------------------------------------|
| `template_id` | Kľúč šablóny s `@` na začiatku, napr. `@potvrdenie-objednavky`, alebo ID šablóny u Viberu zo zoznamu šablón |
| `template_language` | Kód jazykovej verzie, ktorú chcete poslať. Ak ho nevyplníte, použije sa `en` |
| `template_parameters` | Hodnoty všetkých premenných šablóny pod ich názvami, napr. `{"cislo": "12345", "datum": "v piatok"}`. Každá sa skráti na 125 znakov |

Väčšina jazykov má dvojpísmenový kód (`cs`, `sk`, `en`, `de`…). Výnimkou sú francúzština `fr_FR`, španielčina `es_ES`, portugalčina `pt_BR` a `pt_PT` a čínština `zh-Hans` a `zh-Hant`.

Správu cez šablónu API neodošle, keď šablóna neexistuje, nemá požadovanú jazykovú verziu, nie je schválená alebo keď nedostane všetky jej premenné.