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

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

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

Подключение

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

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

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

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

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

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

5. После выбора “Jivo” в поле Channel webhook: Token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo Примечание: Chatme webhook: Token и Channel webhook: Token синхронизированы и будут идентичны, но поле Chatme webhook: Token защищено от редактирования. Вы можете заменить токен на произвольный, установив новый токен в поле Channel webhook: Token или сгенерировать новый кнопкой Generate New
6. Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем.

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

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

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

Примечание: В данной статье рассматривается только интеграция Jivo с Агентами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в документации Jivo

1. Зайдите в аккаунт Jivo.

2. Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/15

3. Заполните следующие поля:

   • Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;

   • Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;

   • Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
4. Скопированный с Платформы токен вставьте в поле Токен бота.
5. Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.

Общение

Сервисные сообщения канала

О том, что такое сервисные сообщения и как активировать их передачу из канала: Сервисные сообщения каналов

Из Jivo передаются следующие сервисные сообщения:

Сообщение	Шаблон в client_message	Описание
Оператор Jivo принял чат от бота	Строка: jivo: operator joined chat	После выполнения перевода общения на оператора в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки Платформа получает событие в переменную client_message, если для данного канала Агента активированы сервисные сообщение канала

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

Канальная переменная	Переменная в теле входящего запроса из канала	Особенности
channel_visitor_id	client_id
channel_conversation_id	sender.id
channel_visitor_firstname	sender.name (необязательное)
channel_visitor_lastname	—
channel_visitor_account	—
channel_visitor_phone	sender.phone	Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
channel_visitor_email	sender.email	Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
channel_visitor_auth	sender.user_token (необязательное)
channel_visitor_source	sender.url (необязательное)	Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито

Возможности общения в Jivo

Функционал	Наличие в канале	Описание
Переменная channel_chat_id	Да	Формат <jivo сlient_id>|jivosite
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Частично	Диалог в Jivo длится 2 часа, сообщения дойдут до Собеседника только в течение этого времени
Кнопки	Да	в Telegram приходят клавиатурные кнопки
Перевод на оператора	Да	С помощью слота Change Chat Mode. Пока оператор не примет Диалог, общение с Собеседником будет вести Агент
Передача файлов в виде файлов от Агента (слот Attachment)	Нет
Передача файлов в виде ссылок от Агента (слот Attachment)	Да	При выводе в Telegram через Jivo ссылки на изображения автоматически выводят изображение в сообщении
Получение файла от Собеседника в сценарий	Да	Метаданные файла (тип, ссылка) записываются в переменную client_message, файл в платформу не закачивается.
Получение геолокации от собеседника в сценарии	Да	Пример переменной client_message при отправке геолокации: 📍 Location https://www.google.com/maps/@54.855614,83.049903,14z
Доставка сообщений более 1000 символов от Агента до Собеседника	Частично	В Одноклассники, Facebook, ВКонтакте сообщения более 1000 символов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком
Получить ссылку на источник лида	Частично	В переменную channel_visitor_source записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не работает
Использование маркдауна	Частично	Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов. Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/) Известные особенности: в Telegram и ВКонтакте Markdown не поддерживается, текст приходит без разметки.