chatme.ai
Search…
Создание Агента на платформе
ДЛЯ РАЗРАБОТЧИКОВ
Вывод Агента в каналы через Jivo
В данной статье описан вывод Агента в каналы через Jivo и возможности общения Агента в каналах при выводе через Jivo.
Jivo — омниканальная платформа, предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете.

Подключение

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

Агенту необходимо создать и настроить Канал Агента с коннектором Jivo.
  1. 1.
    Войдите в меню редактирования (Edit) настроек вашего Агента
  2. 2.
    В появившемся окне перейдите на вкладку Channels для настройки каналов, далее:
    1. 1.
      выберите тип канала Omnichannel
    2. 2.
      Нажмите кнопку Add another channel
  3. 3.
    Интеграция с Jivo происходит через Коннектор с названием “Jivo”, установите его в поле Channel.
  4. 4.
    После выбора “Jivo” в поле Channel webhook: Token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo
    Примечание: Chatme webhook: Token и Channel webhook: Token синхронизированы и будут идентичны, но поле Chatme webhook: Token защищено от редактирования. Вы можете заменить токен на произвольный, установив новый токен в поле Channel webhook: Token или сгенерировать новый кнопкой Generate New
  5. 5.
    Активируйте канал переключением тумблера для того, чтобы Агент начал отвечать в нем.
    1. 1.
      Если Агент не был обучен, появится предупреждение. В таком случае необходимо обучить Агента, после чего повторить попытку активации Канал Агента.
  6. 6.
    После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы): "Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL
  7. 7.
    Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.

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

Примечание: В данной статье рассматривается только интеграция Jivo с Агентами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в документации Jivo
  1. 1.
    Зайдите в аккаунт Jivo.
  2. 2.
    Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/15
  3. 3.
    Заполните следующие поля:
    • Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
    • Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
    • Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
  4. 4.
    Скопированный с Платформы токен вставьте в поле Токен бота.
  5. 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
channel_visitor_email
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 не поддерживается, текст приходит без разметки.
Copy link
On this page
Подключение
Конфигурация канала Агента в Платформе
Конфигурация на стороне Jivo
Общение
Сервисные сообщения канала
Маппинг Канальных переменных из канала Jivo
Возможности общения в Jivo