# Line

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

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

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

1. Настройте канал на стороне Line и получите токен, используя инструкцию: <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 | Нет                  |                                                       |

<br>


---

# 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://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-messendzhery/line.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.