Перейти к основному контенту

Deep Linking

В контексте чат-ботов для мессенджеров и социальных сетей смысл диплинка заключается в создании унифицированного идентификатора ресурса (URI), который ссылается на определенный диалоговый сценарий в чат-боте, а не в простом запуске чат-бота сначала.

Самым большим преимуществом диплинков является возможность для маркетологов и разработчиков направлять пользователей непосредственно в определенное место в своем чат-боте с помощью выделенной ссылки.

В цифровом пространстве deep link можно использовать, например, для размещения на рекламных баннерах в социальных сетях, на веб-сайте для отслеживания переходов с уникальных мест, передача токена авторизации в бот прямо с сайта, можно отправить в личном сообщении и многое другое.

Примеры внешнего связывания с вещами в физическом мире:

  • Deep link в виде QR на кассовом чеке, в котором содержится идентификатор транзакции, для приглашения пользователя в программу лояльности в чат-боте и начисления баллов за этот заказ;
  • Deep link на брошюре на столике в ресторане с вызовом официанта, содержащий номер столика;
  • Рекламные флаеры и буклеты;
  • QR в секретном месте в квесте в парке развлечений;
  • QR на объектах в музее или в спортзале и т.д.

В каждом случае пользователь при открытии deep link попадет в чат-бот и активирует определенный сценарий, уникальный для этой конкретной ссылки. Через deep link в чат-бот можно передать параметры, например, токен заказа или идентификатор страницы, с которой совершен переход.

Поддержка deep link реализована для каналов:

  • Прямая интеграция VK;
  • Прямая интеграция Telegram;
  • Интеграция через Umnico для WhatsApp;
  • Metabot Widget.

Так как диплинки напрямую взаимосвязаны с каналами, в первую очередь следует настроить каналы, соответствующие вашим требованиям, в боте.

 Что такое каналы и как их настраивать можно узнать в разделе Каналы

Далее можно перейти к созданию диплинков. Это можно сделать в верхнем меню  в разделе Настройки бота подразделе Ссылки.

image.png

В меню создания ссылок будут храниться все настроенные вами диплинки и ссылки других типов. Создание новой ссылки производится любой из кнопок Создать.

Снимок экрана 2023-03-01 113714.png

Перед вами откроется диалоговое окно со следующими полями:

image.png

  • Имя — имя диплинка, по которому на него можно будет ссылаться ({{ ^#имя_диплинка }} - макроссылка, поддерживаемая в Маршрутах);
  • Текст/приглашение — текст который будет добавлен к сообщению пользователя в мессенджере при его переходе по диплинку. Используется только для мессенджера - WhatsApp;
  • Тип ссылки — для создания диплинка из выпадающего списка следует выбрать пункт Ссылка на бот-скрипт (Deep Link);
  • URL — автозаполняемое поле, url ссылка диплинка.

После нажатия кнопки Создать диплинк появится в меню ссылок:

image.png

У диплинков, как и у ссылок есть статистика переходов. Она может вестись при обычных переходах и при переходе по диплинку с параметром start. При получении команды /start происходят следующие действия:

    Пользователь кликает на ссылку (например, tg://resolve?domain=MyBot&start=promo123); Бот обрабатывает команду /start, извлекает параметр promo123; Система увеличивает счётчик переходов для MyBot с параметром promo123; Бот отвечает по заданному скрипту.

    Последним этапом является добавление маршрута привязанного к диплинку.

    Что такое маршруты и как их создавать вы можете узнать в разделе Маршруты

    Особенности создания маршрута с диплинком:

    image.png

    • Поле Обработка Deep Link должно быть активно;
    • В поле регулярное выражение следует ввести макроссылку диплинка в формате {{ ^#имя_диплинка }}.

    Именно этот маршрут будет активирован при переходе пользователя по диплинку.

    Использование deep link

    Внешние мессенджеры

    После создания ссылки автоматически создаётся уникальный хеш диплинка и происходит генерация URL для каждого мессенджера. Перечень мессенджеров определяется из того, к каким Каналам подключен данный бот.

    Telegram

    В ссылке для Telegram бота — ( https://app.metabot24.com/deeplink/telegram/t.me/{имя-бота-telegram}/... ) {имя-бота-telegram} — следует заменить на соответствующий ID бота в мессенджере.

    Для открытия бота в мобильном приложении через ссылку, необходимо использовать схему tg:// — ( tg://resolve?domain={имя-бота}... ).

    При использовании ссылки с параметрами можно передавать дополнительную информацию для бота через запросы URL. Например:

      Для мобильного устройства tg://resolve?domain={имя-бота}&start={параметр}; Для веб страниц https://t.me/{имя-бота}?start={параметр}.
      Другие

      В ссылке для WhatsApp бота — ( https://app.metabot24.com/deeplink/whatsapp/{телефон-whatsapp}/... ) {телефон-whatsapp} — следует заменить на номер телефона в формате 79ххххххххх соответствующий боту.

      После подстановки ссылку с данным URL можно размещать в интернете. При необходимости к ней можно добавить параметры, как это стандартно делается для http-ссылок.

      image.png

      После того, как пользователь отреагирует в мессенджере, все параметры, которые были указаны в диплинке будут сохранены в переменных соответствующего лида в разделе Лиды на платформе. Бот стартует со скрипта указанного в маршруте для диплинка.

      Для использования полученных из диплинка параметров можно воспользоваться следующим кодом:

      let jsonD = lead.getJsonAttr('sys_last_script_request_params');
let foo = jsonD.deeplink.foo;
let boom = jsonD.deeplink.boom;

lead.setAttr("foo", foo);
lead.setAttr("boom", boom);