Livetex

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

Подключение

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

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

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

2. Перейдите в раздел Настройки → Точки-контакта.

3. 

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

5. 

6. Важно: Для каждого канала есть инструкция по настройке. Протестированы и работают точки контакта: сайт, Телеграм.

7. Подключение бота-оператора к мессенджерам и соцсетям, подключенным в Livetex, происходит через техподдержку Livetex (см. Глава 2 п. 4).

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

Агенту необходимо создать и настроить Канал Проекта с Коннектором “LiveTex”.

1. Кликните по кнопке настроек Агента.

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

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

4. Выберите Livetex.

5. Откроется панель создания Канал Проекта.

6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

7. Для подключения Канал Проекта необходимо установить настройки со стороны LiveTex. Для этого нужно предоставить поддержке LiveTex:

8. 1. вебхук из поля Chatbot webhook URL;

   2. 

   3. Важно: Для каждой точки контакта Livetex вебхук настраивается отдельно.

   4. ID точки контакта и ID аккаунта из личного кабинета LiveTex;

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

   6. 

9. Важно: Для подключения обращаться в поддержку LiveTex.

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

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

12. 1. Канал Проекта будет сохранен и активирован, если:

    2. 1. Агент обучен;

       2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

       3. будет доступен адрес Канал Проекта;

       4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

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

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
3. 1. Изменения будут применены, если:

   2. 1. Агент обучен;

      2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

   3. Изменения не будут применены, если одно или больше условий не будут выполнены.

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:

   2. 1. Агент обучен;

      2. токен в поле LiveTex token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.

8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

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

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

Общение

Взаимодействие с Livetex происходит в асинхронном режиме, по LiveTex-Bot-Api.Но, хотя методы общения с данным Конечный канал асинхронные, при использовании виджета LiveTex для сайта Агент должен передать настройки для виджета (см.Дополнительная конфигурация в случае использования виджета 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	Нет