# Livetex

[Livetex](https://livetex.ru/) – одна из омниканальных платформ для общения с клиентами в текстовых каналах. Используя омниканальную платформу LiveTex, можно разместить Бота в одном или нескольких каналах общения.  Ознакомиться с пользовательской документацией вы можете по [этой ссылке](https://support.livetex.ru/hc/ru).

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

### 1. Конфигурация бота на стороне Livetex

В первую очередь нужно подключить каналы общения к Livetex.

1. Авторизуйтесь в Livetex как администратор.
2. Перейдите в раздел Настройки → Точки-контакта.
3. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-fzQINu3Hv7/948c9d55ef10bc503409c4538a8bc56b8a259ed18ee15b7d165ee0cd5886ab1c74c0b478ba560c4d8919a4b091efb8ef2b5d5b521edbf831c951745d82ad6c543c61afe12dab99ef1767977802a18b3a46c758e0a8a5689f62627d706616bdf40798944d)
4. Нажмите “добавить” и создайте нужную точку контакта, выбрав канал из списка.
5. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-0o-j6dZB5M/60cae3793f264b67b6f238e59addb3aa44f4f91e7e3a0755f3bc34eab38d7c52762fb60a88cd52eec3b64310613c25ef559347d78a8911bbc02365cdaafe0e180c63a45363dc2433a0b27f9e7669dfc6d636466e49c07efee2978620ba00cf92e0d23d31)
6. > Важно: Для каждого канала есть инструкция по настройке. Протестированы и работают точки контакта: сайт, Телеграм.
7. > Подключение бота-оператора к мессенджерам и соцсетям, подключенным в Livetex, происходит через техподдержку Livetex (см. Глава 2 п. 4).

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

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

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-FEAahXLNrv/646995a11fa5af09c25858ebc7554e9ed7c317bbf19fb995756df72afdd76fa71b54a1f39b9305f1a9780abba26e73056060cbc3521140e5e12c5097f50564b98d0a8e06681c88bedac1ee32d3d44b913de1b6994d9f9b90592c2fe549f0135b11eff0d1)
4. Выберите Livetex.
5. Откроется панель создания Канал Проекта.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-UJ1k7bc068/2598b658a47ed089da0963b773befde0b14bc0293de958deccf5e0008e4a5b1785052df5d3b43c47d8b0b6af1cf19f565f7e56ec7013b0aee52c578f87da31d31e0ea69111e17fd2c70b96442d4003d4263ca103131874148a099a737b208e007ffcab66)
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-hpsS7W6x3k/36371ddd2aacb8680301c49f90e0917a07ccb1080f5e1462e910c0c8c94e0d4bde69f4d109d05f5f473a57ca2584840b72e3974e33889b2899b52a4119e1802fc1ad769ae5df1129f0b837e3f078948aea403e7ef9d1663458dd7cf089cd7a3371a958a5)
7. Для подключения Канал Проекта необходимо установить настройки со стороны LiveTex. Для этого нужно предоставить поддержке LiveTex:
8.
   1. вебхук из поля Chatbot webhook URL;
   2. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-4WjFsWj-W9/92e1cedff88fb84b1dd45fc732fb6686d01007a71f9a7f37265e3038a93bdce013af2c0f84ba12e1d5872f09b0c89781d587da74eadf5c2ac951f89de2a59e9662d2efe6260466b02e7c5726b04ed96eee4ceca6e55052d3586e8dc6790296c28ecb218e)\

   3. > Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно.
   4. ID точки контакта и ID аккаунта из личного кабинета LiveTex;\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-lvbUvpQVKE/f40d6293ece31b154e8b0a618fe413180bdd50b15dfde4be4924062ef8a481fe90971f35f9feb20b5a6de9140af69e9ed1eb2d63ff7a85cae0f0d3602b308a32d4df2dce86bf9d0906352cbbf6691c191b5e61f2df9a8208caac8eb11af961f90a2eacf8)
   5. Также нужно запросить у LiveTex токен для подключения Канал Проекта. После того, как LiveTex предоставят токен для подключения, установите токен в поле LiveTex token.
   6. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7CHciG965W/bb648a6408f609872657d18bb6b8db7d2032ee6bd36ffbaf4a0f062fed87871971538b749e42bf7873621efa441d7502bf16da756aa86500be8cb94174ac8c4a7fa5ccd1e770fee5c0984cf76ae775d408fad4bbe3860a8bb2a3dc1adf496ca0fe97a47d)
