Когда реклама ведёт в бота, обычная ссылка создаёт две проблемы: пользователи из разных объявлений видят одно и то же приветствие, а источник заявки теряется. Deep link в Telegram Ads решает обе: передаёт боту короткий код, по которому тот выбирает ветку диалога и запоминает, откуда пришёл человек.

Стратегию запуска мы разбирали в статье о том, как продвигать Telegram-бота через Telegram Ads. Здесь — только формат ссылки, обработка параметра и проверка перед публикацией объявлений.

Что открывает диплинк из рекламы и чего он не делает

Путь пользователя выглядит так:

  1. Клик по кнопке объявления.
  2. Переход по ссылке вида t.me/имя_бота?start=код.
  3. Открытие чата с ботом и нажатие кнопки «Запустить».
  4. Бот получает команду /start код.
  5. Логика бота сопоставляет код с нужным приветствием или веткой сценария.

Условный пример: для кампании онлайн-школы диплинк на бота в Telegram Ads может выглядеть как t.me/demo_course_bot?start=tga_lesson — бот получит команду /start tga_lesson. Имя бота и код вымышлены.

Важно понимать границы. Ссылка с параметром start сама по себе не открывает конкретный экран: она лишь передаёт значение. Что увидит пользователь, решает код бота или настройки конструктора. Если обработчика нет, человек получит стандартное приветствие.

Чем различаются форматы назначения:

  • ссылка на бота без параметра открывает чат, но бот не знает источник перехода;
  • ссылка с start открывает чат и передаёт код;
  • ссылка на Mini App запускает веб-интерфейс внутри Telegram — это отдельная механика;
  • ссылка на внешний сайт уводит пользователя из Telegram, и источник отслеживается веб-аналитикой.

Доступность форматов зависит от типа кампании и интерфейса рекламного кабинета, поэтому условия стоит сверять с актуальными правилами.

Как подготовить ссылку и сценарий бота

Согласно документации Telegram, в параметре допустимы символы A–Z, a–z, 0–9, подчёркивание и дефис, а длина ограничена 64 символами. Для значений с другими символами Telegram рекомендует кодирование base64url. Чтобы ссылка с параметром start сработала, имя бота в ней должно точно совпадать с username.

Не записывайте в параметр телефоны, email, токены и другие персональные данные или секреты: ссылка видна каждому, кто нажал на объявление. Надёжнее передавать короткий код, а расшифровку хранить на стороне бота — в таблице или базе, где коду соответствуют кампания, объявление и сценарий.

Пример для двух объявлений одной кампании (названия и коды вымышлены):

ОбъявлениеСсылкаСтартовое сообщение бота
Бесплатный урок по таргетуt.me/demo_course_bot?start=tga_lessonПриветствие и кнопка для просмотра урока
Программа курса и тарифыt.me/demo_course_bot?start=tga_priceПрограмма, тарифы и кнопка «Оставить заявку»

Каждая ссылка на сценарий Telegram-бота должна вести к ответу, который совпадает с обещанием объявления. При этом ветвление реализует логика бота, а не Telegram Ads: рекламный кабинет только отправляет пользователя по указанному адресу.

Как поставить ссылку в Telegram Ads без проблем с модерацией

Правила Telegram Ads прямо разрешают добавлять start-параметр, если назначение объявления — бот. Помимо основной ссылки, в тексте можно указать одну дополнительную, и обе должны вести в одно и то же место. Сокращатели ссылок и IP-адреса вместо адреса запрещены, даже если в итоге они ведут на допустимое назначение, — использовать перенаправления как обход правил нельзя.

Перед отправкой на модерацию проверьте:

  • текст объявления обещает то, что пользователь видит сразу после запуска бота;
  • у бота есть аватар и заполненное описание;
  • команды и кнопки работают и на мобильных устройствах, и на десктопе;
  • бот действительно ведёт диалог, а не просто перенаправляет на другой ресурс.

Правила платформы периодически обновляются, поэтому перед публикацией перепроверьте их актуальную версию. Ссылка на сценарий бота в Telegram Ads не даёт преимуществ при модерации: её проверяют по тем же требованиям, что и любую другую.

Как проверить переход и источник заявки

