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

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

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

Подключение

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

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

  1. В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:

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

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

  2. Сохраните Канал Агента — нажмите Save.

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

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

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

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

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

    • Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете 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 с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 не поддерживается, текст приходит без разметки.

Last updated