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

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

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

## 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`      |
| template_id         | Kľúč schválenej Viber šablóny s `@` na začiatku (napr. `@potvrdenie-objednavky`), alebo ID šablóny u Viberu. **Keď je vyplnený, správa sa odošle ako šablóna** a `text` sa nepoužije |   Nie   |     `null`      |
| template_language   | Kód jazykovej verzie šablóny. Väčšina jazykov má dvojpísmenový kód (`cs`, `en`), výnimkou sú `fr_FR`, `es_ES`, `pt_BR`, `pt_PT`, `zh-Hans` a `zh-Hant` |   Nie   |      `en`       |
| template_parameters | Asociatívne pole parametrov šablóny, napr.: `{"code": "0451"}`                                                                                     |   Nie   |      `[]`       |

> [!IMPORTANT]
> Na šablónu prepína `template_id`, nie `use_template`. Parameter `use_template` sa kvôli spätnej kompatibilite stále prijíma, ale na tomto endpointe nemá žiadny vplyv.

Každá transakčná Viber správa musí bežať na šablóne, ktorú vopred schválil Viber. Ako šablónu zaregistrovať, popisuje stránka [Registrácia Viber šablón](https://www.bulkgate.com/sk/centrum-pomoci/viber/registracia-viber-sablon/).

> [!WARNING]
> **Bez `template_id` sa správa neúčtuje za transakčnú cenu.** Viber správa odoslaná cez tento endpoint bez šablóny odchádza za **propagačnú** cenu; ako transakčná sa účtuje len správa bežiaca na schválenej šablóne.

## Príklad kompletnej požiadavky

Najprv Viber, SMS ako záchrana. Text na najvyššej úrovni použijú obe vetvy kaskády; `expiration` určuje, ako dlho sa na Viber čaká, kým sa prepne na SMS.

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

Tá istá správa ako schválená šablóna. `template_id` prepne Viber vetvu na šablónu, takže text na najvyššej úrovni dorazí len do SMS vetvy - a Viber vetva sa účtuje za transakčnú cenu.

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

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