# Viber

[Viber](https://www.viber.com/) — приложение-мессенджер, которое позволяет отправлять сообщения, совершать видео- и голосовые VoIP-звонки через интернет.

## Подключение

### 1. Создание бота на стороне Viber

В первую очередь нужно произвести конфигурацию на стороне Viber.

1. Зарегистрируйтесь или авторизуйтесь в [Viber](https://www.viber.com/).
2. Зарегистрируйтесь или авторизуйтесь в [Viber Admin Panel](https://partners.viber.com/account/create-bot-account).
3. Автоматически откроется форма создания аккаунта бота. Заполните все обязательные поля.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-yxJVCBgtTL/f57ac40896e9cd7dfb9c6c70ced93a43c57414c64d9b4e11f1a4ac16f81321ab0cfa49f56f79c5f9c4cbec4ac2c97f9bd1c3515990818cbbeb68da829f0e02dda205597a464f5422fe46bb10a0fb538f07a95ac807aab5532cd48530d3739d8f40aac296)
4. После заполнения полей сохраните изменения, нажав кнопку Create.
5. После создания аккаунта для бота появится всплывающее окно, содержащее токен бота. Скопируйте токен.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zKqXqduJWM/81e249c7b7f5ac808d845f274479670e6efb056626e8f9929b24a723857b7d2bdc50df8cfd1f618d64d16cd15b1fe9cc53d850f1218317592280497be1006ea125385fb381f9c1da46dff0889f4e0afdff181eb46d70935637781f0ba948afd16385d339)

### 2. Конфигурация канала агента в Платформе

Агенту необходимо создать и настроить Канал Проекта с Коннектором “Viber”.

1. Кликните по кнопке настроек Агента.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m_bL4GvN1_/de0e6c51b47058d8e7854370e44e3e29e8d1195855e34484c55e0ba55e6f4cbc2f103ac4ebcc2b78bf606d6b02118303275d07760b64f89e5ea954cd86466379ab9850814435bbe8d5ab7d3e80e7ac68c8a471b3ba0022e97fb3209a771f11a86b6c817e)
2. Нажмите кнопку Add channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KJ7zJqauLN/e76804ae1c32c84507914bcbac89b59e5fa7160e857084643655c65f3192dbec4709a2cd8abae87edc6a858acbd80d17c3296d23c47a2c39eccf56433201a9779ccf4ea2580c347508e5f68b0ee94654585fa349ceadd2e6587a4bdebd6c5d9715835322)
3. Откроется панель выбора Конечный канал.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-JI8Z7FZh37/42f3d7fe2ed09a8183883dbee20d2f8651e67bd34a47405967009c08af488c1461efd1a5bf6a467c8ade43a049abb635863ee82418f6900931e4cbf046f54d8ff26b1f8da9ccfd9d742b043e3dbe7bf8b2fbe2064e645339f8ed1795d73a9094b61930a5)
4. Выберите Viber.
5. Откроется панель создания Канал Проекта.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ZCvg5M6ZKZ/09f8d611467a5ff00733108fc2cfbf34b60f259bdf943dfd9c93fa6c94e57d9f6e0087d1e5b8b53871cf08da35882ddb96ee42b9ccefe4c1772c206fa35ea995c7763528ae442545eb7d5d15f7c524be2352fba35b3d849355b91539407561f8fedf5a2d)
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-nHxAk1I7k9/2f2ac0b334b705397e85630aeb4499b3e0176d2b102c826dbaba22bdd1ae7b3c6aa532f9fb20e11df33a126f97deb23ee1e77c66cf73e12d44367bcf06c1a4d30ed7a59bfc2d731948f46b52300140897bd2fa1b6c26b59e43332a63de88ce22afd6c1f8)
7. Вставьте скопированный ранее токен в поле Viber token.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QP3iqRwdM2/caf448da8a18745ef8336c300ad6282a4a24181b66bac66d518697d50bf86246d88ffdbbc362ced88e722a151e3418ce198f0af2890284ee620eb7782733ef15cb401196cfc50d74efda7893b62daefe8ca20826da550ca7095980c50998f10d7d2ae58a)
8. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-cLSrEZVH2R/3d3125223fba5f93d5293ef3bb721971d0eec9fae74b529b33c6dc7e6dfc799c6820f563a4e7ccfef59d9bd88334159f7375bcb7862486b953f1c4c83155ccaef4f8df355df0c6382765dfca2a1fc7d5a026df0742422602f736168ccddab244e3b04a3c)
9. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-OdWrTcs1u3/edb19afb9fe5c21294e076743da73dbb6202feae78b8f7e6020cc50e9ba73f46b9b1f8b938ddd4d002881c66e6690e84f893c9e3aca9786dada985a03711eacfa424d33a12438b71f451858a047d0c2cba5a1b440aa579c913740906e3ed5ee1607ebe98)
10.
    1. Канал Проекта будет сохранен и активирован, если:
    2.
       1. Агент обучен;
       2. токен в поле Viber token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.
    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
11. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-rhGlmGeiWi/789719f24462b36f66a0c282b04b0230bfc7cf2685af5e83559dae88b8807681dda43b1fbf409c56e40b61622a1b39f6a4171d49b7f929f8be6f8408677ebefbab97a0fcaa077412ad8ca6fd1636ea2feb7c5f1820da98c06e30d1fe3cb65d804892d5bb)

## Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\
![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-P9mxQjozwz/ea27fe00c8fd01ab1fe5b351917cc73e419146a91e14b5487a731bce9368e2a4e25c2ed4eeadb51fbb7fa7538124f595fea4ba1af55cfa8eac45bfbc0793756cf47f54633bbbe70e7616a525e3149321e248e6f22c796fa0fb348456827f76672f761b5a)

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-y524Hu9izQ/70eec5de779fdd5f8e6c40c73ee37c4dceac8e3eb03dace9d489e6007d814392827e472cebb12caeedfc52c7b80a62428f1cff912a2f653172d8a34b41f1b701f1decb726a158c76aaa791843cf6f4bc14cbba869834d8cec005a1247e896bfd8a29d5a9)
3.
   1. Изменения будут применены, если:
   2.
      1. Агент обучен;
      2. токен в поле Viber token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения не будут применены, если одно или больше условий не будут выполнены.
4. Чтобы деактивировать  Канал Проекта, нажмите кнопку DEACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-96qNYvRj-3/65a830bb38730f35f852bdd9ee50a8902401d03aafc73fb5269f9ae0e82caa29b46c79d9e5b369011a3e2d75b02ec5492dd6771d8b576715ffb4e554b1c0f9604d501429779e539c3dea79cdd29ba603a46eca688d38ef959d8c26ea8f878d52344fc644)
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-le2bh4PLL7/27c7fe25b66a841af1947ad56a5caccbdfb94374761bfef05e678f3271028fe849c6edffb70afc31b06aad420e3271b226d1a2cff081fefabee09ebe9f94d67713255c9fbcec85f7a028ce8b89d5b33896383f1a2bdfcf3080dad7bef33420bbf8f71fd7)
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-k5P6yNOinV/2fe39e27a2028bf3a3f77b2c133bfcf99427b98131c2011a7729c7f0ec1826bc60b858e657fb9e1b6b08cab5836aad4cf92042f4c79f4bc697c62fb9354e0d7994938dd8761299db219d3a131370abf5a0827d71662d94d2170a73f28f1e4a7f65a58db5)
7.
   1. Изменения будут применены и Канал Проекта будет активирован, если:
   2.
      1. Агент обучен;
      2. токен в поле Viber token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-jigCzNg4me/f9d35486e8ded8cb9bbe7f849d48941ac7cb421d97105b8058b628f1789419eddd0bc9b539a517bc407173ed93978d266dcd0e2d4b80074bdb1325b1e1cd35bf03247b744ead9522e11c2e800264177d89f53772be015d80dea6eb76fae131ad86abc363)
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--OHwM5AMuy/2d7bc8effb0b5493413642d0a7af41ed6184c7bf4487a4b89d61424685973f76285cadfe381021968c8427d9eca9f048ccf40e79a1c4222b00ca5f5813e87b135c990a3bf43a65d5fa5d7848808b0654c439c2137560bc6e3535902db934a15cdec8f159)

## Общение

| Переменная                  | Конечный канал | Переменная в запросе из канала | Примечания            |
| --------------------------- | -------------- | ------------------------------ | --------------------- |
| channel\_visitor\_id        | Viber          | [sender.id](http://sender.id)  | id пользователя Viber |
| channel\_conversation\_id   | Viber          | [sender.id](http://sender.id)  | id пользователя Viber |
| channel\_visitor\_firstname | Viber          |                                |                       |
| channel\_visitor\_lastname  | Viber          |                                |                       |
| channel\_visitor\_account   | Viber          |                                |                       |
| channel\_visitor\_phone     | Viber          |                                |                       |
| channel\_visitor\_email     | Viber          |                                |                       |
| channel\_visitor\_source    | Viber          |                                |                       |
| channel\_visitor\_auth      | Viber          |                                |                       |
| channel\_visitor\_location  | Viber          |                                |                       |
| channel\_message\_id        | Viber          | message\_token                 |                       |
| channel\_message\_recipient | Viber          |                                |                       |

<table><thead><tr><th>Функционал общения</th><th>Конечный канал</th><th>Доступность в канале</th><th>Примечания</th></tr></thead><tbody><tr><td>channel_chat_id</td><td>Viber</td><td>Нет</td><td></td></tr><tr><td>Сообщения дойдут до собеседника, если агент напишет первый в существующем чате</td><td>Viber</td><td>Да</td><td></td></tr><tr><td>Кнопки</td><td>Viber</td><td>Да</td><td>Нажатие на кнопку приходит как текст лейбла кнопки</td></tr><tr><td>Перевод на оператора</td><td>Viber</td><td>Нет</td><td>В viber нет такого функционала</td></tr><tr><td>Передача файлов в виде файлов от Агента (Attachment)</td><td>Viber</td><td>Нет</td><td></td></tr><tr><td>Передача файлов в виде ссылок от Агента (Attachment)</td><td>Viber</td><td>Да</td><td></td></tr><tr><td>Получение файла от Собеседника в сценарий</td><td>Viber</td><td>Да</td><td><p>Формат:</p><pre><code>тип|тип|id файла|ссылка на файл
</code></pre></td></tr><tr><td>Получение геолокации от собеседника в сценарии</td><td>Viber</td><td>Да</td><td><p>Формат:</p><pre><code>location:53.952693|27.781444
</code></pre></td></tr><tr><td>Доставка сообщений более 1000 символов от Агента до Собеседника</td><td>Viber</td><td>Да</td><td></td></tr><tr><td>Получить ссылку на источник лида</td><td>Viber</td><td>Нет</td><td></td></tr><tr><td>Использование маркдауна</td><td>Viber</td><td>Нет</td><td></td></tr><tr><td>Рассылки с помощью Notification</td><td>Viber</td><td>Нет</td><td></td></tr></tbody></table>

\