Deep link в Telegram Ads полезен только тогда, когда код доходит до бота и сохраняется. Поэтому перед запуском протестируйте минимум четыре случая:

  1. Новый пользователь открывает бота впервые — должна прийти команда /start с кодом и нужное приветствие.
  2. Пользователь уже запускал бота раньше — проверьте, получает ли бот параметр повторно и не перезаписывается ли сохранённый источник без вашего решения.
  3. Код неверный или пустой — бот показывает общее приветствие, а не ошибку и не молчит.
  4. Переход с мобильного приложения и с десктопа — сценарий срабатывает одинаково.

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

Схема учёта: ID объявления или варианта → код start → диалог в боте → заявка → CRM.

Клики, запуски бота и целевые заявки — разные показатели. Клики считает рекламный кабинет, запуски — сам бот, заявки — CRM или таблица. Эти числа не совпадают: часть людей не нажмёт «Запустить», часть не дойдёт до формы. Сквозная атрибуция появится, только если код из параметра передаётся вместе с заявкой. Подробнее о связке рекламы и продаж — в материале о том, как отследить заявки и продажи из Telegram Ads.

Когда диплинк бота в Telegram Ads проверен на всех сценариях, можно переходить к запуску объявлений. Для этого понадобится кабинет Telegram Ads с пополнением и инструментами управления — его можно открыть и пополнить через eProfit. Обработку параметра в самом боте при этом настраивает его владелец или разработчик.

·
Читать 5 мин
·
10

Диплинк бота в Telegram Ads: как передать параметр и запустить нужный сценарий

Диплинк бота в Telegram Ads: как передать параметр и запустить нужный сценарий

Когда реклама ведёт в бота, обычная ссылка создаёт две проблемы: пользователи из разных объявлений видят одно и то же приветствие, а источник заявки теряется. Deep link в Telegram Ads решает обе: передаёт боту короткий код, по которому тот выбирает ветку диалога и запоминает, откуда пришёл человек.

Стратегию запуска мы разбирали в статье о том, как продвигать Telegram-бота через Telegram Ads. Здесь — только формат ссылки, обработка параметра и проверка перед публикацией объявлений.

Что открывает диплинк из рекламы и чего он не делает

Путь пользователя выглядит так:

  1. Клик по кнопке объявления.
  2. Переход по ссылке вида t.me/имя_бота?start=код.
  3. Открытие чата с ботом и нажатие кнопки «Запустить».
  4. Бот получает команду /start код.
  5. Логика бота сопоставляет код с нужным приветствием или веткой сценария.

Условный пример: для кампании онлайн-школы диплинк на бота в Telegram Ads может выглядеть как t.me/demo_course_bot?start=tga_lesson — бот получит команду /start tga_lesson. Имя бота и код вымышлены.

Важно понимать границы. Ссылка с параметром start сама по себе не открывает конкретный экран: она лишь передаёт значение. Что увидит пользователь, решает код бота или настройки конструктора. Если обработчика нет, человек получит стандартное приветствие.

Чем различаются форматы назначения:

  • ссылка на бота без параметра открывает чат, но бот не знает источник перехода;
  • ссылка с start открывает чат и передаёт код;
  • ссылка на Mini App запускает веб-интерфейс внутри Telegram — это отдельная механика;
  • ссылка на внешний сайт уводит пользователя из Telegram, и источник отслеживается веб-аналитикой.

Доступность форматов зависит от типа кампании и интерфейса рекламного кабинета, поэтому условия стоит сверять с актуальными правилами.

Как подготовить ссылку и сценарий бота

Согласно документации Telegram, в параметре допустимы символы A–Z, a–z, 0–9, подчёркивание и дефис, а длина ограничена 64 символами. Для значений с другими символами Telegram рекомендует кодирование base64url. Чтобы ссылка с параметром start сработала, имя бота в ней должно точно совпадать с username.

Не записывайте в параметр телефоны, email, токены и другие персональные данные или секреты: ссылка видна каждому, кто нажал на объявление. Надёжнее передавать короткий код, а расшифровку хранить на стороне бота — в таблице или базе, где коду соответствуют кампания, объявление и сценарий.

Пример для двух объявлений одной кампании (названия и коды вымышлены):

ОбъявлениеСсылкаСтартовое сообщение бота
Бесплатный урок по таргетуt.me/demo_course_bot?start=tga_lessonПриветствие и кнопка для просмотра урока
Программа курса и тарифыt.me/demo_course_bot?start=tga_priceПрограмма, тарифы и кнопка «Оставить заявку»

