Jivo
Интеграция сервиса Jivo с платформой Metabot24
Last updated
Интеграция сервиса Jivo с платформой Metabot24
Last updated
Интеграции сервиса Jivo с Metabot24 позволяет подключить бота в диалоги с клиентами в любых каналах связи. При этом, все новые диалоги вначале будут отправляться боту. По сценарию бот может переключить диалог на оператора.
История диалогов с ботами автоматически сохраняется в архиве.
На платформе Metabot24 в настройках своего бота необходимо выполнить следующие действия:
Перейти в раздел Настройки бота подраздел Каналы;
Нажать кнопку Новая привязка и выбрать канал Jivo;
Установите активность параметра Использовать inline-кнопки;
Остальные параметры пока можно оставить без изменений, по умолчанию и сохранить настройку.
Далее нажмите пункт Вебхук и скопируйте сгенерированный вебхук. При копировании обратите внимание, чтобы не было вначале и в конце строки знаков «пробел».
После получения вебхука, вам необходимо будет зайти в приложение Jivo в раздел Каналы связи, добавить канал, например, Telegram.
Подключить канал и далее провести настройку раздела Настройки интеграции для разработчиков. Для этого необходимо включить опцию Включить Webhooks и заполнить поле URL для Webhooks вставить скопированный вебхук, полученный в Metabot.
Аналогично сделать настройку для виджета и всех подключенных каналов.
Перейдите по ссылке https://app.jivosite.com/settings/integrations/add-bot/31 и настройте расширение Metabot для подключения бота:
Затем настройте внешний вид бота, который будут видеть посетители, загрузив логотип компании или специальную иконку бота, указав имя и должность.
Перейдите на платформу Metabot24, в настройках бота в разделе Каналы скопируйте в буфер обмена токен, как показано на рисунке.
Далее укажите токен бота из личного кабинета Metabot24 и выберите, на каких каналах связи будет подключен бот.
При копировании токена будьте внимательны, чтобы в начале и в конце строки не было знаков «пробел».
После нажатия кнопки Сохранить, интеграция будет подключена и данный бот отобразится в подключенных системах. Обратите внимание, что когда добавляются новые каналы и интегрируются с Metabot24, то необходимо не забывать включать в разделе Опции активность для новых каналов.
На этом всё. Бот подключен и готов к работе. Мы рекомендуем вам провести несколько тестовых диалогов, чтобы убедиться в правильности настройки сценариев. Увидеть активность пользователей при взаимодействии с ботом вы можете в разделе Лиды в личном кабинете Metabot24.
Если по части каналов не поддерживаются или не корректно работают кнопки, то необходима настройка выборочного включения кнопок по каналам связи Jivo.
Данную настройку необходимо сделать вначале подключения канала Jivo. Для этого определить выбор в канале для каких мессенджеров используются кнопки.
Если мессенджер не определен, то параметр берется из глобальной настройки канала из параметра Использовать inline-кнопки.
Если мессенджер определен, по параметр берется из следующего перечисления:
Определяется общей настройкой канала - установлен по умолчанию;
Да - использовать в канале кнопки;
Нет - не использовать в канале кнопки.
Теперь признак поиска мессенджера - это регулярное выражение, а также можно вводить несколько регулярных выражений, разделяя их символом |||
если хотим искать частичное вхождение указанного кода среди sender.url, то не указываем начало и конец строки в регулярном выражении, т.е. записываем просто строку metabotbot
если необходимо искать соответствие строки с sender.url, то указываем вначале ^, а в конце $, например, ^metabotbot$
если необходимо задействовать несколько регулярных выражений, то разделяем их |||, например, ^telegram$|||^tele.*$
Проведем настройку кодов виджета и мессенджеров для определения наличия кнопок в мессенджере при обращении лида.
Jivo Widget - канал поддерживает кнопки, для виджета строка содержит https://адрес-сайта.com
Поскольку код поиска - это регулярное выражение, то можно использовать любые корректные конструкции применимые к регулярным выражениям, а это значит не забываем экранировать спец символы. Если хотим ясно искать точку то пишем \. или вместо https:// нужно писать https:\/\/ - иначе регулярка будет некорректной и мессенджер не будет определен.
Например, если виджет установлен для всех страницах сайта: ^https://metabot24.info/.*$
Параметр Использовать inline-кнопки для мессенджеров - Да
Telegram - канал поддерживает не более 7 кнопок в меню.
Например, telegram
Параметр Использовать inline-кнопки для мессенджеров - Да
Viber - канал поддерживает не более 7 кнопок в меню, для канала необходимо указать название группы в viber.
Например, ^metabotjivo$
Параметр Использовать inline-кнопки для мессенджеров - Да
ВКонтакте - канал не поддерживает кнопки, содержит название группы, но по факту передается название канала.
Если в Jivo настроена омниканальность, то могут возникнуть проблемы, поэтому рекомендуем подключать каждый мессенджер в Jivo как новый канал
Например, наименование группы полностью Metabot_Jivosite или часть наименования обрамленная спецсимволами ^Metabot.*$
Параметр Использовать inline-кнопки для мессенджеров - Нет
Instagram - канал не поддерживает кнопки, содержит имя бизнес-аккаунта, но по факту передается название канала.
Например, наименование группы полностью Metabot24 или часть наименования обрамленная спецсимволами ^Metabot.*$
Параметр Использовать inline-кнопки для мессенджеров - Нет
Facebook - канал не поддерживает кнопки, содержит наименование группы, но по факту передается название канала.
Например, наименование группы полностью Metabot24 или часть наименования обрамленная спецсимволами ^Metabot.*$
Параметр Использовать inline-кнопки для мессенджеров - Нет
Avito - канал не поддерживает кнопки, содержит название канала.
Например, Avito
Параметр Использовать inline-кнопки для мессенджеров - Нет
Apple Business Chat - канал не поддерживает кнопки, содержит название канала.
Параметр Использовать inline-кнопки для мессенджеров - Нет
Одноклассники - канал не поддерживает кнопки, содержит название группы, но по факту передается название канала.
Например, наименование группы полностью Metabot_Jivosite или часть наименования обрамленная спецсимволами ^Metabot.*$
Параметр Использовать inline-кнопки для мессенджеров - Нет
Корректно настроенный канал должен выглядеть, например, так:
После общения Лида (пользователя) с ботом можно в дальнейшем просмотреть его контактные данные: мессенджер, с которого общались, имя, телефон, e-mail.
Для этого в сервисе Jivo необходимо выполнить следующие действия:
По тестовому диалогу с каждого канала взаимодействия надо принять диалог оператором
Далее завершить диалог с Оператором или дождаться, когда это произойдет автоматически через некоторое время отсутствия активности:
При изменении Оператором контактных данных по Лиду, когда оператор добавляет номер телефона или e-mail в карточке клиента в Jivo:
На платформе Metabot24 в истории сообщений хранится параметр widget_id, который является уникальным для каждого канала. По тестовому Лиду перейдите в историю сообщений:
Далее перейдите по ссылке в webhooks-log:
В строках с параметрами в поле Event Type = chat_accepted/chat_finished/chat_updated необходимо открыть ссылку Show Formatted Payload
Cкопировать код параметра widget_id:
Открыть на редактирование канал Jivo в настройках бота:
Вставить скопированный код в соответствующее поле мессенджера и сохранить настройки:
После этого при получении последующих CRM-вебхуков из этого канала для лидов будет прописываться соответствующий мессенджер, а также и все контактные данные из карточки лида отредактированные в сервисе Jivo.
Bot API сервиса Jivo не поддерживает вложения, поэтому изображения и прочие вложения отправляемые с платформы Metabot24 клиенту приходят в виде текста URL:
Telegram автоматически делает такую ссылку активной и даже подгружает изображение;
Чат-виджет ссылку передает просто текстом и не кликабельной, поэтому ее можно только выделить и скопировать текст, далее вставить в адресную строку браузера.
2. Если в настройках канала включить параметр Использовать inline-кнопки, то кнопки прорисовываются и становятся кликабельны.
3. При подключении Оператора в чат с Лидом сервис Jivo отправляет сообщение в мессенджер о присоединении Оператора к чату. При выходе Оператора из чата сервис Jivo не отправляет никаких сообщений и в боте также не отображается, что Оператор вышел из чата с Лидом.
4. После завершения чата Оператором или если это произошло автоматически через определённое время простоя, теряется возможность отправки ботом сообщений в этот чат. Возможность возобновляется после перезагрузки данного чата Оператором или Лидом.
5. Имеется возможность переключения на Оператора с помощью команд в боте, обратно переключение на бота может сделать только Оператор - Выйти из чата, но Лид должен заново начать диалог, написав сообщение, иначе бот не возобновит работу.
6. Если Операторов нет онлайн, то при отправке сообщения приходит вебхук соответствующего события и в боте можно использовать вызов скрипта с типом Нет доступных операторов.
7. При перенаправлении чата от одного Оператора другому Оператору, никаких событий от сервиса Jivo не поступает в Metabot24 и этот момент не обрабатывается на платформе, в бота не отправляются уведомительные сообщения.
8. Рекомендуемые настройки канала, для отображения чата.
Можно настроить автоматические действия и поведение чат-бота при недоступности Операторов, для этого в настройках канала в разделе Автоматические действия отключить все пункты и добавить новый пункт Показать чат-бот при самом первом посещении сайта, делается это с помощью кнопки Добавить действие.
В новом пункте указать следующие рекомендованные настройки по условиям:
Время на сайте
Количество визитов
Время от последнего активного приглашения
При таких настройках окно чата будет показываться пользователю при первом посещении через 20 сек.
В разделе Форма контактов необходимо отключить запрос формы контактов клиента.
В разделе Кнопки в чате можно настроить поведение чата при условии, что пользователь еще ничего не написал. Это рекомендуется настраивать, чтоб при повторном обращении в бота спустя время, пользователь мог нажать на кнопку и активировать бота или при первом посещении чата - окно чата не было пустым.
На текущий момент Jivo обеспечивает следующий список каналов связи для возможного подключения:
