Das Viber-Kanalobjekt für [Advanced transactional](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-transactional/2.0/). Es wird in das Objekt `channel` unter den Schlüssel `viber` eingefügt - siehe [Kanalkaskade](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-kaskade/).

> [!IMPORTANT]
> Werbenachrichten verwenden unter demselben Schlüssel ein **anderes** Viber-Objekt - statt Vorlagen enthält es eine Schaltfläche und ein Bild. Siehe [Viber – Werbung](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-viber-werbung/).

```json
{
	"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](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-kaskade/)                                     |    Nein     |    `null`     |
| sender              | Registrierter Viber-Absender. Er muss zuerst registriert werden. Für die Registrierung wenden Sie sich [hier](https://www.bulkgate.com/de/kontaktieren-sie-uns/) 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     |     `[]`      |

> [!IMPORTANT]
> 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](https://www.bulkgate.com/de/hilfe-center/viber/registrierung-von-viber-vorlagen/).

> [!WARNING]
> **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.

```http-json
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.

```http-json
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](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-transactional/2.0/).