Viber-kanalobjektet for [Advanced markedsføring](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-promotional/2.0/). Det legges i objektet `channel` under nøkkelen `viber` - se [Kaskade](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-kaskade/).

> [!IMPORTANT]
> Transaksjonsmeldinger bruker et **annet** Viber-objekt under samme nøkkel - det inneholder godkjente maler i stedet for knapp og bilde. Se [Viber – transaksjoner](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-viber-transaksjoner/).

```json
{
	"viber": {
		"sender": "BulkGate",
		"image": "https://example.com/banner.jpg",
		"button": {
			"caption": "Åpne tilbudet",
			"url": "https://example.com/tilbud"
		}
	}
}
```

## Viber-objekt

| PARAMETERNAVN | VERDI                                                                                                                                        | OBLIGATORISK | STANDARDVERDI |
|:---------------|:-----------------------------------------------------------------------------------------------------------------------------------------------|:---------:|:-------------:|
| text           | Teksten i Viber-meldingen. Overstyrer `text` på øverste nivå, se [Hvilken tekst som brukes](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-kaskade/)                        |    Nei    |    `null`     |
| sender         | Registrert Viber-avsender. Må registreres først. Kontakt brukerstøtten for registrering [her](https://www.bulkgate.com/no/kontakt-oss/)                          |  **Ja**   |       -       |
| expiration     | Tidsgrense i sekunder, deretter brukes neste kanal i kaskaden. Verdier under `60` ignoreres og erstattes med standardverdien                  |    Nei    |     `300`     |
| button         | Struktur som lager en knapp i meldingen, se [Knappobjekt](#knappobjekt). Uten den har meldingen ingen knapp                                   |    Nei    |    `null`     |
| image          | URL til et bilde som vises i meldingen                                                                                                       |    Nei    |    `null`     |

### Knappobjekt

| PARAMETERNAVN | VERDI       | OBLIGATORISK | STANDARDVERDI |
|:---------------|:------------|:---------:|:-------------:|
| caption        | Knappetekst |    Nei    |     `OK`      |
| url            | URL-adresse |    Nei    |      `#`      |

Standardverdiene gjelder bare når selve objektet `button` er med - `"button": {}` gir en knapp med teksten `OK` som peker til `#`.

## Eksempel på fullstendig forespørsel

Viber med bilde og knapp, SMS som reserve. SMS-delen har verken bilde eller knapp, så den bruker `text` på øverste nivå.

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

Svaret er det samme for alle kanaler - se [Advanced markedsføring](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-promotional/2.0/).