Enregistrement des modèles Viber

Les messages Viber transactionnels sont envoyés au moyen de modèles approuvés au préalable par Viber. Vous enregistrez un modèle directement dans le portail : vous saisissez le texte et les variables, le portail soumet le modèle à Viber pour approbation et, une fois approuvé, vous pouvez l'utiliser dans les modules et dans l'API. La facturation des modèles est décrite sur la page Types de messages Viber.

Avant de commencer

Un modèle est toujours enregistré sous un expéditeur Viber précis ; il vous faut donc d'abord un expéditeur Viber enregistré. Tant que vous n'en avez pas, la section des modèles affiche seulement un avertissement à la place du formulaire.

Création d'un modèle

1. Dans le portail, ouvrez Messagerie SMS et Viber → Viber templates.
2. Cliquez sur New template.
3. Remplissez le formulaire selon le tableau ci-dessous et ajoutez si nécessaire des variables.
4. Cliquez sur Créer. Le portail soumet le modèle à Viber pour approbation.

Pour un même expéditeur, une même clé ne peut pas avoir deux modèles dans la même langue. Vous ajoutez une autre langue au même modèle sous forme de version linguistique.

Variables

Une variable est un emplacement du texte qui est remplacé par une valeur précise lors de l'envoi du message, par exemple un numéro de commande.

• Vous ajoutez une variable avec le bouton Add variable. Un modèle peut en compter 8 au maximum.
• Pour chacune, vous renseignez le Nom de variable (50 caractères au maximum) et un Example value (125 caractères au maximum). L'exemple est obligatoire — il est soumis à Viber avec le modèle pour approbation.
• Dans le texte, une variable s'écrit {{nom}}. Vous pouvez la saisir à la main ou l'insérer avec le bouton {} à côté de la variable — elle est insérée à la fin du texte.

Exemple de texte avec deux variables numero et date :

Votre commande {{numero}} a été expédiée et nous vous la livrerons {{date}}. Merci pour votre achat.

Règles pour les variables

• Chaque variable de la liste doit être utilisée dans le texte.
• Le texte ne doit pas contenir de {{…}} dont le nom ne figure pas dans la liste des variables.
• Une variable ne doit pas se trouver tout au début du texte. Pour le type Transactional, elle ne doit pas non plus se trouver tout à la fin.

Modèle OTP

Pour le type OTP, le portail ajoute lui-même la variable pin avec la valeur d'exemple 0451. Le code de vérification y est inséré lors de l'envoi du message. La variable pin ne peut être ni renommée ni supprimée et elle doit être utilisée dans le texte. Contrairement au modèle transactionnel, elle peut aussi se trouver à la fin du texte.

Approbation du modèle

Une fois créé, le modèle apparaît dans la liste. Pour chaque version linguistique, vous voyez son texte, son statut et, à côté du statut, l'identifiant du modèle chez Viber.

• En attente — Viber est encore en train d'examiner le modèle.
• Approved — vous pouvez utiliser le modèle.
• Un modèle refusé n'a pas été approuvé par Viber et ne peut pas être utilisé.

Le statut dans la liste change de lui-même dès que Viber a examiné le modèle.

Un modèle approuvé ou refusé ne peut pas être modifié dans le portail. Pour changer le texte, supprimez la version linguistique et créez-la à nouveau avec la même clé — le nouveau texte passe de nouveau par l'approbation.

Versions linguistiques

Un même modèle peut avoir son texte en plusieurs langues. Vous ajoutez une autre langue avec l'icône ⊕ Add language version à côté du modèle dans la liste. La clé, le nom, l'expéditeur et le type restent les mêmes — vous choisissez seulement la langue, rédigez le texte et renseignez les variables.

Chaque version linguistique est approuvée séparément et a son propre statut. Lors de l'envoi, vous choisissez toujours une version linguistique précise.

Vous supprimez une version linguistique avec l'icône de corbeille située à côté. Après confirmation, elle est supprimée à la fois dans le portail et chez Viber.

Utilisation d'un modèle

Dans les modules

Dans la section Modules & APIs, ouvrez les paramètres des notifications et, pour le canal Viber, faites passer le texte du message d'un texte libre à un modèle enregistré. Choisissez-le ensuite dans la liste — seuls les modèles approuvés de l'expéditeur défini pour la notification sont proposés, chaque version linguistique séparément.

Pour chaque variable du modèle s'affiche un champ dans lequel vous pouvez insérer des variables du module. Si vous laissez le champ vide, la valeur de la variable du module portant le même nom est utilisée. Vous verrez le résultat dans l'aperçu sous les champs.

Via l'API

Dans l'API transactionnelle avancée, un modèle est envoyé dans l'objet viber avec les paramètres suivants :

La plupart des langues ont un code à deux lettres (cs, sk, en, de…). Les exceptions sont le français fr_FR, l'espagnol es_ES, le portugais pt_BR et pt_PT, et le chinois zh-Hans et zh-Hant.

L'API n'envoie pas le message au moyen du modèle lorsque le modèle n'existe pas, n'a pas la version linguistique demandée, n'est pas approuvé ou ne reçoit pas toutes ses variables.