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.

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

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

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

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

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

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

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

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

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

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

2. Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/15

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

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

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

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

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

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

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

9. 

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

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

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

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

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

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

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

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

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

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:

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

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

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

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

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

8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку 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 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.