---
description: Интеграция сервиса LiveTex с платформой Metabot24
---

# LiveTex

Интеграции сервиса [**LiveTex**](https://my.livetex.ru/) с [**Metabot24**](https://app.metabot24.com) позволяет использовать данный сервис как чат-центр, в котором будут отображаться все диалоги с клиентами в любых прямых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора.

История диалогов с ботами автоматически сохраняется в архиве.

### Подключение интеграции

Создайте новый аккаунт **LiveTex** или войдите в существующий.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQM6ycqXeq3y34zHtTe%2F-MQMGdq2G7qItVczY5Bi%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=29c99049-dd7f-4655-993e-829fcae12f69)

Если аккаунт только создан, то необходимо _Активировать пробный_ период.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQM6ycqXeq3y34zHtTe%2F-MQMGG1Y8RDiODe0VLD9%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=1c8f50b5-92c9-4b99-8162-b71843632149)

В разделе **Главная** необходимо добавить новую точку контакта.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMHTEBoXsKQNq3sIbQ%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=4572e890-80c3-4786-abf7-6a45e9f7e553)

Нажмите на кнопку _Добавить_.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMHaB2khj9HAXo_tho%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=e0bbfd4a-6192-4b10-9d1b-0ca1fb8ed3e6)

Новая точка контакта должна быть с типом _Messaging API_, наименование можно указать произвольное.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMIDVw-ZK0kWdMhj5-%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=7525aafd-75be-4f3a-9754-554a292bee1c)

Нажмите на кнопку _Ключ доступа_ и сгенерируйте ключ доступа.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMIkTJALNnwZ1E7-Yt%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=9581eaa4-f412-4e1f-a533-6b968c0a034d)

У созданной точки необходимо скопировать ключ доступа.&#x20;

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMK-VQVe0Z9sskDiiK%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=f3c1104e-a122-459d-aa81-498a20f16367)

На платформе [**Metabot24**](https://app.metabot24.com) в настройках своего бота необходимо выполнить следующие действия:

* Перейти в раздел [**Настройки бота**](https://app.metabot24.com/bot-channel) подраздел [**Каналы**](https://metabot.gitbook.io/documentation/panel-upravleniya-botom/kanaly)**;**
* Нажать кнопку **Новая привязка** и выбрать канал **LiveTex (Chat Center)**.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MR-e7-QaH7xW2xqKdns%2F-MR-eyD2HmRwpULvUTgM%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=7f18ac8f-4e70-48dc-baac-034a82778ec6)

В диалоговом окне указать следующие параметры:&#x20;

* _Канал_ - по умолчанию подставляется наименование создаваемого канала;
* _Заголовок сообщений бота_ - произвольная фраза, которая будет отображаться в чат-центре над сообщениями от Бота, рекомендуем вставить эмодзи для визуальной наглядности;
* _Заголовок сообщений лида_ - произвольная фраза, которая будет отображаться в чат-центре над сообщениями от Лида, рекомендуем вставить эмодзи для визуальной наглядности;
* _Исключаемые каналы_ - установить активность чекбокса на тех каналах, которые не должны попадать в чат-центр LiveTex:
  * Umnico, Bitrix, Jivo, Webim - каналы, в которых реализованы чат-центры, рекомендуем на них установить активность чекбокса;
  * Telegram, Metabot Widget, Viber, Vk - прямые каналы, которые можно объединить в чат-центр LiveTex;
* _Токен_ - скопировать из буфера обмена ключ доступа сгенерированный при создании точки контакта в LiveTex.

Сохранить настройки.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMGnQbMWGGFZVgNQfr%2F-MQMKSP73Y5Mn4isnWUj%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=5e272aae-2693-4c40-9b3e-cbd1f2da9bc6)

Далее нажмите пункт **Вебхук**, тем самым Metabot24 через API настроит канал на отправку оповещений.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMOiPhrI3frO8aFUHN%2F-MQMP7a0_A2kxkJiUm5H%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=490af473-5d34-422f-bddf-43ac62413efe)

### Настройка чат-центра

