Objekt Viber kanálu pro [Advanced promotional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-promotional/2.0/). Vkládá se do objektu `channel` pod klíč `viber` - viz [Kaskáda](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-kaskada/).

> [!IMPORTANT]
> Transakční zprávy používají pod stejným klíčem **jiný** Viber objekt - místo tlačítka a obrázku nese schválené šablony. Viz [Viber – transakční](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-viber-transakcni/).

```json
{
	"viber": {
		"sender": "BulkGate",
		"image": "https://example.com/banner.jpg",
		"button": {
			"caption": "Otevřít nabídku",
			"url": "https://example.com/nabidka"
		}
	}
}
```

## 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](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-kaskada/)                         |   Ne    |     `null`      |
| sender          | Registrovaný Viber odesílatel. Musí být nejdříve registrován. Pro registraci kontaktujte podporu [zde](https://www.bulkgate.com/cs/kontakt/)                  | **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`      |
| button          | Struktura, která ve zprávě vytvoří tlačítko, viz [Objekt tlačítka](#objekt-tlacitka). Bez ní zpráva tlačítko nemá                              |   Ne    |     `null`      |
| image           | URL adresa obrázku, který se zobrazí ve zprávě                                                                                               |   Ne    |     `null`      |

### Objekt tlačítka

| NÁZEV PARAMETRU | HODNOTA       | POVINNÝ | VÝCHOZÍ HODNOTA |
|:----------------|:--------------|:-------:|:---------------:|
| caption         | Text tlačítka |   Ne    |      `OK`       |
| url             | URL adresa    |   Ne    |       `#`       |

Výchozí hodnoty platí jen tehdy, když je objekt `button` přítomen - `"button": {}` vytvoří tlačítko s popiskem `OK` odkazující na `#`.

## Příklad kompletního requestu

Viber s obrázkem a tlačítkem, SMS jako záchrana. SMS větev obrázek ani tlačítko nemá, takže spadne na text na nejvyšší úrovni.

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

Odpověď je pro všechny kanály stejná - viz [Advanced promotional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-promotional/2.0/).