Каждая ссылка на сценарий Telegram-бота должна вести к ответу, который совпадает с обещанием объявления. При этом ветвление реализует логика бота, а не Telegram Ads: рекламный кабинет только отправляет пользователя по указанному адресу.

Как поставить ссылку в Telegram Ads без проблем с модерацией

Правила Telegram Ads прямо разрешают добавлять start-параметр, если назначение объявления — бот. Помимо основной ссылки, в тексте можно указать одну дополнительную, и обе должны вести в одно и то же место. Сокращатели ссылок и IP-адреса вместо адреса запрещены, даже если в итоге они ведут на допустимое назначение, — использовать перенаправления как обход правил нельзя.

Перед отправкой на модерацию проверьте:

  • текст объявления обещает то, что пользователь видит сразу после запуска бота;
  • у бота есть аватар и заполненное описание;
  • команды и кнопки работают и на мобильных устройствах, и на десктопе;
  • бот действительно ведёт диалог, а не просто перенаправляет на другой ресурс.

Правила платформы периодически обновляются, поэтому перед публикацией перепроверьте их актуальную версию. Ссылка на сценарий бота в Telegram Ads не даёт преимуществ при модерации: её проверяют по тем же требованиям, что и любую другую.

Как проверить переход и источник заявки

Deep link в Telegram Ads полезен только тогда, когда код доходит до бота и сохраняется. Поэтому перед запуском протестируйте минимум четыре случая:

  1. Новый пользователь открывает бота впервые — должна прийти команда /start с кодом и нужное приветствие.
  2. Пользователь уже запускал бота раньше — проверьте, получает ли бот параметр повторно и не перезаписывается ли сохранённый источник без вашего решения.
  3. Код неверный или пустой — бот показывает общее приветствие, а не ошибку и не молчит.
  4. Переход с мобильного приложения и с десктопа — сценарий срабатывает одинаково.

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

Схема учёта: ID объявления или варианта → код start → диалог в боте → заявка → CRM.

Клики, запуски бота и целевые заявки — разные показатели. Клики считает рекламный кабинет, запуски — сам бот, заявки — CRM или таблица. Эти числа не совпадают: часть людей не нажмёт «Запустить», часть не дойдёт до формы. Сквозная атрибуция появится, только если код из параметра передаётся вместе с заявкой. Подробнее о связке рекламы и продаж — в материале о том, как отследить заявки и продажи из Telegram Ads.

Когда диплинк бота в Telegram Ads проверен на всех сценариях, можно переходить к запуску объявлений. Для этого понадобится кабинет Telegram Ads с пополнением и инструментами управления — его можно открыть и пополнить через eProfit. Обработку параметра в самом боте при этом настраивает его владелец или разработчик.

На главную блога
Филипп Левин
Автор статьи
Филипп Левин
Руководитель коммерческого направления eProfit.me

Часто задаваемые вопросы

Можно ли одной ссылкой вести пользователей в разные ветки бота? ▾
Одна ссылка передаёт один код, поэтому стартовая ветка у неё тоже одна. Для разных веток нужны разные коды. Дальше внутри сценария бот может разветвлять диалог кнопками.
Что произойдёт, если бот не обрабатывает параметр start? ▾
Бот получит команду /start с кодом, но проигнорирует значение и покажет стандартное приветствие. Источник перехода при этом не сохранится.
Как отличить заявки из двух объявлений, ведущих в одного бота? ▾
Задайте каждому объявлению свой код, сохраняйте его в карточке пользователя и передавайте вместе с заявкой в CRM. Тогда в отчёте будет видно, какое объявление привело клиента.
Нужно ли ставить обычные UTM-метки на ссылку бота? ▾
Нет. Ссылка с параметром start передаёт боту только это значение, поэтому метку источника кодируют в нём. UTM-метки нужны на следующем шаге, если бот ведёт пользователя на сайт.
Что проверить, если после клика открывается бот, но запускается не тот сценарий? ▾
Сверьте код в ссылке объявления с кодом в базе бота: регистр, лишние символы, опечатки. Затем проверьте, не срабатывает ли ветка по умолчанию раньше нужной и не перезаписывает ли бот источник при повторном /start.