Prihlásiť sa

Vyskúšať zadarmo

Registrácia Viber šablón

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.

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. Kým žiadneho nemáte, sekcia so šablónami namiesto formulára zobrazí len upozornenie.

Založenie šablóny

V portáli otvorte SMS a Viber správy → Šablóny Viberu.
Kliknite na Nová šablóna.
Vyplňte formulár podľa tabuľky nižšie a prípadne pridajte premenné.
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.

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.

Dôležité

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.

Poznámka

Š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 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é.

Bola táto stránka užitočná?

Opýtať sa AI Skopírované