Kanalkaskade

Objektet channel bestemmer hvilke kanaler meldingen sendes gjennom, og i hvilken rekkefølge. Det er tilgjengelig i Advanced transaksjoner og Advanced markedsføring, bare i API-versjon 2.0.

Kanaltabell

Hver nøkkel i objektet channel er én kanal og inneholder kanalens eget objekt.

NØKKEL	KANALOBJEKT
`sms`	SMS
`viber`	Viber – transaksjoner / Viber – markedsføring
`rcs`	RCS
`whatsapp`	WhatsApp

Rekkefølgen i kaskaden

Rekkefølgen på nøklene i forespørselen er rekkefølgen i kaskaden. Den første nøkkelen er primærkanalen; hvis meldingen ikke kan leveres gjennom den, brukes den neste kanalen i listen.

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

Her prøves Viber først og SMS deretter. Bytter du om de to nøklene, byttes prioriteten - ingenting annet i forespørselen endres.

Viktig

SMS legges ikke automatisk til på slutten av kaskaden. Hvis du vil ha SMS som siste reserve, må du oppgi objektet sms eksplisitt. En kaskade med bare {"viber": {…}} har ingen reserve i det hele tatt.

Hvis channel utelates helt, sendes meldingen som SMS med standardavsenderen.

Bytte mellom kanaler - `expiration`

Hvert kanalobjekt har sin egen expiration - tidsgrensen i sekunder, deretter brukes neste kanal i kaskaden. Verdier under 60 ignoreres og erstattes med standardverdien for den aktuelle kanalen.

KANAL	STANDARD `expiration`
`viber`	`300`
`rcs`	`60`
`whatsapp`	`180`

Hvilken tekst som brukes

sms og viber henter teksten fra tre steder etter tur, og det første som ikke er tomt, vinner:

PRIORITET	STED	MERKNAD
1	`number[].text`	tekst for én bestemt mottaker, se Verdi `number`
2	`channel.sms.text` / `channel.viber.text`	tekst for akkurat den kanalen
3	`text`	tekst på øverste nivå i forespørselen

rcs og whatsapp leser ingen av dem. Innholdet deres ligger i deres eget variantobjekt (message, template, card, …), så text på øverste nivå har ingen virkning på dem.

Feil

TYPE	BETYDNING
`invalid_rcs_variant`	objektet `rcs` inneholder ingen eller mer enn én av `message`/`file`/`card`/`carousel`
`invalid_whatsapp_variant`	objektet `whatsapp` inneholder ingen eller mer enn én av `template`/`otp`/`message`/`file`/`location`
`no_recipients`	forespørselen ga ingen gyldig mottaker

Se alle feiltypene for Simple API og Advanced API her.

Var denne siden nyttig?

Spør AI Kopiert