Viber-Kanal – transaktional

Das Viber-Kanalobjekt für Advanced transactional. Es wird in das Objekt channel unter den Schlüssel viber eingefügt - siehe Kanalkaskade.

Wichtig

Werbenachrichten verwenden unter demselben Schlüssel ein anderes Viber-Objekt - statt Vorlagen enthält es eine Schaltfläche und ein Bild. Siehe Viber – Werbung.

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

Viber-Objekt

PARAMETERNAME	WERT	PFLICHT	STANDARDWERT
text	Text der Viber-Nachricht. Hat Vorrang vor dem `text` der obersten Ebene, siehe Welcher Text verwendet wird	Nein	`null`
sender	Registrierter Viber-Absender. Er muss zuerst registriert werden. Für die Registrierung wenden Sie sich hier an den Support	Ja	-
expiration	Zeitlimit in Sekunden, nach dessen Ablauf der nächste Kanal der Kaskade verwendet wird. Werte unter `60` werden ignoriert und durch den Standardwert ersetzt	Nein	`300`
template_id	Schlüssel einer genehmigten Viber-Vorlage mit vorangestelltem `@` (z. B. `@order-confirmation`) oder die ID der Vorlage bei Viber. Ist er ausgefüllt, wird die Nachricht als Vorlage gesendet und `text` wird nicht verwendet	Nein	`null`
template_language	Code der Sprachversion der Vorlage. Die meisten Sprachen haben einen zweistelligen Code (`cs`, `en`), Ausnahmen sind `fr_FR`, `es_ES`, `pt_BR`, `pt_PT`, `zh-Hans` und `zh-Hant`	Nein	`en`
template_parameters	Assoziatives Array der Vorlagenparameter, z. B.: `{"code": "0451"}`	Nein	`[]`

Wichtig

Auf die Vorlage schaltet template_id um, nicht use_template. Der Parameter use_template wird aus Gründen der Abwärtskompatibilität weiterhin akzeptiert, hat auf diesem Endpunkt aber keine Wirkung.

Jede transaktionale Viber-Nachricht muss auf einer Vorlage basieren, die Viber vorab genehmigt hat. Wie Sie eine Vorlage registrieren, beschreibt die Seite Registrierung von Viber-Vorlagen.

Warnung

Ohne template_id wird die Nachricht nicht zum Transaktionstarif abgerechnet. Eine über diesen Endpunkt ohne Vorlage gesendete Viber-Nachricht wird zum Werbetarif versendet; nur eine Nachricht auf Basis einer genehmigten Vorlage wird als transaktional abgerechnet.

Beispiel einer vollständigen Anfrage

Zuerst Viber, SMS als Ausweichkanal. Den text der obersten Ebene verwenden beide Stufen der Kaskade; expiration gibt an, wie lange auf Viber gewartet wird, bevor auf SMS umgeschaltet wird.

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" } } }

Dieselbe Nachricht als genehmigte Vorlage. template_id schaltet die Viber-Stufe auf die Vorlage um, sodass der text der obersten Ebene nur die SMS-Stufe erreicht - und die Viber-Stufe wird zum Transaktionstarif abgerechnet.

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" } } }

Die Antwort ist für alle Kanäle gleich - siehe Advanced transactional.

War diese Seite hilfreich?

KI fragen Kopiert