Deep Linking / Внешнее связывание
Принцип работы deep link (диплинка) прост, сформированная ссылка отправляет пользователя сразу на нужный маршрут в боте, минуя часть сценария
Введение
В контексте чат-ботов для мессенджеров и социальных сетей смысл диплинка заключается в создании унифицированного идентификатора ресурса (URI), который ссылается на определенный диалоговый сценарий в чат-боте, а не в простом запуске чат-бота сначала.
Самым большим преимуществом диплинков является возможность для маркетологов и разработчиков направлять пользователей непосредственно в определенное место в своем чат-боте с помощью выделенной ссылки.
В цифровом пространстве deep link можно использовать, например, для размещения на рекламных баннерах в социальных сетях, на веб-сайте для отслеживания переходов с уникальных мест, передача токена авторизации в бот прямо с сайта, можно отправить в личном сообщении и многое другое.
Примеры внешнего связывания с вещами в физическом мире: deep link в виде QR на кассовом чеке, в котором содержится идентификатор транзакции, для приглашения пользователя в программу лояльности в чат-боте и начисления баллов за этот заказ; deep link на брошюре на столике в ресторане с вызовом официанта, содержащий номер столика; рекламные флаеры и буклеты; QR в секретном месте в квесте в парке развлечений; QR на объектах в музее или в спортзале и т.д.
В каждом случае пользователь при открытии deep link попадет в чат-бот и активирует определенный сценарий, уникальный для этой конкретной ссылки. Через deep link в чат-бот можно передать параметры, например, токен заказа или идентификатор страницы, с которой совершен переход.
Поддержка deep link реализована для каналов:
Прямая интеграция VK
Прямая интеграция Telegram
Интеграция через Umnico для WhatsApp
Metabot Widget
Создание диплинка
Первым шагом для настройки диплинков в новом боте является настройка Каналов бота. Настройка Каналов производится в разделе главного меню Настройки бота подраздел Каналы.
Например, в рассматриваемом боте настроены два канала:
Metabot Widget
Telegram
Далее для настройки перейдем в раздел Ссылки, который служит для создания диплинка.
Нужно создать Ссылку с типом ссылки Ссылка на бот-скрипт (Deep Link), для этого перейти в раздел главного меню Настройки бота подраздел Ссылки.
По имени, указанном в поле Имя, на диплинк можно ссылаться в макроподстановках. Формат ссылок, как имя диплинка - dpl1:
{{ ^#dpl1 }} - макроссылка, поддерживается в Маршрутах
Текст из поля Текст/приглашение будет добавлен к сообщению пользователя в мессенджере при его переходе по диплинку. Используется только для мессенджера - WhatsApp. Поле URL остаётся не заполненным.
Нажать кнопку Создать.
Настройка маршрутов
Для привязки диплинка к определённому скрипту бота следует создать маршрут со следующими настройками. Настроить маршруты можно в разделе главного меню Настройки бота подраздел Маршруты:
Опция Обработка Deep Link - установить активность;
Опция Действует в диалоге - установить активность, не обязательно для заполнения;
Название - текстовое наименование маршрута;
Скрипт - выбрать скрипт, который должен запускаться в данном маршруте;
Регулярное выражение - значение макроссылки {{ ^#имя_диплинка }}, например,
{{ ^#dpl1 }} - было определено при создании ссылки диплинка.
Нажать кнопку Создать.
Рекомендуется маршрут с диплинком разместить первым в списке всех маршрутов. Для этого можно воспользоваться кнопкой Перетащите для изменения порядка, расположенной в блоке Операции.
Использование диплинков
Внешние мессенджеры
После создания ссылки автоматически создаётся уникальный хеш диплинка и происходит генерация URL для каждого мессенджера.
Перечень мессенджеров определяется из того, к каким Каналам подключен данный бот. Вместо {текста в фигурных скобках} в URL диплинка следует указать соответствующий ID бота в мессенджере.
Пример для Telegram:
В ссылке для Telegram бота - https://app.metabot24.com/deeplink/telegram/{имя-бота-telegram}/ZfxWPpKhehQCrVuE
{имя-бота-telegram} - заменить на deeplink_test_bot
После подстановки ссылку с данным URL можно размещать в интернете. При необходимости к ней можно добавить параметры, как это стандартно делается для http-ссылок.
При переходе по такой ссылке происходит редирект на API соответствующего мессенджера, в нашем примере на Telegram.
Далее при нажатии Send Message тоже автоматически в мессенджер.
После того, как пользователь отреагирует в мессенджере. В примере с Telegram, нажмёт кнопку ЗАПУСТИТЬ, все параметры, которые были указаны в диплинке будут сохранены в переменных соответствующего лида в разделе Лиды на платформе. Бот стартует со скрипта указанного в маршруте для диплинка.
Пример для WhatsApp:
Аналогичным образом настраивается ссылка для WhatsApp бота подключенного через интеграцию Umnico:
https://app.metabot24.com/deeplink/whatsapp/{телефон-whatsapp}/f2cdWYPOADnluTTT
{телефон-whatsapp} - заменить на номер телефона в формате 79ххххххххх
После подстановки ссылку с данным URL можно размещать в интернете. При необходимости к ней можно добавить параметры, как это стандартно делается для http-ссылок.
При переходе по такой ссылке происходит редирект на API соответствующего мессенджера, в нашем примере на WhatsApp.
Далее при нажатии Перейти в чат тоже автоматически в мессенджер.
После того, как пользователь отреагирует в мессенджере. В примере с WhatsApp, нажмёт кнопку Отправки сообщения, произвойдет старт бота со скрипта указанного в маршруте для диплинка.
Metabot Widget
Ключевым моментом здесь является задание атрибута data-deeplink.
Шаблон ссылки-диплинка выводится в разделе Ссылки. При условии, что у бота подключен канал Metabot Widget.
В настройках канала Metabot Widget в поле Всплывающий HTML можно задать HTML-код.
В значении атрибута следует указать хеш, который был автоматически сгенерирован при создании диплинка.
Описанный блок будет всплывать при наведении мышки на кнопку виджета.
Для передачи дополнительных параметров с последующим сохранением их в параметрах Лида используются атрибуты href и data-deeplink тега гиперссылки.
Например, после перехода по следующей гиперссылкеуказанной в настройках виджета:
В разделе Лиды на платформе, по соответствующему лиду, будут переданы и сохранены в параметрах лида следующие параметры:
boom = bazz
utm-foo = bar
Last updated