Objekt Viber kanálu pro [Advanced transactional](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-transactional/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]
> Promo zprávy používají pod stejným klíčem **jiný** Viber objekt - místo šablon nese tlačítko a obrázek. Viz [Viber – promo](https://www.bulkgate.com/cs/dokumentace/advanced-api/advanced-viber-promo/).

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

## 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`      |
| template_id         | Klíč schválené Viber šablony s `@` na začátku (např. `@potvrzeni-objednavky`), nebo ID šablony u Viberu. **Když je vyplněné, odešle se zpráva jako šablona** a `text` se nepoužije |   Ne    |     `null`      |
| template_language   | Kód jazykové verze šablony. Většina jazyků má dvoupísmenný kód (`cs`, `en`), výjimkou jsou `fr_FR`, `es_ES`, `pt_BR`, `pt_PT`, `zh-Hans` a `zh-Hant` |   Ne    |      `en`       |
| template_parameters | Asociativní pole parametrů šablony, např.: `{"code": "0451"}`                                                                                      |   Ne    |      `[]`       |

> [!IMPORTANT]
> Na šablonu přepíná `template_id`, ne `use_template`. Parametr `use_template` se kvůli zpětné kompatibilitě stále přijímá, ale na tomto endpointu nemá žádný vliv.

Každá transakční Viber zpráva musí běžet na šabloně, kterou předem schválil Viber. Jak šablonu zaregistrovat, popisuje stránka [Registrace Viber šablon](https://www.bulkgate.com/cs/centrum-napovedy/viber/registrace-viber-sablon/).

> [!WARNING]
> **Bez `template_id` se zpráva neúčtuje za transakční cenu.** Viber zpráva odeslaná přes tento endpoint bez šablony odchází za **promoční** cenu; jako transakční se účtuje jen zpráva běžící na schválené šabloně.

## Příklad kompletního requestu

Nejdřív Viber, SMS jako záchrana. Text na nejvyšší úrovni použijí obě větve kaskády; `expiration` říká, jak dlouho se na Viber čeká, než se přepne 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"
		}
	}
}
```

Tatáž zpráva jako schválená šablona. `template_id` přepne Viber větev na šablonu, takže text na nejvyšší úrovni dorazí jen do SMS větve - a Viber větev se úč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"
		}
	}
}
```

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