Canal Viber – transactionnel
L'objet du canal Viber pour Advanced transactional. Il se place dans l'objet channel sous la clé viber - voir Cascade.
Les messages promotionnels utilisent un objet Viber différent sous la même clé - il comporte un bouton et une image au lieu de modèles. Voir Viber – promotionnel.
Objet Viber
| NOM DU PARAMÈTRE | VALEUR | OBLIGATOIRE | VALEUR PAR DÉFAUT |
|---|---|---|---|
| text | Texte du message Viber. Remplace le text de premier niveau, voir Quel texte est utilisé |
Non | null |
| sender | Expéditeur Viber enregistré. Il doit d'abord être enregistré. Pour l'enregistrement, contactez le support ici | Oui | - |
| expiration | Délai en secondes après lequel le canal suivant de la cascade est utilisé. Les valeurs inférieures à 60 sont ignorées et remplacées par la valeur par défaut |
Non | 300 |
| template_id | Clé d'un modèle Viber approuvé précédée de @ (p. ex. @order-confirmation), ou l'ID du modèle chez Viber. Lorsqu'il est renseigné, le message est envoyé sous forme de modèle et text n'est pas utilisé |
Non | null |
| template_language | Code de la version linguistique du modèle. La plupart des langues ont un code à deux lettres (cs, en), les exceptions sont fr_FR, es_ES, pt_BR, pt_PT, zh-Hans et zh-Hant |
Non | en |
| template_parameters | Tableau associatif des paramètres du modèle, p. ex. : {"code": "0451"} |
Non | [] |
C'est template_id qui fait passer le message en modèle - pas use_template. Le paramètre use_template est toujours accepté pour des raisons de rétrocompatibilité, mais il n'a aucun effet sur cet endpoint.
Tout message Viber transactionnel doit reposer sur un modèle approuvé au préalable par Viber. La procédure d'enregistrement d'un modèle est décrite sur la page Enregistrement d'un modèle Viber.
Sans template_id, le message n'est pas facturé au tarif transactionnel. Un message Viber envoyé via cet endpoint sans modèle part au tarif promotionnel ; seul un message reposant sur un modèle approuvé est facturé comme transactionnel.
Exemple de requête complète
Viber d'abord, SMS en solution de repli. Le text de premier niveau est utilisé par les deux branches de la cascade ; expiration indique combien de temps nous attendons Viber avant de passer au SMS.
Le même message sous forme de modèle approuvé. template_id fait passer la branche Viber au modèle, de sorte que le text de premier niveau n'atteint que la branche SMS - et la branche Viber est facturée au tarif transactionnel.
La réponse est la même pour tous les canaux - voir Advanced transactional.
Merci pour votre retour.