9. > Важно: Для подключения обращаться в поддержку LiveTex.
10. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-HKwfzInOjd/090ff5cbf68448fa89d02257cddfc5c49b8a82781ac4f512e0061c7d90898901872ef104e9c801d5a0694fc2ed4d30e946c9a3de85bfae1312b461cef6878e7b9ca1862e2e651e8bcc95695539d3ff32ea8dc244d137e1ec5079802bb6397e04ad8e4413)
11. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-pAY6C32ZwW/c3176a140be1082e298731f0cb110275d013e505e12d584b1480654c815e66a4612aaaab0d87c8fd93853ae1acfbf8e97f112e649f50fc6a2bce1b77e2e49ec3918b1cbdfcfe54163160334e59d7f41b79c6ef2877b3e4d1825e4d6966d8e1f4eeeda3be)
12.
    1. Канал Проекта будет сохранен и активирован, если:
    2.
       1. Агент обучен;
       2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.
    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-SExTbpUn9N/0ae6b5edd107719f20b141a6e1c34b395020e6c8330679a81c279677e69c33d486317bd91ae2982ce25b23dcaf75a4a34c4f52ef4aecff7b7287a6039978478ff3d9822356aa2a68bb7bda20fbfb06d63882d7cc0719f90ce7a4e5bec27bdbfc24edb708)

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

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

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-J77pEVRqT5/bcae06378660d132dbb0a3cab8cea44bc301a31b6b98036c051f9a9a548b2f0c39804e9e89134ada2c16c6ec2ff930359c8a2a2d905c5ab528761bacc367563446d4f68cfced0265b54cb2e18ccbb05aa4c181b33609051ca21c51610b8ad1e87343ce64)
3.
   1. Изменения будут применены, если:
   2.
      1. Агент обучен;
      2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения не будут применены, если одно или больше условий не будут выполнены.
4. Чтобы деактивировать  Канал Проекта, нажмите кнопку DEACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-91TpbiwY6f/3e55b953e7f461cc8f2fe3628493527a48f624d8142a0ea0e0f05d715aee1617f69380ed573c002e3e11888f22d8b545ed07b250bbc31d1994b65d33817677dcfd8649857d6857b9d6c28a28415d956b6e1a08ea976b6a5cdb819ff6f5d7e51cc246200e)
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-CpRFTyVcb1/b8a97eb33fcce2b5e9cfca9a995d16f3735eba62fba872e7f770c535bb732ac85145357e3ebb95b442268dd89211a502e959f86afe18885fc38bf00dfed1b8d5fc373d2633cf87504d192d8bd2ae14d1fbdc59b47d645c4624681401e9f20ce4fd35cc54)
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ExwKGqLQia/6ff497d54f43f5d27133a4f7039e2d7488fc1584b04e4b0ecbd3df61d0b8593560118e9e9f28f7706942909ce791db89ebfc859fee4ffb2877609871cb8cf7d099fdb2f5885aaacf23fcda2b862fe93717798f54c9d27e74b76519653c3e9b29fbfa3bdb)
7.
   1. Изменения будут применены и Канал Проекта будет активирован, если:
   2.
      1. Агент обучен;
      2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-R0ichgZW29/262142bed3e77da43eeff89ae5b31f0662b24a89325bb3e81674a439814c29b3992d70ed5241a1db6158a0df33b831264ccfcf3df3789835229a6b7079c850f66ebe21a598f4c749204a9bfaacd9a8e60a97cad1f96075ba99ffee58a56302cfe5b9e329)
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-EGii6qGRlF/fede14e0b9ab051796273dc3cd127624a48a8308032561123f51f532549b9f99bf389ddf3072ac1a923fd9a9dd01bbe391c91c0ef9a5b967279e6cdad52ac63c120115b69c5037edfa5ed593d5d7ff50b42c267b9b5fa15a2025355d99f7091fc7dc6933)

## Дополнительная конфигурация в случае использования виджета LiveTex

