Вывод Агента в омниканальные платформы

icon picker
Livetex

– одна из омниканальных платформ для общения с клиентами в текстовых каналах. Используя омниканальную платформу LiveTex, можно разместить
@Бот
а в одном или нескольких каналах общения. Ознакомиться с пользовательской документацией вы можете по .

Подключение

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

В первую очередь нужно подключить каналы общения к Livetex.
Авторизуйтесь в Livetex как администратор.
Перейдите в раздел НастройкиТочки-контакта.
image.png
Нажмите “добавить” и создайте нужную точку контакта, выбрав канал из списка.
image.png
Важно: Для каждого канала есть инструкция по настройке. Протестированы и работают точки контакта: сайт, Телеграм.
Подключение бота-оператора к мессенджерам и соцсетям, подключенным в Livetex, происходит через техподдержку Livetex (см. Глава 2 п. 4).

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

@Агент
у необходимо создать и настроить
@Канал Агента
с
@Коннектор
ом “LiveTex”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
а.
image.png
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Omnichannel
Нажмите кнопку Add channel ​
Снимок экрана 2023-07-03 в 17.59.51.png
Выберите в поле Channel
@Коннектор
“LiveTex”. ​
image.png
По необходимости пропишите заголовок для данного
@Канал Агента
в поле Title. ​
image.png
После выбора “LiveTex” станет доступна ссылка на вебхук канала агента (поле Chatbot webhook: URL). На текущий момент (01.09.2021) методы автоматической настройки вебхуков отсутствуют в , настройка производится вручную через поддержку. Для подключения необходимо установить настройки со стороны LiveTex. Для этого нужно предоставить поддержке LiveTex:
вебхук из поля Chatbot webhook: URL;
Снимок экрана 2023-07-10 в 17.24.43.png

Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно.
ID точки контакта и ID аккаунта из личного кабинета LiveTex;
image.png
Важно: В случае если точка контакта - виджет для сайта, ее ID можно найти во вкладке “Код для сайта” нужной нам точки контакта.
image.png
Также нужно запросить у LiveTex токен для подключения
@Канал Агента
. После того, как LiveTex предоставят токен для подключения, установите токен в поле Channel webhook: Token в окне настроек
@Канал Агента
.
Снимок экрана 2023-07-10 в 17.26.20.png
Важно: Для подключения обращаться в поддержку LiveTex.
Активируйте канал переключением тумблера для того, чтобы
@Агент
начал отвечать в нем.
Если
@Агент
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
а, после чего повторить попытку активации
@Канал Агента
.
image.png
После активации
@Канал Агента
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
image.png
Сохраните
@Канал Агента
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

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

В виджете LiveTex боту можно настроить: аватар, имя, описание, приветственное сообщение. Приветственное сообщение может содержать кнопки.
image.png
Данные нужно передавать в формате json согласно , для установки этой настройки нужно обратиться в техническую поддержу .

Общение

Взаимодействие с Livetex происходит в асинхронном режиме, по .
Но, хотя методы общения с данным
@Конечный канал
асинхронные, при использовании виджета LiveTex для сайта
@Агент
должен передать настройки для виджета (см.) в синхронном режиме — в ответе на первый HTTP запрос от LiveTex к
@Канал Агента
).
Важно: LiveTex не может гарантировать порядок доставки сообщений до
@Собеседник
а: если интервал их поступления от
@Агент
а очень маленький, чтобы устранить данное негативное поведение, на
@Коннектор
е к Edna введена задержка в 0,5 секунд между отправкой сообщений.

Маппинг Канальных переменных из канала LiveTex
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
1
channel_visitor_id
Livetex
message.client.id
2
channel_conversation_id
Livetex
message.dialog.id
3
channel_visitor_firstname
Livetex
нет
4
channel_visitor_lastname
Livetex
нет
5
channel_visitor_account
Livetex
нет
6
channel_visitor_phone
Livetex
нет
7
channel_visitor_email
Livetex
нет
8
channel_visitor_source
Livetex
нет
9
channel_visitor_auth
Livetex
нет
10
channel_visitor_location
Livetex
нет
11
channel_reply_to
Livetex
нет
There are no rows in this table
Возможности общения в канале LiveTex
Функционал
Конечный канал
Наличие в канале
Описание
1
channel_chat_id
Livetex
Да
2
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
Livetex
Да
3
Кнопки
Livetex
Да
Возможно форматировать местоположение и вид при помощи html тегов, они отправляются в слоте
@button
и обрабатываются на стороне
@Livetex
4
Перевод на оператора
Livetex
Да
Работает в виджете на сайте LiveTex, в остальных каналах не известно.
Для перевода диалога на оператора используется слот .
5
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Livetex
Да
Проблема: В виджете на сайте высылает файлы двумя сообщениями, одно сообщение отправляет ссылку на файл, второе файл для скачивания, оба открываются в браузере.
image.png
6
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Livetex
Да
Важно: В виджете на сайте файлы отображаются двумя сообщениями, одно сообщение содержит ссылку на файл, второе - файл для скачивания, оба открываются в браузере.
image.png
7
Получение файла от Собеседника в сценарий
Livetex
Да
8
Получение геолокации от собеседника в сценарии
Livetex
Нет
9
Доставка сообщений более 1000 символов от Агента до Собеседника
Livetex
Да
Возможно изменять текст, вставлять гиперссылки, форматировать местоположение и вид при помощи html тегов, они отправляются в слоте
@Text
и обрабатываются
@Livetex
10
Использование маркдауна
Livetex
Нет
11
Рассылки с помощью Notification
Livetex
Нет
There are no rows in this table

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.