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

icon picker
Jivo

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

Подключение

1. Конфигурация бота на стороне Платформы

@Агент
у необходимо создать и настроить
@Канал Агента
с
@Коннектор
ом “Jivo”.
Войдите в меню редактирования (Edit) настроек вашего
@Агент
а.
image.png
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Omnichannel
Нажмите кнопку Add channel ​
Снимок экрана 2023-07-03 в 17.59.51.png
Выберите в поле Channel
@Коннектор
“Jivo”.
image.png
По необходимости пропишите заголовок для данного
@Канал Агента
в поле Title. ​
image.png
После выбора “Jivo” в поле Channel webhook: Token будет указан автоматически сгенерированный токен, который потребуется указать в настройках
Снимок экрана 2023-07-10 в 17.15.55.png
Примечание: Chatbot webhook: Token и Channel webhook: Token синхронизированы и будут идентичны, но поле Chatbot webhook: Token защищено от редактирования. Вы можете заменить токен на произвольный, установив новый токен в поле Channel webhook: Token или сгенерировать новый кнопкой Generate New
Активируйте канал переключением тумблера для того, чтобы
@Агент
начал отвечать в нем. ​
image.png
Если
@Агент
не был обучен, появится предупреждение. В таком случае необходимо обучить
@Агент
а, после чего повторить попытку активации
@Канал Агента
.
image.png
После активации
@Канал Агента
, если есть проблемы с его доступностью, будет выведено предупреждение (
@Канал Агента
будет активирован несмотря на проблемы):
"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
image.png
Сохраните
@Канал Агента
— нажмите Save.
Важно: Все настройки будут применены только после сохранения.

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

Примечание: В данной статье рассматривается только интеграция Jivo с ботами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в Jivo
Зайдите в аккаунт
.
Перейдите по ссылке
Для собеседников боты в Jivo выглядят как операторы (виртуальные-сотрудники).
Заполните следующие поля:
Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
image.png
Скопированный с Платформы токен вставьте в поле Токен бота.
токен.png
Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.
image.png

Общение

Маппинг Канальных переменных из канала Jivo
Канальная переменная
Конечный канал
Переменная в теле входящего запроса из канала
Особенности
1
channel_visitor_id
Jivo
client_id
2
channel_conversation_id
Jivo
sender.id
3
channel_visitor_firstname
Jivo
sender.name (необязательное)
4
channel_visitor_lastname
Jivo
нет
5
channel_visitor_account
Jivo
нет
6
channel_visitor_phone
Jivo
sender.phone (необязательное)
Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
7
channel_visitor_email
Jivo
sender.email (необязательное)
Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
8
channel_visitor_auth
Jivo
sender.user_token (необязательное)
9
channel_visitor_source
Jivo
sender.url (необязательное)
Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито В ссылке содержится информация о канале, через который происходит общение
10
channel_reply_to
Jivo
нет
There are no rows in this table
Сервисные сообщения из Jivo
Сообщение
Конечный канал
Client message
Описание
1
Оператор Jivo принял чат от бота
Jivo
Строка: jivo: operator joined chat
Проблема: логика обработки сервисного сообщения нарушена со стороны chatme. Сервисное сообщение chat_closed трактуется как сообщение о заходе оператора в чат.
There are no rows in this table
Возможности общения в Канале Jivo
Функционал
Конечный канал
Наличие в канале
Описание
1
channel_chat_id
Jivo
Да
формат <jivo сlient_id>|jivosite
2
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате
Jivo
Частично
диалог в Jivo длится 2 часа, сообщения дойдут до
@Собеседник
а только в течение этого времени
3
Кнопки
Jivo
Да
в приходят клавиатурные кнопки
4
Перевод на оператора
Jivo
Да
с помощью слота
5
Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Jivo
Нет
6
Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )
Jivo
Да
в ссылки на изображения автоматически выводят изображение в сообщении
7
Получение файла от Собеседника в сценарий
Jivo
Да
Метаданные файла (тип, ссылка) записываются в переменную
@client_message
, в формате file:Тип файла|Ссылка на файл
8
Получение геолокации от собеседника в сценарии
Jivo
Да
@client_message
при отправке геолокации: 📍 Location https://www.google.com/maps/@54.855614,83.049903,14z
9
Доставка сообщений более 1000 символов от Агента до Собеседника
Jivo
Частично
В ОК, ФБ, ВК сообщения более 1000 байтов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком
10
Получить ссылку на источник лида
Jivo
Частично
В переменную
@channel_visitor_source
записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет
11
Использование маркдауна
Jivo
Частично
Поддерживается в виджете. Отображение текста, размеченного с помощью
@Markdown
, в остальных каналах зависит от самих каналов.
Поддерживаются следующие типы разметки:
*курсив*
_курсив_
__жирный шрифт__
*__жирный курсив__*
[ссылка](http://www.example.com/)
Известные особенности: в Telegram и ВКонтакте
@Markdown
не поддерживается, текст приходит без разметки.
12
Рассылки с помощью Notification
Jivo
Нет
There are no rows in this table

Перевод на оператора

При использовании
@Слот
а
@Change Chat Mode
происходит переключение на оператора. После переключения на оператора диалог завершается и отображается на странице Аналитики(
@Вкладка Аналитики
).

Переключение на оператора при отсутствии ответа от Агента

Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов, методом POST в формате application/json. Timeout запроса составляет 3 секунды, кол-во повторных попыток равно 2 (итого 3 попытки по 3 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.

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.