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

Last updated