Jivo

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

Подключение

1. Конфигурация бота на стороне Платформы

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

  1. Кликните по кнопке настроек Агента.

  2. Нажмите кнопку Add channel.

  3. Откроется панель выбора Конечный канал.

  4. Выберите Jivo.

  5. Откроется панель создания Канал Проекта.

  6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

  7. В поле Jivo token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo.

  8. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.

  9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

  10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

    1. Канал Проекта будет сохранен и активирован, если:

      1. Агент обучен;

      2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

  11. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

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

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

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

  2. Для собеседников боты в Jivo выглядят как операторы (виртуальные-сотрудники).

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

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

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

    3. Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.

  4. Скопированный с Платформы в п.1.7 токен вставьте в поле Токен бота.

  5. Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

  1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

  2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.

    1. Изменения будут применены, если:

      1. Агент обучен;

      2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Изменения не будут применены, если одно или больше условий не будут выполнены.

  3. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.

  4. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.

  5. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

    1. Изменения будут применены и Канал Проекта будет активирован, если:

      1. Агент обучен;

      2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

    2. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.

  6. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.

  7. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Переменная
Конечный канал
Переменная в запросе из канала
Примечания

channel_visitor_id

Jivo

client_id

channel_conversation_id

Jivo

sender.id

channel_visitor_firstname

Jivo

sender.name (необязательное)

channel_visitor_lastname

Jivo

нет

channel_visitor_account

Jivo

нет

channel_visitor_phone

Jivo

sender.phone (необязательное)

Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу

channel_visitor_email

Jivo

sender.email (необязательное)

Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу

channel_visitor_auth

Jivo

sender.user_token (необязательное)

channel_visitor_source

Jivo

sender.url (необязательное)

Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито В ссылке содержится информация о канале, через который происходит общение

Сообщение
Конечный канал
Client message
Описание

Оператор Jivo принял чат от бота

Jivo

Строка: jivo: operator joined chat

После выполнения Перевод общения на оператора в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки мы получаем событие в client_message, если для данного Канал Проекта активированы Сервисные сообщения канала

Функционал общения
Конечный канал
Доступность в канале
Примечания

channel_chat_id

Jivo

Да

формат <jivo сlient_id>|jivosite

Сообщения дойдут до собеседника, если агент напишет первый в существующем чате

Jivo

Частично

диалог в Jivo длится 2 часа, сообщения дойдут до Собеседника только в течение этого времени

Кнопки

Jivo

Да

в Telegram приходят клавиатурные кнопки

Перевод на оператора

Jivo

Да

с помощью слота Change Chat Mode

Передача файлов в виде файлов от Агента (Attachment)

Jivo

Нет

Передача файлов в виде ссылок от Агента (Attachment)

Jivo

Да

в Telegram ссылки на изображения автоматически выводят изображение в сообщении

Получение файла от Собеседника в сценарий

Jivo

Да

Метаданные файла (тип, ссылка) записываются в переменную client_message, файл в платформу не закачивается.

Получение геолокации от собеседника в сценарии

Jivo

Да

client_message при отправке геолокации: 📍 Location https://www.google.com/maps/@54.855614,83.049903,14z

Доставка сообщений более 1000 символов от Агента до Собеседника

Jivo

Частично

В ОК, ФБ, ВК сообщения более 1000 байтов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком

Получить ссылку на источник лида

Jivo

Частично

В переменную channel_visitor_source записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет

Использование маркдауна

Jivo

Частично

Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов.Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/)Известные особенности: в Telegram и ВКонтакте Markdown не поддерживается, текст приходит без разметки.

Рассылки с помощью Notification

Jivo

Нет

Перевод на оператора

При использовании Слота Change Chat Mode происходит переключение на оператора. После переключения на оператора диалог завершается и отображается на странице Аналитики(Вкладка Аналитики).

Переключение на оператора при отсутствии ответа от Агента

Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов, методом POST в формате application/json. Timeout запроса составляет 3 секунды, кол-во повторных попыток равно 2 (итого 3 попытки по 3 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.

Last updated