Jivo
Last updated
Last updated
Jivo — одна из популярных омниканальных платформ, предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете.
Агенту необходимо создать и настроить Канал Проекта с Коннектором “Jivo”.
Кликните по кнопке настроек Агента.
Нажмите кнопку Add channel.
Откроется панель выбора Конечный канал.
Выберите Jivo.
Откроется панель создания Канал Проекта.
По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
В поле Jivo token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo.
По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.
Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
Канал Проекта будет сохранен и активирован, если:
Агент обучен;
токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
Для отмены создания Канал Проекта нажмите кнопку CANCEL.
Примечание: В данной статье рассматривается только интеграция Jivo с ботами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в документации Jivo
Зайдите в аккаунт Jivo.
Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/15
Для собеседников боты в Jivo выглядят как операторы (виртуальные-сотрудники).
Заполните следующие поля:
Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
Скопированный с Платформы в п.1.7 токен вставьте в поле Токен бота.
Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.
Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
Изменения будут применены, если:
Агент обучен;
токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения не будут применены, если одно или больше условий не будут выполнены.
Изменения будут применены и Канал Проекта будет активирован, если:
Агент обучен;
токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
client_id
sender.id
sender.name (необязательное)
нет
нет
sender.phone (необязательное)
Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
sender.email (необязательное)
Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу
sender.user_token (необязательное)
sender.url (необязательное)
Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито В ссылке содержится информация о канале, через который происходит общение
Оператор Jivo принял чат от бота
Строка: jivo: operator joined chat
Да
формат <jivo сlient_id>|jivosite
Частично
Да
Да
Нет
Да
Да
Метаданные файла (тип, ссылка) записываются в переменную client_message, файл в платформу не закачивается.
Да
client_message при отправке геолокации: 📍 Location https://www.google.com/maps/@54.855614,83.049903,14z
Частично
В ОК, ФБ, ВК сообщения более 1000 байтов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком
Частично
В переменную channel_visitor_source записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет
Частично
Нет
При использовании Слота Change Chat Mode происходит переключение на оператора. После переключения на оператора диалог завершается и отображается на странице Аналитики(Вкладка Аналитики).
Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов, методом POST в формате application/json. Timeout запроса составляет 3 секунды, кол-во повторных попыток равно 2 (итого 3 попытки по 3 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.
Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.
Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
Чтобы удалить Канал Проекта, нажмите кнопку DELETE.
После выполнения в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки мы получаем событие в client_message, если для данного активированы
диалог в Jivo длится 2 часа, сообщения дойдут до а только в течение этого времени
в приходят клавиатурные кнопки
с помощью слота
в ссылки на изображения автоматически выводят изображение в сообщении
Поддерживается в виджете. Отображение текста, размеченного с помощью , в остальных каналах зависит от самих каналов.Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/)Известные особенности: в Telegram и ВКонтакте не поддерживается, текст приходит без разметки.