METABOT24
Search…
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 тега гиперссылки.
Например, после перехода по следующей гиперссылкеуказанной в настройках виджета:
<a href="?utm-foo=bar" data-deeplink="ZfxWPpKhehQCrVuE" data-boom="bazz">
В разделе Лиды на платформе, по соответствующему лиду, будут переданы и сохранены в параметрах лида следующие параметры:
  • boom = bazz
  • utm-foo = bar
Copy link
Outline
Введение
Создание диплинка
Настройка маршрутов
Использование диплинков