# Line

[Line](https://line.me/en/) —  приложение для смартфонов и ПК, средство моментального обмена сообщениями (текст, аудио- и видео-звонки, передача файлов) корейского происхождения.

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

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

1. Настройте канал на стороне Line и получите токен, используя инструкцию: [https://developers.line.biz/en/docs/messaging-api/building-bot/#before-you-begin](https://developers.line.biz/en/docs/messaging-api/building-bot/#before-you-begin)

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

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

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-0Av50q8aet/ff64dac2ae4fe6d1f154db75259fbce890bf386d57ff2157db4e46ba24dfce0b6bc4bd23513e868f1c33e1a273749139330546a0dd88abfd3cffee5c39671d26e77995251956db64e0ded19207ee7b7606b0a1f986112e4b77c22c2ab736357cc4093a08)
4. Выберите Line.
5. Откроется панель создания Канал Проекта.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-2UvkvCwTTl/a19f0bc68faa6ba11808807a31636352177645a6dc82487bb56abdc6a87e7fe52292b803b1d599835ea5635e85fd15df3d1a151764cfbd4eeb078c43977a9d3a404b65ac6fd4f13f369c581235434dac2383eaaed1aba52cbdd67967217e89fbb7f3045f)
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-LYp8ImoE0o/f2f63b16c12a34b7e0904f604518f5a64ca68bbcf93fba65670bb8a8a7eba7917ee587518949afb8ca4128c5153b53415f8fe1155d9e2491925126fc792f7af7f8ee549129bdbc9632dfc8498d99c61c5b9c51bb9bc6c9e36f56e627e65c88733935783f)
7. Вставьте скопированный ранее токен в поле Line channel token.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-j5EoMl0w0O/76dff4fcfae46df06667227f6b237d9ffd0d7f9f6d20f90aaa56e418e1ff247ac401b0b7e5f86de4046f488e158b4e20601c87ab2d9bb91b99392865a2e3ff65c60bbc6405855505874cf968c8a0666ba32bfcc0414ea9d52e84ffcc094cfc0ddf5660d0)
8. Вставьте вебхук из поля Chatbot webhook URL в настройках канала в Line.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-cccf-nNaB7/dadb1a3e26629b76d57b337aa8a8e8d8f7b614fac966bfc5efed3726f752299b1f8ec65087eefc37a7c9ef330cd3baab3c81eeb8735086de4b52627032dba6d62f271783eee1963ed0249b8d36dc9c734e089edfd06e21afc832d2de09b7f8068df266cc)
9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Zm3ukRtzSn/bb681754847e079e8d248ab3e4c8c3a373390b9b735033296b605ec73acfcf81e06e12d34e17f50dcc64d330ebda90e2a57d590fdec4459b486ef9bbea64227c1c23b8eb0b26b8f5f7acb6e1dd7412c970319f6b571045320062d181b8bb574740a9aaad)
10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-jHEgD1y60Y/03dc08c4989163f36ad22de985641db038ca9e7c6a5ddc7b4055d18fc69cd1d5fb6e30b5012e462206245dc2fa635b45d4bed67de53094e1132f6b60f03b9188c504ccd9b41f8569c91d1b623cc553d29911f0496406c27b5264a31a840fd8dd153c8ca4)
11.
    1. Канал Проекта будет сохранен и активирован, если:
    2.
       1. Агент обучен;
       2. токен в поле Line channel token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.
    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-DUiLGWqnrl/400aeee2776dd4f67c9f461ffd6c33934f854aa77ffeb5581310e18bb108fc8bbe366bd105b95a9b2512440f5463359d6e1af81afe776389306e984db4018610f5405305c3036edec8e2291abf3c2a5891764812c37e1c59c0a7fdfa366c204511905f4a)

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

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

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-H1JeHu2pCa/2059e7a15ecb18c35bfac2062f40c575ab2efdf7b5dfe32a1d9ff08e91203d18860b60c788c067c656a39ad2288244fd86c8fb7c381ce8c7734f589c97d7ce8ba7efa304965fcc6ae2241bdd30840060776b6d4181abefca42a0f8aed95839fc6a7d9b54)
3.
   1. Изменения будут применены, если:
   2.
      1. Агент обучен;
      2. токен в поле Line channel token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения не будут применены, если одно или больше условий не будут выполнены.
