Das Objekt des Viber-Kanals für [Werbe-SMS (Advanced)](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-promotional/2.0/). Es gehört in das Objekt `channel` unter den Schlüssel `viber` – siehe [Kaskade](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-kaskade/).

> [!IMPORTANT]
> Transaktionale Nachrichten verwenden unter demselben Schlüssel ein **anderes** Viber-Objekt – es enthält genehmigte Vorlagen statt einer Schaltfläche und eines Bildes. Siehe [Viber – transaktional](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-viber-transaktional/).

```json
{
	"viber": {
		"sender": "BulkGate",
		"image": "https://example.com/banner.jpg",
		"button": {
			"caption": "Angebot öffnen",
			"url": "https://example.com/angebot"
		}
	}
}
```

## Viber-Objekt

| PARAMETERNAME | WERT | PFLICHT | STANDARDWERT |
|:---------------|:-----------------------------------------------------------------------------------------------------------------------------------------------|:---------:|:-------------:|
| text | Text der Viber-Nachricht. Überschreibt `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 dem der nächste Kanal der Kaskade verwendet wird. Werte unter `60` werden ignoriert und durch den Standardwert ersetzt | Nein | `300` |
| button | Struktur, die in der Nachricht eine Schaltfläche erzeugt, siehe [Button-Objekt](#button-objekt). Ohne sie hat die Nachricht keine Schaltfläche | Nein | `null` |
| image | URL eines Bildes, das in der Nachricht angezeigt wird | Nein | `null` |

### Button-Objekt

| PARAMETERNAME | WERT | PFLICHT | STANDARDWERT |
|:---------------|:------------|:---------:|:-------------:|
| caption | Text der Schaltfläche | Nein | `OK` |
| url | URL-Adresse | Nein | `#` |

Die Standardwerte gelten nur, wenn das Objekt `button` selbst vorhanden ist – `"button": {}` erzeugt eine Schaltfläche mit der Beschriftung `OK`, die auf `#` verweist.

## Beispiel einer vollständigen Anfrage

Viber mit Bild und Schaltfläche, SMS als Ausweichkanal. Der SMS-Teil hat weder Bild noch Schaltfläche und greift daher auf `text` der obersten Ebene zurück.

```http-json
POST /api/2.0/advanced/promotional HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
	"application_id": 451,
	"application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
	"number": ["420777777777", "420777777778"],
	"text": "Spring sale starts today, up to 50 % off.",
	"channel": {
		"viber": {
			"sender": "BulkGate",
			"image": "https://example.com/spring-sale.jpg",
			"button": {
				"caption": "Open the offer",
				"url": "https://example.com/spring-sale"
			}
		},
		"sms": {
			"sender_id": "gText",
			"sender_id_value": "BulkGate"
		}
	}
}
```

Die Antwort ist für alle Kanäle gleich – siehe [Werbe-SMS (Advanced)](https://www.bulkgate.com/de/dokumentation/advanced-api/advanced-promotional/2.0/).