> For the complete documentation index, see [llms.txt](https://legacy-docs.seven.tech/v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://legacy-docs.seven.tech/v1/http/viber.md).

# Отправка Viber-сообщений

Viber — клиентское приложение-мессенджер, которое позволяет отправлять и принимать сообщения, обмениваться медиафайлами, совершать видео и голосовые VoIP звонки через интернет.

## Типы Viber-сообщений

В отличие от простых СМС, где тело сообщения включает в себя только текст, пользователю мессенджера Viber возможно отправлять сообщения содержащие:

* Только текст;
* Изображение;
* Текст+кнопка;
* Текст+изображение+кнопка.

| Текст                                                                                                                                                                                                                                                                 | Изображение                                                                                                                                                                                                                                                            | Текст+кнопка                                                                                                                                                                                                                                                                | Текст+кнопка+изображение                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://1640188682-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMTnaPZpFacnqLV5A5H%2F-Lmt4R8bjEC1G0DWbiH_%2F-LmtMgG5a4nXGgyFcfEb%2Fviber_text.png?alt=media&amp;token=d9a41e4f-e809-4aea-9d22-713176dd1cf6" alt="" data-size="original"> | <img src="https://1640188682-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMTnaPZpFacnqLV5A5H%2F-Lmt4R8bjEC1G0DWbiH_%2F-LmtNAnLS2qmrxA0sYZu%2Fviber_image.png?alt=media&amp;token=eda4c8be-c781-4fdd-adda-79dd9ebb0c28" alt="" data-size="original"> | <img src="https://1640188682-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMTnaPZpFacnqLV5A5H%2F-Lmt4R8bjEC1G0DWbiH_%2F-LmtNXzlb1_RtCvEC1ng%2Fviber_text%2Bbut.png?alt=media&amp;token=5461a3e6-a8fe-4bf8-a897-cf09175fd970" alt="" data-size="original"> | <img src="https://1640188682-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMTnaPZpFacnqLV5A5H%2F-Lmt4R8bjEC1G0DWbiH_%2F-LmtM3LABBSgTeOXD4cq%2Fviber_full.png?alt=media&amp;token=dec95bee-bbfd-4c3c-af7d-a323f349d08e" alt="" data-size="original"> |

## Отправка сообщений

Для отправки сообщений используйте метод [send](https://docs.danytech.ru/v1/http/send#otpravka-soobsheniya) описанный в разделе [отправка сообщений](https://docs.danytech.ru/v1/http/send).

{% hint style="warning" %}
Используйте преднастроенный **serviceId** для отправки Viber. При необходимости уточните информацию у вашего аккаунт-менеджера или напишите в службу поддержки <support@seven.tech>
{% endhint %}

### Дополнительные параметры для Viber

| Параметр   | Тип           | Описание                                                                                                                                                    |
| ---------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| imageId    | varchar(64)   | Уникальный идентификатор загруженного изображения. Подробнее про загрузку изображений [ниже](https://docs.danytech.ru/v1/http/viber#zagruzka-izobrazhenii). |
| buttonText | varchar(20)   | Текст кнопки                                                                                                                                                |
| buttonLink | varchar(2048) | URL-кнопки. При нажатии на кнопку в браузере абонента откроется заданная ссылка.                                                                            |

### Примеры вызова

#### Текст

```
https://api.seven.tech/send?serviceId=65536&pass=passme123&clientId=79031234567&source=ReatailCompany&message=Hello+Viber
```

#### Текст+изображение+кнопка

```
https://api.seven.tech/send?serviceId=65536&pass=passme123&clientId=79031234567&source=ReatailCompany&message=Hello+Viber&imageId=A2S1K...B2F&buttonText=Start&buttonLink=https%3A%2F%2Fdanytech.ru
```

## Загрузка изображений

<mark style="color:green;">`POST`</mark> `https://api.seven.tech/viber/imageUpload`

Метод позволяет выполнять загрузку изображений и использовать их в рассылках по каналу Viber.&#x20;

#### Request Body

| Name  | Type   | Description                  |
| ----- | ------ | ---------------------------- |
| login | string | Логин                        |
| pass  | string | Пароль                       |
| image | object | JPG, GIF, PNG не более 10 Мб |

{% tabs %}
{% tab title="200 Успешная загрузка изображения" %}

```
{
"status": 0,
"image_id": "iKt8mVX8G5UIne5sA8IVr4T5UmCFBaXJIhHS0uRwpz3BEWT4SpOaix32KtvbuiI0"
}
```

{% endtab %}

{% tab title="500 При загрузке прозошла ошибка" %}

```
{
"status": 2,
"error": "Unauthorized"
}
```

{% endtab %}
{% endtabs %}

#### Коды ошибок

| Код | Описание                                                                 |
| --- | ------------------------------------------------------------------------ |
| 1   | Неверно сформирован запрос, отсутвуют обязательные параметры             |
| 2   | Неверное сочетание пары login/pass                                       |
| 3   | Загружаемый файл превышает доступстимы размер 10 Мб                      |
| 4   | Загружаемый файл не соответствует допустимым форматам: JPG, GIF или PNG. |