Cascade de canaux

L'objet channel détermine par quels canaux le message est envoyé et dans quel ordre. Il est disponible dans Advanced transactional et Advanced promotional, uniquement dans la version 2.0 de l'API.

Tableau des canaux

Chaque clé de l'objet channel correspond à un canal et contient l'objet propre à ce canal.

CLÉ	OBJET DU CANAL
`sms`	SMS
`viber`	Viber – transactionnel / Viber – promotionnel
`rcs`	RCS
`whatsapp`	WhatsApp

Ordre de la cascade

L'ordre des clés dans votre requête est l'ordre de la cascade. La première clé est le canal principal ; si le message ne peut pas être remis par ce canal, le canal suivant de la liste est utilisé.

{ "channel": { "viber": { "sender": "BulkGate" }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

Ici, Viber est essayé en premier, le SMS en second. Si vous intervertissez les deux clés, la priorité s'inverse - rien d'autre ne change dans la requête.

Important

Le SMS n'est pas ajouté automatiquement à la fin de la cascade. Si vous voulez le SMS comme dernier recours, indiquez explicitement l'objet sms. Une cascade composée uniquement de {"viber": {…}} n'a aucun canal de secours.

Si channel est entièrement omis, le message est envoyé par SMS avec l'expéditeur par défaut.

Passage d'un canal à l'autre - `expiration`

Chaque objet de canal a sa propre expiration - le 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 du canal.

CANAL	`expiration` PAR DÉFAUT
`viber`	`300`
`rcs`	`60`
`whatsapp`	`180`

Quel texte est utilisé

sms et viber cherchent le texte à trois endroits successifs, le premier non vide l'emporte :

PRIORITÉ	EMPLACEMENT	REMARQUE
1	`number[].text`	texte d'un destinataire précis, voir Valeur `number`
2	`channel.sms.text` / `channel.viber.text`	texte pour ce seul canal
3	`text`	texte de premier niveau de la requête

rcs et whatsapp n'en lisent aucun. Leur contenu se trouve dans leur propre objet de variante (message, template, card, …), le text de premier niveau n'a donc aucun effet sur eux.

Erreurs

TYPE	SIGNIFICATION
`invalid_rcs_variant`	l'objet `rcs` ne contient aucun ou plus d'un des éléments `message`/`file`/`card`/`carousel`
`invalid_whatsapp_variant`	l'objet `whatsapp` ne contient aucun ou plus d'un des éléments `template`/`otp`/`message`/`file`/`location`
`no_recipients`	la requête n'a produit aucun destinataire valide

Consultez tous les types d'erreurs de Simple API et Advanced API ici.

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

Demander à l'IA Copié