Viber kanál – transakčné správy

Objekt Viber kanála pre Advanced transactional. Vkladá sa do objektu channel pod kľúč viber - pozrite Kaskáda.

Dôležité

Propagačné správy používajú pod rovnakým kľúčom iný Viber objekt - namiesto šablón nesie tlačidlo a obrázok. Pozrite Viber – propagačný.

{ "viber": { "sender": "BulkGate", "expiration": 300 } }

Viber objekt

NÁZOV PARAMETRA	HODNOTA	POVINNÝ	PREDVOLENÁ HODNOTA
text	Text Viber správy. Má prednosť pred textom na najvyššej úrovni, pozrite Ktorý text sa použije	Nie	`null`
sender	Registrovaný Viber odosielateľ. Musí byť najprv zaregistrovaný. Pre registráciu kontaktujte podporu tu	Áno	-
expiration	Časový limit v sekundách, po ktorého uplynutí sa použije ďalší kanál v kaskáde. Hodnoty nižšie ako `60` sa ignorujú a nahradia sa predvolenou hodnotou	Nie	`300`
template_id	Kľúč schválenej Viber šablóny s `@` na začiatku (napr. `@potvrdenie-objednavky`), alebo ID šablóny u Viberu. Keď je vyplnený, správa sa odošle ako šablóna a `text` sa nepoužije	Nie	`null`
template_language	Kód jazykovej verzie šablóny. Väčšina jazykov má dvojpísmenový kód (`cs`, `en`), výnimkou sú `fr_FR`, `es_ES`, `pt_BR`, `pt_PT`, `zh-Hans` a `zh-Hant`	Nie	`en`
template_parameters	Asociatívne pole parametrov šablóny, napr.: `{"code": "0451"}`	Nie	`[]`

Dôležité

Na šablónu prepína template_id, nie use_template. Parameter use_template sa kvôli spätnej kompatibilite stále prijíma, ale na tomto endpointe nemá žiadny vplyv.

Každá transakčná Viber správa musí bežať na šablóne, ktorú vopred schválil Viber. Ako šablónu zaregistrovať, popisuje stránka Registrácia Viber šablón.

Upozornenie

Bez template_id sa správa neúčtuje za transakčnú cenu. Viber správa odoslaná cez tento endpoint bez šablóny odchádza za propagačnú cenu; ako transakčná sa účtuje len správa bežiaca na schválenej šablóne.

Príklad kompletnej požiadavky

Najprv Viber, SMS ako záchrana. Text na najvyššej úrovni použijú obe vetvy kaskády; expiration určuje, ako dlho sa na Viber čaká, kým sa prepne na SMS.

POST /api/2.0/advanced/transactional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["420777777777"], "text": "Your order 4517 has been shipped.", "channel": { "viber": { "sender": "BulkGate", "expiration": 120 }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

Tá istá správa ako schválená šablóna. template_id prepne Viber vetvu na šablónu, takže text na najvyššej úrovni dorazí len do SMS vetvy - a Viber vetva sa účtuje za transakčnú cenu.

POST /api/2.0/advanced/transactional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["375291234567"], "text": "Your verification code is 0451.", "channel": { "viber": { "sender": "BulkGate", "template_id": "TEMPLATE_ID", "template_language": "en", "template_parameters": {"code": "0451"} }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

Odpoveď je pre všetky kanály rovnaká - pozrite Advanced transactional.

Bola táto stránka užitočná?

Opýtať sa AI Skopírované