4. Чтобы деактивировать  Канал Проекта, нажмите кнопку DEACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-utzbFwT89c/b2d6aba0a36627b2eeab77f39503b74c083a12b3be1e8190fe600c5ee3b7443424f96f1eef00b62695f9819e32c7096fd8f4e2f28fcc88fd361baaa0fefb340b6a88d23c7f1bfdc5f0216055350091322d85210f6e8d9273fbe1cbf1eb18dd8f766fc560)
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QM9NfqsNm9/7a9939d4af92f4d69b2c670bfd8be53e60380f8f5f396c4299273bf881fde283407051eb64a4856343b3c17c4e190ecb0ea0cc020e425f849b43329163e8a773b4d39793bae7d5d5d0114e5aa5b715b31a751e6b90e77c1de3176b2cf7b6c48bbd54fe62)
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-FGqspN-xYs/a1ad8531e887f0a2019ad67cfc6893514edf257c261daebd0b7a75a3a27a5ee36de24ff3b95e5bc1d5418fb6a012d772457462c7ffe65a2bcfebfc2f8fd670295fee184b581022b6bbd46362150959d843026b161fc1fe4537379d6778a1e1a2249e08a3)
7.
   1. Изменения будут применены и Канал Проекта будет активирован, если:
   2.
      1. Агент обучен;
      2. токен в поле Line channel token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-XVUcFPnvNq/c6439436bf2f733f8fc8b2bc9b1c30c3569037654c345fca857b7afee5ffb54c33fef726f9883859b9e6ad59d172248742b7e87c64e287c9387b0fbc882de48106cbbe75ed35e843a432eb6f0cfb57ac10156d8f08a83859e8389b2b5983e4c80cd129d7)
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-HWua0QTdY6/f42d224cef6ea9a5957e83e22adff329cb2a271d1495443215564a334605171179aa92664234d645f9a3e66386718fe1ec792c3860fab0c5cd9beda96f07c59962e680fe53ecd36ac57cf76f9fb6149a2c020a19ede3feab28a5d84425dd82e1537ed291)

## Общение

Чтобы начать Общение с Ботом, его необходимо добавить в друзья.Бота возможно добавлять в группы и комнаты.

| Сообщение                           | Конечный канал | Client message                   | Описание |
| ----------------------------------- | -------------- | -------------------------------- | -------- |
| Пользователь добавил бота в друзья  | Line messenger | line\_user\_followed: used\_id   |          |
| Пользователь удалил бота из друзей  | Line messenger | line\_user\_unfollowed: used\_id |          |
| Бота добавили в группу              | Line messenger | line\_group\_joined: used\_id    |          |
| Бота удалили из группы              | Line messenger | line\_group\_left: used\_id      |          |
| Бота добавили в комнату             | Line messenger | line\_room\_joined: used\_id     |          |
| Бота удалили из комнаты             | Line messenger | line\_room\_left: used\_id       |          |
| Пользователь присоединился к группе | Line messenger | line\_member\_joined: used\_id   |          |
| Пользователь вышел из группы        | Line messenger | line\_member\_left: used\_id     |          |

О том, что такое сервисные сообщения и как активировать их передачу из Конечный канал: Принцип вывода Агента в различные каналы

| Переменная                  | Конечный канал | Переменная в запросе из канала  | Примечания |
| --------------------------- | -------------- | ------------------------------- | ---------- |
| channel\_visitor\_id        | Line messenger | user\_id                        |            |
| channel\_conversation\_id   | Line messenger | user\_id / room\_id / group\_id |            |
| channel\_visitor\_firstname | Line messenger | Нет                             |            |
| channel\_visitor\_lastname  | Line messenger | Нет                             |            |
| channel\_visitor\_account   | Line messenger | Нет                             |            |
| channel\_visitor\_phone     | Line messenger | Нет                             |            |
| channel\_visitor\_email     | Line messenger | Нет                             |            |
| channel\_visitor\_source    | Line messenger | Нет                             |            |
| channel\_visitor\_auth      | Line messenger | Нет                             |            |
| channel\_visitor\_location  | Line messenger | Нет                             |            |
| channel\_message\_id        | Line messenger | Нет                             |            |
| channel\_message\_recipient | Line messenger | Нет                             |            |
| channel\_reply\_to          | Line messenger | Нет                             |            |

| Функционал общения                                                             | Конечный канал | Доступность в канале | Примечания                                            |
| ------------------------------------------------------------------------------ | -------------- | -------------------- | ----------------------------------------------------- |
| channel\_chat\_id                                                              | Line messenger | Да                   | Формат: chat\_type::{user\_id / room\_id / group\_id} |
| Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | Line messenger | Да                   |                                                       |
| Кнопки                                                                         | Line messenger | Да                   |                                                       |
| Перевод на оператора                                                           | Line messenger | Нет                  |                                                       |
| Передача файлов в виде файлов от Агента (Attachment)                           | Line messenger | Нет                  |                                                       |
| Передача файлов в виде ссылок от Агента (Attachment)                           | Line messenger | Да                   |                                                       |
| Получение файла от Собеседника в сценарий                                      | Line messenger | Да                   | Формат: тип файла\|id файла\|ссылка на файл           |
| Получение геолокации от собеседника в сценарии                                 | Line messenger | Да                   | Формат: location: координаты\|адрес                   |
| Доставка сообщений более 1000 символов от Агента до Собеседника                | Line messenger | Да                   |                                                       |
| Получить ссылку на источник лида                                               | Line messenger | Нет                  |                                                       |
| Использование маркдауна                                                        | Line messenger | Нет                  |                                                       |
| Рассылки с помощью Notification                                                | Line messenger | Нет                  |                                                       |

\
