Jivo
Last updated
Last updated
— одна из популярных омниканальных платформ, предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете.
у необходимо создать и настроить с ом “Jivo”.
Кликните по кнопке настроек а.
Нажмите кнопку Add channel.
Откроется панель выбора .
Выберите .
Откроется панель создания .
По необходимости пропишите заголовок для данного в поле названия с плейсхолдером New channel.
В поле Jivo token будет указан автоматически сгенерированный токен, который потребуется указать в настройках .
По необходимости переключите тумблер Receive service messages, чтобы получать .
Для сохранения без его активации, нажмите кнопку CREATE.
Для сохранения и активации , нажмите кнопку CREATE & ACTIVATE.
будет сохранен и активирован, если:
обучен;
токен в поле Jivo token уникален (нет ли активных того же типа с тем же значением в поле);
будет доступен адрес ;
удастся зарегистрировать вебхук канала.
будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
Для отмены создания нажмите кнопку CANCEL.
Для собеседников боты в Jivo выглядят как операторы (виртуальные-сотрудники).
Заполните следующие поля:
Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo;
Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника;
Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника.
Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить.
Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
Изменения будут применены, если:
удастся зарегистрировать вебхук канала.
Изменения не будут применены, если одно или больше условий не будут выполнены.
удастся зарегистрировать вебхук канала.
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 записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет
Частично
Нет
Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов, методом POST в формате application/json. Timeout запроса составляет 3 секунды, кол-во повторных попыток равно 2 (итого 3 попытки по 3 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.
Примечание: В данной статье рассматривается только интеграция Jivo с ботами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в Jivo
Зайдите в аккаунт .
Перейдите по ссылке
Скопированный с Платформы токен вставьте в поле Токен бота.
Для редактирования , необходимо кликнуть по его иконке на карточке а.
Чтобы применить изменения к активированному , нажмите кнопку APPLY.
обучен;
токен в поле Jivo token уникален (нет ли активных того же типа с тем же значением в поле);
будет доступен адрес ;
Чтобы деактивировать , нажмите кнопку DEACTIVATE.
Чтобы применить изменения к деактивированному , нажмите кнопку SAVE.
Чтобы применить изменения и активировать , нажмите кнопку SAVE & ACTIVATE.
Изменения будут применены и будет активирован, если:
обучен;
токен в поле Jivo token уникален (нет ли активных того же типа с тем же значением в поле);
будет доступен адрес ;
Изменения будут применены, но не будет активирован, если одно или больше условий не будут выполнены.
Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
Чтобы удалить , нажмите кнопку DELETE.
После выполнения в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки мы получаем событие в client_message, если для данного активированы
диалог в Jivo длится 2 часа, сообщения дойдут до а только в течение этого времени
в приходят клавиатурные кнопки
с помощью слота
в ссылки на изображения автоматически выводят изображение в сообщении
Поддерживается в виджете. Отображение текста, размеченного с помощью , в остальных каналах зависит от самих каналов.Поддерживаются следующие типы разметки:*курсив*_курсив___жирный шрифт__*__жирный курсив__*[ссылка](http://www.example.com/)Известные особенности: в Telegram и ВКонтакте не поддерживается, текст приходит без разметки.
При использовании а происходит переключение на оператора. После переключения на оператора диалог завершается и отображается на странице Аналитики().