Kaskáda kanálů

Objekt channel určuje, kterými kanály se zpráva odešle a v jakém pořadí. Je k dispozici v Advanced transactional a Advanced promotional, pouze ve verzi API 2.0.

Tabulka kanálů

Každý klíč objektu channel je jeden kanál a nese vlastní objekt daného kanálu.

KLÍČ	OBJEKT KANÁLU
`sms`	SMS
`viber`	Viber – transakční / Viber – promo
`rcs`	RCS
`whatsapp`	WhatsApp

Pořadí kaskády

Pořadí klíčů v requestu je pořadím kaskády. První klíč je primární kanál; pokud jím zprávu nelze doručit, použije se další kanál v pořadí.

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

Tady se nejdřív zkusí Viber, potom SMS. Prohození obou klíčů prohodí prioritu - nic jiného v requestu se nemění.

Důležité

SMS se na konec kaskády nepřidává automaticky. Pokud ji chcete jako poslední záchranu, uveďte objekt sms explicitně. Kaskáda {"viber": {…}} samotná žádnou záchranu nemá.

Když objekt channel neuvedete vůbec, odešle se zpráva jako SMS s výchozím odesílatelem.

Přepnutí mezi kanály - `expiration`

Každý objekt kanálu má vlastní expiration - časový limit v sekundách, po jehož vypršení se použije další kanál v kaskádě. Hodnoty nižší než 60 se ignorují a nahradí se výchozí hodnotou daného kanálu.

KANÁL	VÝCHOZÍ `expiration`
`viber`	`300`
`rcs`	`60`
`whatsapp`	`180`

Který text se použije

sms a viber hledají text na třech místech, vyhrává první neprázdné:

PRIORITA	MÍSTO	POZNÁMKA
1	`number[].text`	text jednoho konkrétního příjemce, viz Hodnota `number`
2	`channel.sms.text` / `channel.viber.text`	text pro jeden konkrétní kanál
3	`text`	text na nejvyšší úrovni requestu

rcs a whatsapp nečtou ani jedno z nich. Jejich obsah žije uvnitř vlastního objektu varianty (message, template, card, …), takže text na nejvyšší úrovni na ně nemá vliv.

Chyby

TYP	VÝZNAM
`invalid_rcs_variant`	objekt `rcs` neobsahuje žádnou nebo obsahuje víc než jednu z variant `message`/`file`/`card`/`carousel`
`invalid_whatsapp_variant`	objekt `whatsapp` neobsahuje žádnou nebo obsahuje víc než jednu z variant `template`/`otp`/`message`/`file`/`location`
`no_recipients`	request nevytvořil žádného platného příjemce

Všechny typy chyb pro Simple API i Advanced API najdete zde.

Byla tato stránka užitečná?

Zeptat se AI Zkopírováno