Пользователь, зарегистрированный в сервисе **LiveTex**, также является первым оператором. Для работы с чат-центром необходимо скачать приложение в личном кабинете через меню пользователя.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMQyeVse2OUiwQMWve%2F-MQMRxwQEPhTcOJWQY_a%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=cb6a4396-6dd3-4c66-95ad-f675df21e6d4)

\
Произведите настройки аккаунта LiveTex для дальнейшей интеграции с платформой Metabot24, перейдя в раздел **Настройки**, подраздел **Сотрудники**, добавьте дополнительных операторов, нажав на кнопку _Добавить сотрудника_.&#x20;

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMQyeVse2OUiwQMWve%2F-MQMSVI2pGX80fCY_g9H%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=0e5cdc58-5098-449d-b073-6c1a5c8929e4)

\
Далее в разделе **Настройки** подразделе **Маршрутизация** на правой секции **Сотрудники группы** добавить заведённого сотрудника в список, нажав кнопку _Добавить_. В левой секции по умолчанию только одна группа _**Группа для Messaging API**_.

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MQMQyeVse2OUiwQMWve%2F-MQMU4kWQpbwYyRq4EHK%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=9466caac-9bd6-49fa-938d-a596261e4ad2)

{% hint style="warning" %}
На текущий момент в Metabot24 при работе с LiveTex выбирается первая группа по порядку (не по имени или коду), то есть заложен функционал работы с одной группой.
{% endhint %}

После подключения канала все сообщения пользователя начинают отправляться в **LiveTex**. При этом, если по сценарию взаимодействие происходит с Ботом, то есть не выполнен перевод на Оператора, то Операторы не видят эти сообщения в **LiveTex**. История переписки появляется у Оператора только после переключения диалога с бота.

### Дополнительные возможности

1. Реализована поддержка следующих типов сообщений с платформы Metabot24:
   * текстовое сообщение;
   * передача изображений, видео;
   * "меню", выводится в виде текста;
   * вложения различных типов.

{% hint style="info" %}
Выбор пользователем пункта **Меню** отображается в истории сообщений в виде кода скрипта пункта Меню.
{% endhint %}

2\. При переводе диалога на Оператора пользователь получает сообщение _**Диалог переведён на оператора**_. Далее при прочтении первого сообщения Оператором пользователь получает сообщение _**Оператор <имя оператора> подключился к диалогу**_.&#x20;

3\. Поддерживается перевод чатов между Операторами. Если был произведён перевод чата на другого оператора, то после прочтения диалога опять выводится сообщение _**Оператор <имя оператора> подключился к диалогу**_.&#x20;

4\. При закрытии чата Оператором пользователь получает сообщение _**Оператор вернул диалог боту**_.

5\. На платформе Metabot24 поддерживается функциональная возможность передачи атрибутов Лида для LiveTex. Для этого имеется функция _**setLiveTexAttr**_.&#x20;

Все переданные атрибуты будут отображены в шапке диалога в LiveTex. Пример вызова:

```
attr = {
 'номер_заявки': 705,
 'имя_заявки': 'Test',
 };
 lead.setLiveTexAttr(attr);
```

Функция записывает данные параметры в атрибуты лида с ключом _**sys\_livetex\_attrs**_ с типом _**system**_. При переводе диалога на Оператора они считываются и передаются в LiveTex.

6\. Если Операторов нет онлайн, то можно использовать скрипт с типом **Нет доступных операторов**. При переводе на оператора выполняется проверка наличия хотя бы одного Оператора со статусом online. Если таких нет, то вызывается скрипт с вышеуказанным типом.

7\. Имеется возможность выполнить проверку доступности операторов и после этого определить, какой скрипт запустить с типом **Перевод на оператора (онлайн)** или **Перевод на оператора (оффлайн)**.

### Каналы связи LiveTex

На текущий момент LiveTex обеспечивает следующий список каналов связи для возможного подключения:

![](https://1621485802-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lof4a3yX4z_pjUWqMhw%2F-MTK7MRZyfUIjR3um-Hi%2F-MTK7mT-h9E54BMwpKpb%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=a71793e5-c211-42ed-be2a-8144707f1f0e)
