Глубокие ссылки `t.me/your_bot?start=...`

Telegram позволяет отправлять клиента в бота с параметром. Ссылка выглядит так:

`` https://t.me/your_bot?start=promo2026 ``

Когда клиент по ней переходит, в боте автоматически отправляется команда /start promo2026. Это удобно для отслеживания источников трафика и быстрого «приземления» клиента на нужный сценарий.

Зачем это нужно

Реклама. В рекламной кампании ставите ссылку ?start=ad_fb_october — потом видите, кто пришёл с Facebook-рекламы октября.
Партнёрские ссылки. ?start=ref_partner123 — клиент пришёл от партнёра 123.
Сегментация. На сайте кнопка «Купить курс» → ссылка ?start=course_baking. В сценарии понимаем, что клиент сразу хочет курс «Выпечка».

Как сделать ссылку

Просто допишите ?start=значение к адресу бота:

https://t.me/your_bot?start=promo2026
t.me/your_bot?start=ad_october

Значение может быть из латинских букв, цифр, дефисов и подчёркиваний. До 64 символов.

Как бот «видит» параметр

Когда клиент переходит по ссылке, в боте появляется команда /start promo2026. В нашем кабинете эта команда приходит как обычное сообщение клиента, с текстом /start promo2026.

В сценариях триггер «Команда» срабатывает на start, и сценарий стартует. Параметр виден в тексте первого сообщения клиента в этом диалоге — его можно использовать в логике сценария, например:

Сценарий проверяет «Сообщение содержит» = promo2026 → ветка «Промо».
Или ставит соответствующий тег: источник_promo2026.

Идеи использования

Источники трафика

Сделайте для каждой рекламной кампании свою ссылку. В сценарии при старте проверяйте параметр:

?start=ad_october → ставим тег from_ad_october.
?start=blog_post5 → ставим тег from_blog_post5.
?start=newsletter → ставим тег from_newsletter.

Потом в «Диалогах» фильтр по тегам показывает, сколько клиентов пришло с каждого источника.

Партнёрские ссылки

Если у вас партнёрская программа — выдавайте каждому партнёру свою ссылку (?start=ref_PARTNER_ID). В сценарии записывайте в карточку клиента поле «Партнёр».

Прямой переход к продукту

С сайта/из рассылки — ссылка ведёт сразу к нужному сценарию. ?start=catalog_courses → сценарий «Каталог курсов» сразу открывается.

Что важно

Параметр виден клиенту в его текстовом сообщении (в чате он увидит /start promo2026). Если стесняетесь — пишите короткие непрозрачные коды (x42, ad9).
Если в боте уже есть приветственный сценарий на «Команду start» — он сработает на любой параметр. Поэтому встройте проверку параметра в начале.

Тестирование

Откройте ссылку в браузере на компьютере → Telegram попросит подтвердить переход → клиент в боте. Можно тестировать на себе: на другом аккаунте перейдите по ссылке ?start=test и посмотрите, что увидите.

Чего нельзя

Имя домена в ссылке нельзя менять — должно быть t.me/your_bot_username.
Параметр не передаётся в обычной деятельности — только при первом переходе по ссылке.
Несколько параметров (?start=a&promo=b) не поддерживаются — только один start. Если нужно несколько данных, кодируйте их через подчёркивание: ?start=fb_october_baking.