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

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

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

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

| Текст                                                               | Изображение                                                         | Текст+кнопка                                                        | Текст+кнопка+изображение                                            |
| ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| <img src="/files/-LmtMgG5a4nXGgyFcfEb" alt="" data-size="original"> | <img src="/files/-LmtNAnLS2qmrxA0sYZu" alt="" data-size="original"> | <img src="/files/-LmtNXzlb1_RtCvEC1ng" alt="" data-size="original"> | <img src="/files/-LmtM3LABBSgTeOXD4cq" 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. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://legacy-docs.seven.tech/v1/http/viber.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
