Comment on page
Вывод Агента в каналы через 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
- 1.
- 2.
- 3.Заполните следующие поля:
- Аватар — изображение, кот орое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
- Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
- Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
- 4.Скопированный с Платформы токен вставьте в поле Токен бота.
- 5.Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.
О том, что такое сервисные сообщения и как активировать их передачу из канала: Сервисные сообщения каналов
Из Jivo передаются следующие сервисные сообщения:
Сообщение | Шаблон в client_message | Описание |
|---|---|---|
Оператор Jivo принял чат от бота | Строка: jivo: operator joined chat | После выполнения перевода общения на оператора в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки Платформа получает событие в переменную client_message, если для данного канала Агента активированы сервисные сообщение канала |
Канальная переменная | Переменная в теле входящего запроса из канала | Особенности |
|---|---|---|
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 (необязательное) | Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито |
Функционал | Наличие в канале | Описание |
|---|---|---|
Переменная 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 не поддерживается, текст приходит без разметки. |