Подключение и настройка LiveTex в Chatme.ai: инструкция для пользователей
LiveTex — омниканальная платформа для общения с клиентами в текстовых каналах. С её помощью можно подключить и использовать бота Chatme.ai сразу в нескольких каналах — на сайте, в мессенджерах или социальных сетях.
Подключение
1. Конфигурация бота на стороне Livetex
В первую очередь нужно подключить каналы общения к Livetex.
- Авторизуйтесь в Livetex как администратор
- Перейдите в раздел Настройки → Точки-контакта

- Нажмите "добавить" и создайте нужную точку контакта, выбрав канал из списка

⚠️ Важно: Для каждого канала есть инструкция по настройке. Протестированы и работают точки контакта: сайт, Телеграм
- Подключение бота-оператора к мессенджерам и соцсетям, подключенным в Livetex, происходит через техподдержку Livetex
2. Конфигурация канала агента в Платформе
Агенту необходимо создать и настроить Канал Проекта с Коннектором “LiveTex”
- Кликните по кнопке настроек Агента

- Нажмите кнопку Add channel

- Откроется панель выбора Конечный канал

- Выберите Livetex
Откроется панель создания Канала Проекта.

- По необходимости пропишите заголовок для данного Канала Проекта в поле названия с плейсхолдером New channel
Для подключения Канала Проекта необходимо установить настройки со стороны LiveTex:
-
Предоставьте поддержке LiveTex вебхук из поля Chatbot webhook URL

⚠️ Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно
-
Укажите ID точки контакта и ID аккаунта из личного кабинета LiveTex

-
Также нужно запросить у LiveTex токен для подключения Канала Проекта
После того как LiveTex предоставят токен для подключения, установите токен в поле LiveTex token.

⚠️ Важно: Для подключения обращаться в поддержку LiveTex
Для сохранения Канала Проекта без его активации, нажмите кнопку CREATE.

Для сохранения и активации Канала Проекта, нажмите кнопку CREATE & ACTIVATE.

✅ Канал Проекта будет сохранен и активирован, если:
- Агент обучен
- Токен в поле LiveTex token уникален
- Будет доступен адрес Канал Проекта
- Удастся зарегистрировать вебхук канала
⚠️ Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены
Для отмены создания Канала Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента
- Для редактирования Канала Проекта, необходимо кликнуть по его иконке на карточке Агента

- Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение
- Чтобы применить изменения к активированному Каналу Проекта, нажмите кнопку APPLY

✅ Изменения будут применены, если:
- Агент обучен
- Токен в поле LiveTex token уникален
- Доступен адрес Канал Проекта
- Удалось зарегистрировать вебхук канала
⚠️ Изменения не будут применены, если одно или больше условий не будут выполнены
- Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE

- Чтобы применить изменения к деактивированному Каналу Проекта, нажмите кнопку SAVE

- Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

✅ Изменения будут применены и Канал Проекта будет активирован, если:
- Агент обучен
- Токен в поле LiveTex token уникален
- Доступен адрес Канал Проекта
- Удалось зарегистрировать вебхук канала
⚠️ Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены
- Чтобы отменить внесение изменений, нажмите кнопку CANCEL

- Чтобы удалить Канал Проекта, нажмите кнопку DELETE

Дополнительная конфигурация в случае использования виджета LiveTex
В виджете LiveTex боту можно настроить:
- Аватар
- Имя
- Описание
- Приветственное сообщение (может содержать кнопки)
Данные нужно передавать в формате JSON согласно спецификации LiveTex. Для установки этой настройки нужно обратиться в техническую поддержку Chatme.ai.
Общение
Взаимодействие с Livetex происходит в асинхронном режиме по LiveTex-Bot-Api. Но, хотя методы общения с данным Конечным каналом асинхронные, при использовании виджета Livetex для сайта Агент должен передать настройки для виджета в синхронном режиме — в ответе на первый HTTP-запрос от LiveTex к Каналу Проекта.
⚠️ Важно:
LiveTex не может гарантировать порядок доставки сообщений до Собеседника: если интервал их поступления от Агента очень маленький, чтобы устранить данное негативное поведение, на Коннекторе к Edna введена задержка в 0,5 секунды между отправкой сообщений.
|
Переменная |
Конечный канал |
Переменная в запросе из канала |
Примечания |
|---|---|---|---|
|
channel_visitor_id |
Livetex |
message.client.id |
— |
|
channel_conversation_id |
Livetex |
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 |
Да |
В виджете на сайте высылает файлы двумя сообщениями: одно содержит ссылку на файл, второе — сам файл для скачивания, оба открываются в браузере |
|
Передача файлов в виде ссылок от Агента (Attachment) |
Livetex |
Да |
⚠️ Виджет на сайте отображает файлы двумя сообщениями: одно содержит ссылку на файл, второе — файл для скачивания, оба открываются в браузере |
|
Получение файла от Собеседника в сценарий |
Livetex |
Да |
— |
|
Получение геолокации от собеседника в сценарии |
Livetex |
Нет |
— |
|
Доставка сообщений более 1000 символов от Агента до Собеседника |
Livetex |
Да |
Возможно изменять текст, вставлять гиперссылки, форматировать местоположение и вид при помощи HTML-тегов, они отправляются в слоте Text и обрабатываются Livetex |
|
Использование маркдауна |
Livetex |
Нет |
— |
|
Рассылки с помощью Notification |
Livetex |
Нет |
— |


