Canal Viber – promotionnel

L'objet du canal Viber pour les SMS promotionnels (Advanced). Il se place dans l'objet channel sous la clé viber – voir Cascade.

Important

Les messages transactionnels utilisent sous la même clé un objet Viber différent – il contient des modèles approuvés au lieu d'un bouton et d'une image. Voir Viber – transactionnel.

{ "viber": { "sender": "BulkGate", "image": "https://example.com/banner.jpg", "button": { "caption": "Ouvrir l'offre", "url": "https://example.com/offre" } } }

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 l'assistance 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`
button	Structure qui crée un bouton dans le message, voir Objet Button. Sans elle, le message n'a pas de bouton	Non	`null`
image	URL d'une image affichée dans le message	Non	`null`

Objet Button

NOM DU PARAMÈTRE	VALEUR	OBLIGATOIRE	VALEUR PAR DÉFAUT
caption	Texte du bouton	Non	`OK`
url	Adresse URL	Non	`#`

Les valeurs par défaut ne s'appliquent que si l'objet button lui-même est présent – "button": {} crée un bouton intitulé OK qui pointe vers #.

Exemple de requête complète

Viber avec une image et un bouton, SMS en solution de repli. Le volet SMS n'a ni image ni bouton, il se rabat donc sur le text de premier niveau.

POST /api/2.0/advanced/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["420777777777", "420777777778"], "text": "Spring sale starts today, up to 50 % off.", "channel": { "viber": { "sender": "BulkGate", "image": "https://example.com/spring-sale.jpg", "button": { "caption": "Open the offer", "url": "https://example.com/spring-sale" } }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

La réponse est identique pour tous les canaux – voir SMS promotionnels (Advanced).

Cette page vous a-t-elle été utile ?

Demander à l'IA Copié