Viber kanál – transakční zprávy

Objekt Viber kanálu pro Advanced transactional. Vkládá se do objektu channel pod klíč viber - viz Kaskáda.

Důležité

Promo zprávy používají pod stejným klíčem jiný Viber objekt - místo šablon nese tlačítko a obrázek. Viz Viber – promo.

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

Viber objekt

NÁZEV PARAMETRU	HODNOTA	POVINNÝ	VÝCHOZÍ HODNOTA
text	Text Viber zprávy. Má přednost před textem na nejvyšší úrovni, viz Který text se použije	Ne	`null`
sender	Registrovaný Viber odesílatel. Musí být nejdříve registrován. Pro registraci kontaktujte podporu zde	Ano	-
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	Ne	`300`
template_id	Klíč schválené Viber šablony s `@` na začátku (např. `@potvrzeni-objednavky`), nebo ID šablony u Viberu. Když je vyplněné, odešle se zpráva jako šablona a `text` se nepoužije	Ne	`null`
template_language	Kód jazykové verze šablony. Většina jazyků má dvoupísmenný kód (`cs`, `en`), výjimkou jsou `fr_FR`, `es_ES`, `pt_BR`, `pt_PT`, `zh-Hans` a `zh-Hant`	Ne	`en`
template_parameters	Asociativní pole parametrů šablony, např.: `{"code": "0451"}`	Ne	`[]`

Důležité

Na šablonu přepíná template_id, ne use_template. Parametr use_template se kvůli zpětné kompatibilitě stále přijímá, ale na tomto endpointu nemá žádný vliv.

Každá transakční Viber zpráva musí běžet na šabloně, kterou předem schválil Viber. Jak šablonu zaregistrovat, popisuje stránka Registrace Viber šablon.

Upozornění

Bez template_id se zpráva neúčtuje za transakční cenu. Viber zpráva odeslaná přes tento endpoint bez šablony odchází za promoční cenu; jako transakční se účtuje jen zpráva běžící na schválené šabloně.

Příklad kompletního requestu

Nejdřív Viber, SMS jako záchrana. Text na nejvyšší úrovni použijí obě větve kaskády; expiration říká, jak dlouho se na Viber čeká, než se přepne 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" } } }

Tatáž zpráva jako schválená šablona. template_id přepne Viber větev na šablonu, takže text na nejvyšší úrovni dorazí jen do SMS větve - a Viber větev se úč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" } } }

Odpověď je pro všechny kanály stejná - viz Advanced transactional.

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

Zeptat se AI Zkopírováno