chatme.ai
Search
⌃K

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

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

Подключение

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

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

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

Агенту необходимо создать и настроить канал Агента с коннектором Livetex.
  1. 1.
    Войдите в меню редактирования (Edit) настроек вашего Агента.
  2. 2.
    В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:
    1. 1.
      выберите тип канала Omnichannel
    2. 2.
      Нажмите кнопку Add another channel
      omnichannel.png
  3. 3.
    Выберите в поле Channel Коннектор “LiveTex”.
  4. 4.
    По необходимости пропишите заголовок для данного канала в поле Title.
    1. 1.
      Заголовки разных каналов агента могут совпадать.
  5. 5.
    После выбора “LiveTex” станет доступна ссылка на вебхук канала агента (поле Chatme webhook: URL). На текущий момент методы автоматической настройки вебхуков отсутствуют в LiveTex-Bot-API, настройка производится вручную через техподдержку. Для подключения необходимо установить настройки со стороны LiveTex. Для этого нужно предоставить техподдержке LiveTex:
    • вебхук из поля Chatme webhook: URL;
      image.png
      Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно.
    • ID точки контакта и ID аккаунта из личного кабинета LiveTex;
      image.png
      Важно: В случае если точка контакта - виджет для сайта, ее ID можно найти во вкладке “Код для сайта” нужной нам точки контакта:
      image.png
  6. 6.
    Также нужно запросить у техподдержки LiveTex токен для подключения канала Агента в платформе. После того, как LiveTex предоставят токен для подключения, установите токен в поле Channel webhook: Token в окне настроек канала Агента.
    image.png
  7. 7.
    Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем.
    image.png
    1. 1.
      Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канал Агента.
  8. 8.
    После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы): "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
    image.png
  9. 9.
    Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.

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

В виджете LiveTex можно настроить: аватар, имя, описание, приветственное сообщение. Приветственное сообщение может содержать кнопки.
image.png
Для установки этих настроек необходимо обратиться в техническую поддержу 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)
Да
Важно: В виджете на сайте файлы отображаются двумя сообщениями, одно сообщение содержит ссылку на файл, второе - файл для скачивания, оба открываются в браузере.
image.png
Получение файла от Собеседника в сценарий
Да
Получение геолокации от собеседника в сценарии
Нет
Доставка сообщений более 1000 символов от Агента до Собеседника
Да
Использование маркдауна
Нет