В виджете LiveTex боту можно настроить: аватар, имя, описание, приветственное сообщение. Приветственное сообщение может содержать кнопки.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-l0h1QukRnR/9e41a968115adc9ae5697fb9e3b3afd00ecb690c4b9aab6e5a783eb7858f61ef02b8ec4b55d275cc52acc05eb1f6e8cf56837856c003f02c29716ff492a0aafebf7d96953ee1c642eb6f9c9d72a29d5b4c3a215a7a5d5940aec5b5c83f3d49d5c0e036fe)Данные нужно передавать в формате json согласно [спецификации LiveTex](https://drive.google.com/file/d/1SJ_7-qPJBLK7s3bQVUMN9BtE8cKa_u_r/view), для установки этой настройки нужно обратиться в техническую поддержу [chatme.ai](http://chatme.ai).

## Общение

Взаимодействие с Livetex происходит в асинхронном режиме, по [LiveTex-Bot-Api](https://drive.google.com/file/d/1SJ_7-qPJBLK7s3bQVUMN9BtE8cKa_u_r/view).Но, хотя методы общения с данным Конечный канал асинхронные, при использовании виджета LiveTex для сайта Агент должен передать настройки для виджета (см.Дополнительная конфигурация в случае использования виджета LiveTex) в синхронном режиме  — в ответе на первый HTTP запрос от LiveTex к Канал Проекта).

> Важно: LiveTex не может гарантировать порядок доставки сообщений до Собеседника: если интервал их поступления от Агента очень маленький, чтобы устранить данное негативное поведение, на Коннекторе к Edna введена задержка в 0,5 секунд между отправкой сообщений. &#x20;

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

| Функционал общения                                                             | Конечный канал | Доступность в канале | Примечания                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------ | -------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| channel\_chat\_id                                                              | Livetex        | Да                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | Livetex        | Да                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Кнопки                                                                         | Livetex        | Да                   | Возможно форматировать местоположение и вид при помощи html тегов, они отправляются в слоте button и обрабатываются на стороне Livetex                                                                                                                                                                                                                                                                                                            |
| Перевод на оператора                                                           | Livetex        | Да                   | Работает в виджете на сайте LiveTex, в остальных каналах не известно.Для перевода диалога на оператора используется слот Change Chat Mode.                                                                                                                                                                                                                                                                                                        |
| Передача файлов в виде файлов от Агента (Attachment)                           | Livetex        | Да                   | В виджете на сайте высылает файлы двумя сообщениями, одно сообщение отправляет ссылку на файл, второе файл для скачивания, оба открываются в браузере.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VSdZKyvQae/2cdd70a52c65452cb83fc30d4c2d09658b281ef275510a5123b7b3080bd2bae91cbd15295cae0a99cf18b8cfc2d91e095c0383fe9bd040f9d197f33b5e022fb51a5858164e3e9fb4f395cc98153cdc6cfe63741cdee2ff1c2a360e5cc6b2d918b8525d26)            |
| Передача файлов в виде ссылок от Агента (Attachment)                           | Livetex        | Да                   | Важно: В виджете на сайте файлы отображаются двумя сообщениями, одно сообщение содержит ссылку на файл, второе - файл для скачивания, оба открываются в браузере.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VSdZKyvQae/2cdd70a52c65452cb83fc30d4c2d09658b281ef275510a5123b7b3080bd2bae91cbd15295cae0a99cf18b8cfc2d91e095c0383fe9bd040f9d197f33b5e022fb51a5858164e3e9fb4f395cc98153cdc6cfe63741cdee2ff1c2a360e5cc6b2d918b8525d26) |
| Получение файла от Собеседника в сценарий                                      | Livetex        | Да                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Получение геолокации от собеседника в сценарии                                 | Livetex        | Нет                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Доставка сообщений более 1000 символов от Агента до Собеседника                | Livetex        | Да                   | Возможно изменять текст, вставлять гиперссылки, форматировать местоположение и вид при помощи html тегов, они отправляются в слоте Text и обрабатываются Livetex                                                                                                                                                                                                                                                                                  |
| Использование маркдауна                                                        | Livetex        | Нет                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Рассылки с помощью Notification                                                | Livetex        | Нет                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

\
\
