Registrierung von Viber-Vorlagen

Transaktionale Viber-Nachrichten werden über Vorlagen versendet, die Viber vorab genehmigt hat. Eine Vorlage registrieren Sie direkt im Portal: Sie geben den Wortlaut und die Variablen ein, das Portal reicht die Vorlage bei Viber zur Genehmigung ein, und nach der Genehmigung können Sie sie in Modulen und in der API verwenden. Wie Vorlagen abgerechnet werden, ist auf der Seite Viber-Nachrichtentypen beschrieben.

Bevor Sie beginnen

Eine Vorlage wird immer unter einem bestimmten Viber-Absender registriert. Zuerst benötigen Sie daher einen registrierten Viber-Absender. Solange Sie keinen haben, zeigt der Bereich der Vorlagen statt des Formulars nur einen Hinweis an.

Vorlage erstellen

1. Öffnen Sie im Portal SMS & Viber messaging → Viber templates.
2. Klicken Sie auf New template.
3. Füllen Sie das Formular gemäß der Tabelle unten aus und fügen Sie bei Bedarf Variablen hinzu.
4. Klicken Sie auf Erstellen. Das Portal reicht die Vorlage bei Viber zur Genehmigung ein.

Für einen Absender darf derselbe Schlüssel nicht zwei Vorlagen in derselben Sprache haben. Eine weitere Sprache fügen Sie derselben Vorlage als Sprachversion hinzu.

Variablen

Eine Variable ist eine Stelle im Text, die beim Versand durch einen konkreten Wert ersetzt wird, zum Beispiel durch eine Bestellnummer.

• Eine Variable fügen Sie mit der Schaltfläche Add variable hinzu. Eine Vorlage kann höchstens 8 Variablen haben.
• Für jede Variable füllen Sie Variablennamen (max. 50 Zeichen) und Example value (Beispielwert, max. 125 Zeichen) aus. Der Beispielwert ist Pflicht — er wird zusammen mit der Vorlage bei Viber zur Genehmigung eingereicht.
• Im Text wird eine Variable als {{name}} geschrieben. Sie können sie von Hand eingeben oder mit der Schaltfläche {} neben der Variable einfügen — sie wird dann am Ende des Textes eingefügt.

Beispieltext mit den zwei Variablen nummer und datum:

Ihre Bestellung {{nummer}} wurde versandt und wird {{datum}} zugestellt. Vielen Dank für Ihren Einkauf.

Regeln für Variablen

• Jede Variable aus der Liste muss im Text verwendet werden.
• Der Text darf kein {{…}} mit einem Namen enthalten, der nicht in der Liste der Variablen steht.
• Eine Variable darf nicht ganz am Anfang des Textes stehen. Bei einer transaktionalen Vorlage darf sie auch nicht ganz am Ende stehen.

OTP-Vorlage

Bei einer OTP-Vorlage fügt das Portal selbst die Variable pin mit dem Beispielwert 0451 hinzu. In sie wird beim Versand der Verifizierungscode eingesetzt. Die Variable pin kann weder umbenannt noch entfernt werden und muss im Text verwendet werden. Anders als bei einer transaktionalen Vorlage darf sie auch am Ende des Textes stehen.

Genehmigung der Vorlage

Nach dem Erstellen erscheint die Vorlage in der Liste. Für jede Sprachversion sehen Sie ihren Text, ihren Status und neben dem Status die ID der Vorlage bei Viber.

• Steht aus (Pending) — Viber prüft die Vorlage noch.
• Approved — Sie können die Vorlage verwenden.
• Eine abgelehnte Vorlage wurde von Viber nicht genehmigt und kann nicht verwendet werden.

Der Status in der Liste ändert sich von selbst, sobald Viber die Vorlage geprüft hat.

Weder eine genehmigte noch eine abgelehnte Vorlage lässt sich im Portal bearbeiten. Um den Wortlaut zu ändern, löschen Sie die Sprachversion und erstellen Sie sie mit demselben Schlüssel neu — der neue Wortlaut durchläuft die Genehmigung erneut.

Sprachversionen

Eine Vorlage kann ihren Wortlaut in mehreren Sprachen haben. Eine weitere Sprache fügen Sie mit dem Symbol ⊕ Add language version neben der Vorlage in der Liste hinzu. Schlüssel, Name, Absender und Typ bleiben gleich — Sie wählen nur die Sprache, schreiben den Text und füllen die Variablen aus.

Jede Sprachversion wird separat genehmigt und hat ihren eigenen Status. Beim Versand wählen Sie immer eine bestimmte Sprachversion.

Eine Sprachversion löschen Sie mit dem Papierkorb-Symbol daneben. Nach der Bestätigung wird sie sowohl im Portal als auch bei Viber gelöscht.

Vorlage verwenden

In Modulen

Öffnen Sie im Bereich Module und APIs die Einstellungen der Benachrichtigungen und stellen Sie beim Kanal Viber den Nachrichtentext von freiem Text auf eine registrierte Vorlage um. Wählen Sie sie dann aus der Liste — angeboten werden nur genehmigte Vorlagen des Absenders, der für die Benachrichtigung eingestellt ist, und zwar jede Sprachversion einzeln.

Für jede Variable der Vorlage wird ein Feld angezeigt, in das Sie Modulvariablen einfügen können. Lassen Sie das Feld leer, wird der Wert der gleichnamigen Modulvariable verwendet. Das Ergebnis sehen Sie in der Vorschau unter den Feldern.

Über die API

In der Advanced transactional API wird eine Vorlage im Objekt viber mit diesen Parametern gesendet:

Die meisten Sprachen haben einen zweibuchstabigen Code (cs, sk, en, de…). Ausnahmen sind Französisch fr_FR, Spanisch es_ES, Portugiesisch pt_BR und pt_PT sowie Chinesisch zh-Hans und zh-Hant.

Die API versendet die Nachricht über die Vorlage nicht, wenn die Vorlage nicht existiert, die angeforderte Sprachversion nicht hat, nicht genehmigt ist oder nicht alle ihre Variablen erhält.