Вывод Агента в каналы через LiveTex

В данной статье описан вывод Агента в каналы через LiveTex и возможности общения Агента в каналах при выводе через LiveTex.

Livetex — одна из омниканальных платформ для общения с клиентами в текстовых каналах. Используя омниканальную платформу LiveTex, можно разместить Агента в одном или нескольких каналах общения.

Подключение

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

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

1. Авторизуйтесь в Livetex как администратор.

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

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

Агенту необходимо создать и настроить канал Агента с коннектором Livetex.

1. Войдите в меню редактирования (Edit) настроек вашего Агента.
2. В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:

   1. выберите тип канала Omnichannel

   2. Нажмите кнопку Add another channel
3. Выберите в поле Channel Коннектор “LiveTex”.
4. По необходимости пропишите заголовок для данного канала в поле Title.

   1. Заголовки разных каналов агента могут совпадать.

5. После выбора “LiveTex” станет доступна ссылка на вебхук канала агента (поле Chatme webhook: URL). На текущий момент методы автоматической настройки вебхуков отсутствуют в LiveTex-Bot-API, настройка производится вручную через техподдержку. Для подключения необходимо установить настройки со стороны LiveTex. Для этого нужно предоставить техподдержке LiveTex:

   • вебхук из поля Chatme webhook: URL; Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно.
   • ID точки контакта и ID аккаунта из личного кабинета LiveTex; Важно: В случае если точка контакта - виджет для сайта, ее ID можно найти во вкладке “Код для сайта” нужной нам точки контакта:
6. Также нужно запросить у техподдержки LiveTex токен для подключения канала Агента в платформе. После того, как LiveTex предоставят токен для подключения, установите токен в поле Channel webhook: Token в окне настроек канала Агента.
7. Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем.

   1. Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канал Агента.
8. После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы): "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
9. Сохраните Канал Агента — нажмите Save.

Все настройки будут применены только после сохранения.

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

В виджете LiveTex можно настроить: аватар, имя, описание, приветственное сообщение. Приветственное сообщение может содержать кнопки. Для установки этих настроек необходимо обратиться в техническую поддержу chatme.ai.

Общение

Маппинг канальных переменных из канала LiveTex

Канальная переменная	Переменная в теле входящего запроса из канала
channel_visitor_id	message.client.id
channel_conversation_id	message.dialog.id
channel_visitor_firstname	—
channel_visitor_lastname	—
channel_visitor_account	—
channel_visitor_phone	—
channel_visitor_email	—
channel_visitor_source	—
channel_visitor_auth	—
channel_visitor_location	—

Возможности общения в канале LiveTex

Функционал	Наличие в канале	Описание
Переменная channel_chat_id	Да
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Да
Кнопки	Да	Возможно форматировать местоположение и вид при помощи html тегов, они отправляются в подслоте button и обрабатываются на стороне Livetex
Перевод на оператора	Да	Работает в виджете на сайте LiveTex. Для перевода диалога на оператора используется слот Change Chat Mode.
Передача файлов в виде файлов от Агента (слот Attachment)	Да
Передача файлов в виде ссылок от Агента (слот Attachment)	Да	Важно: В виджете на сайте файлы отображаются двумя сообщениями, одно сообщение содержит ссылку на файл, второе - файл для скачивания, оба открываются в браузере.
Получение файла от Собеседника в сценарий	Да
Получение геолокации от собеседника в сценарии	Нет
Доставка сообщений более 1000 символов от Агента до Собеседника	Да
Использование маркдауна	Нет