Что такое диплинк в Telegram

Диплинк — это специальная ссылка, которая ведет в Telegram-бот на определенный сценарий или действие. С их помощью можно передавать полезный контекст: например, теги.

В TextBack диплинки позволяют автоматически подписывать пользователей на уведомления и запускать чат-ботов в Telegram.

Пример диплинка: https://t.me/TextBackSupportBot?start=oZOpD9ro

Каждый диплинк состоит из трех частей:

1. Короткий домен Telegram: https://t.me

2. Username бота Telegram: tb_autotest_bot

3. Уникальный короткий код диплинка: start=oZOpD9ro

В TextBack уже используются диплинки на разные мессенджеры — в кнопках виджета подписок или сгенерированные вручную (с привязкой к виджету). Переход по диплинку запускает настроенный виджет подписок благодаря параметру в ссылке.

Ключевое отличие новых диплинков Telegram — привязка к конкретному чат-боту, а не к виджету подписок.

Как создать диплинк

Для создания диплинка:

1. Зайдите в раздел «Чат-боты».

2. Откройте чат-бот и перейдите в настройки стартового блока. Диплинк добавлен как новый тип триггера для запуска бота. Кнопка создания активна, только если в блоке «Канал» выбран Telegram.

3. Откройте форму создания диплинка. В ней три поля: название, канал и теги.

Название — обязательное поле. Название диплинка будет отображаться в вашем личном кабинете TextBack.

  • Можно использовать кириллицу, латиницу, цифры и символы.
  • Может содержать до 50 символов.

Канал — конкретный бот Telegram, для которого создается диплинк. Это также обязательное поле.

  • Для выбора доступны только боты, добавленные в чат-бот.
  • Можно выбрать только 1 канал.

Теги — необязательное поле.

  • В одном диплинке можно добавлять до 30 тегов.
  • Можно выбрать существуюший  тег или создать новый прямо в форме.

4. После заполнения всех обзательных полей нажмите кнопку «Создать». Отлично, диплинк успешно создан и привязан к триггерам чат-бота.

Отображение диплинка

Диплинки отображаются в нескольких местах:

  • В боковом меню стартового блока — список всех диплинков отсортирован по дате.

  • В диаграмме бота — диплинк обозначен отдельным блоком.

  • В списке чат-ботов — в разделе триггеров.

Как работает диплинк

  • Пользователь кликает по диплинку.
  • Открывается Telegram-бот, пользователь нажимает «Start».
  • Telegram передает код диплинка в TextBack. Пользователь не видит код в мессенджере, но он отображается в TextBack.

  • TextBack проверяет код и выполняет действия:
  1. Подписывает пользователя на уведомления.
  2. Добавляет теги.
  3. Запускает нужный сценарий бота.

 

Как посмотреть статистику по диплинкам

Данные о запуске чат-бота через диплинки доступны в разделе статистики. Попасть в него можно через настройки чат-бота 2 способами:

  • Перейти в боковое меню стартового блока и нажать на шестеренку у заголовка секции «Диплинка» (такой способ работает, только если активен хотя бы 1 диплинк).

  • Открыть параметры чат-бота в верхнем правом углу, затем нажать «Диплинки» (точка входа доступна всегда).

Оба способа открывают модальное окно с таблицей статистики:

В таблице отображается статистика:

  • Название и ссылка диплинка.
  • Канал, к которому он привязан.
  • Какие теги навешиваются.
  • Сколько уникальных пользователей активировали этот диплинк.

Что будет, если удалить канал

  • Если канал удален, диплинк временно не работает, но не исчезает.
  • Как только канал добавят обратно, диплинк снова станет активным.

Что будет, если удалить диплинк в TextBack

Если вы решите удалить диплинк,  это повлияет на его работу и связанные с ним процессы.

При удалении диплинк больше не активирует чат-бот.

  • После удаления диплинк отвязывается от чат-бота в TextBack.
  • Это означает, что переход по этой ссылке не будет запускать сценарии чат-бота или виджета подписок.
  • Однако сама ссылка продолжает работать и открывать Telegram-бота, но без выполнения настроенных действий.
  • Если пользователи уже переходили по диплинку до его удаления, их подписки и навешанные теги останутся в системе.
  • Удаление диплинка не влияет на ранее созданные данные.
  • После удаления диплинк больше не отображается в списке триггеров чат-бота.

Восстановление диплинка

  • Если вы удалили диплинк случайно, его нельзя восстановить. Придется создать новый диплинк с теми же параметрами.
  • Новая ссылка будет отличаться от старой, так как каждый диплинк имеет уникальный код.