Přihlásit se

Vyzkoušet zdarma

Registrace Viber šablon

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.

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. Dokud žádného nemáte, sekce se šablonami místo formuláře zobrazí jen upozornění.

Založení šablony

V portálu otevřete SMS a Viber → Šablony Viberu.
Klikněte na Nová šablona.
Vyplňte formulář podle tabulky níže a případně přidejte proměnné.
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.

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í.

Důležité

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.

Poznámka

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

Byla tato stránka užitečná?

Zeptat se AI Zkopírováno