Objekt Viber kanála pre [Advanced promotional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-promotional/2.0/). Vkladá sa do objektu `channel` pod kľúč `viber` - pozrite [Kaskáda](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-kaskada/).

> [!IMPORTANT]
> Transakčné správy používajú pod rovnakým kľúčom **iný** Viber objekt - namiesto tlačidla a obrázka nesie schválené šablóny. Pozrite [Viber – transakčný](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-viber-transakcne/).

```json
{
	"viber": {
		"sender": "BulkGate",
		"image": "https://example.com/banner.jpg",
		"button": {
			"caption": "Otvoriť ponuku",
			"url": "https://example.com/ponuka"
		}
	}
}
```

## Viber objekt

| NÁZOV PARAMETRA | HODNOTA                                                                                                                                      | POVINNÝ | PREDVOLENÁ HODNOTA |
|:----------------|:-----------------------------------------------------------------------------------------------------------------------------------------------|:-------:|:---------------:|
| text            | Text Viber správy. Má prednosť pred textom na najvyššej úrovni, pozrite [Ktorý text sa použije](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-kaskada/)                     |   Nie   |     `null`      |
| sender          | Registrovaný Viber odosielateľ. Musí byť najprv zaregistrovaný. Pre registráciu kontaktujte podporu [tu](https://www.bulkgate.com/sk/kontakt/)                |  **Áno** |        -        |
| expiration      | Časový limit v sekundách, po ktorého uplynutí sa použije ďalší kanál v kaskáde. Hodnoty nižšie ako `60` sa ignorujú a nahradia sa predvolenou hodnotou |   Nie   |      `300`      |
| button          | Štruktúra, ktorá v správe vytvorí tlačidlo, pozrite [Objekt tlačidla](#objekt-tlacidla). Bez nej správa tlačidlo nemá                          |   Nie   |     `null`      |
| image           | URL adresa obrázka, ktorý sa zobrazí v správe                                                                                                |   Nie   |     `null`      |

### Objekt tlačidla

| NÁZOV PARAMETRA | HODNOTA        | POVINNÝ | PREDVOLENÁ HODNOTA |
|:----------------|:---------------|:-------:|:---------------:|
| caption         | Text tlačidla  |   Nie   |      `OK`       |
| url             | URL adresa     |   Nie   |       `#`       |

Predvolené hodnoty platia len vtedy, keď je objekt `button` prítomný - `"button": {}` vytvorí tlačidlo s popisom `OK` odkazujúce na `#`.

## Príklad kompletnej požiadavky

Viber s obrázkom a tlačidlom, SMS ako záchrana. SMS vetva obrázok ani tlačidlo nemá, takže použije text na najvyššej ú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"
		}
	}
}
```

Odpoveď je pre všetky kanály rovnaká - pozrite [Advanced promotional](https://www.bulkgate.com/sk/dokumentacia/advanced-api/advanced-promotional/2.0/).