Вывод Агента в каналы через Jivo
В данной статье описан вывод Агента в каналы через Jivo и возможности общения Агента в каналах при выводе через Jivo.
Jivo — омниканальная платформа, предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете.
Подключение
Конфигурация канала Агента в Платформе
Агенту необходимо создать и настроить Канал Агента с коннектором Jivo.
В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:
выберите тип канала Omnichannel
Заголовки разных каналов агента могут совпадать.
Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.
Конфигурация на стороне Jivo
Примечание: В данной статье рассматривается только интеграция Jivo с Агентами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в документации Jivo
Зайдите в аккаунт Jivo.
Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/15
Заполните следующие поля:
Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
Общение
Сервисные сообщения канала
Из 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 длится 2 часа, сообщения дойдут до Собеседника только в течение этого времени |
Кнопки | Да | в Telegram приходят клавиатурные кнопки |
Перевод на оператора | Да | С помощью слота Change Chat Mode. Пока оператор не примет Диалог, общение с Собеседником будет вести Агент |
Передача файлов в виде файлов от Агента (слот Attachment) | Нет | |
Передача файлов в виде ссылок от Агента (слот Attachment) | Да | При выводе в Telegram через Jivo ссылки на изображения автоматически выводят изображение в сообщении |
Получение файла от Собеседника в сценарий | Да | Метаданные файла (тип, ссылка) записываются в переменную client_message, файл в платформу не закачивается. |
Получение геолокации от собеседника в сценарии | Да | Пример переменной client_message при отправке геолокации: |
Доставка сообщений более 1000 символов от Агента до Собеседника | Частично | В Одноклассники, Facebook, ВКонтакте сообщения более 1000 символов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком |
Получить ссылку на источник лида | Частично | В переменную channel_visitor_source записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не работает |
Использование маркдауна | Частично | Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов. Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/) Известные особенности: в Telegram и ВКонтакте Markdown не поддерживается, текст приходит без разметки. |
Last updated