Интеграция с Jivo
Jivo — одна из популярных омниканальных платформ , предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете.
Подключение
1. Конфигурация бота на стороне Платформы
Агенту необходимо создать и настроить Канал Проекта с Коннектором “Jivo”.
- Кликните по кнопке настроек Агента.
- Нажмите кнопку Add channel .
- Откроется панель выбора Конечный канал.
- Выберите Jivo.
- Откроется панель создания Канал Проекта.
- По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
- В поле Jivo token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo.
- По необходимости переключите тумблер Receive service messages , чтобы получать Сервисные сообщения канала.
- Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
- Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
Условия успешного сохранения и активации:
- Агент обучен;
- Токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
- Будет доступен адрес Канал Проекта ;
- Удастся зарегистрировать вебхук канала.
Если одно или больше условий не выполнены:
- Канал Проекта будет сохранен, но не активирован.
Для отмены создания Канал Проекта, нажмите кнопку CANCEL. 
2. Конфигурация бота на стороне Jivo
Примечание: В данной статье рассматривается только интеграция Jivo с ботами. О том, как организовать маршрутизацию диалогов между ботами и операторами, см. в документации Jivo.
- Зайдите в аккаунт Jivo.
- Перейдите по ссылке: https://app.jivosite.com/settings/integrations/add-bot/15
- Для собеседников боты в Jivo выглядят как операторы (виртуальные сотрудники).
- Заполните следующие поля:
- Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
- Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
- Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
- Скопированный с Платформы в п.1.7 токен вставьте в поле Токен бота.
- Выберите каналы для подключения в разделе Подключить для следующих каналов , проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.
Редактирование и удаление Канала Агента
- Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.
- Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
- Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
- Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
- Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
- Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
- Для отмены изменений, нажмите кнопку CANCEL.
- Чтобы удалить Канал Проекта, нажмите кнопку 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(необязательное) |
Не приходит, если нет соглашения на передачу данных. |
|
channel_visitor_email |
Jivo |
sender.email(необязательное) |
Не приходит, если нет соглашения на передачу данных. |
|
channel_visitor_auth |
Jivo |
sender.user_token(необязательное) |
|
|
channel_visitor_source |
Jivo |
sender.url(необязательное) |
Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито. |
Функционал общения
|
Функция |
Конечный канал |
Доступность в канале |
Примечания |
|---|---|---|---|
|
channel_chat_id |
Jivo |
Да |
Формат `<jivo client_id> |
|
Сообщения дойдут до собеседника |
Jivo |
Частично |
Диалог длится 2 часа. |
|
Кнопки |
Jivo |
Да |
В Telegram приходят клавиатурные кнопки. |
|
Перевод на оператора |
Jivo |
Да |
С помощью слота Change Chat Mode. |
|
Передача файлов в виде файлов от Агента |
Jivo |
Нет |
|
|
Передача файлов в виде ссылок от Агента |
Jivo |
Да |
В Telegram ссылки на изображения автоматически выводят изображение. |
|
Получение файла от собеседника |
Jivo |
Да |
Метаданные записываются в переменную client_message. |
|
Получение геолокации от собеседника |
Jivo |
Да |
Пример:📍 Location https://www.google.com/maps/@54.855614,83.049903,14z. |
|
Доставка сообщений более 1000 символов |
Jivo |
Частично |
В ОК, ФБ, ВК разбиваются на несколько по абзацам. |
|
Получить ссылку на источник лида |
Jivo |
Частично |
Работает только для виджета. |
|
Использование Markdown |
Jivo |
Частично |
Поддерживается в виджете. |
|
Рассылки с помощью Notification |
Jivo |
Нет |
Перевод на оператора
- При использовании слота Change Chat Mode происходит переключение на оператора. После этого диалог завершается и отображается на странице Аналитики.
- Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов методом POST в формате application/json. Timeout запроса составляет 3 секунды, количество повторных попыток равно 2 (итого 3 попытки). Если ответ не получен, клиент переводится на оператора.
