Телеграм

Ссылка на бота с меткой (deep link): как запустить нужный сценарий

Ссылки t.me/бот?start=…, max.ru/бот?start=… и vk.me/сообщество?ref=…: бот запускает нужный сценарий и запоминает, откуда пришёл человек.

Ссылка с меткой ведёт человека в бота и сразу запускает нужный сценарий. Метка — это слово в конце ссылки:

https://t.me/ваш_бот?start=youtube

По метке бот понимает, откуда пришёл человек, и отвечает так, как вы задумали для этого места: под видео — одно, на визитке — другое.

Где это работает

  • Telegram — t.me/ваш_бот?start=метка.
  • Макс — max.ru/ваш_бот?start=метка.
  • ВКонтакте — vk.me/ваше_сообщество?ref=метка. Метка приходит вместе с первым сообщением человека — подробнее ниже, в разделе «ВКонтакте».

Шаг 1. Получите ссылку на сценарий

Откройте сценарий в «Автоматизации». В стартовом блоке нажмите «Ссылка на сценарий»: появится триггер «Старт с параметром» и готовая ссылка вида t.me/ваш_бот?start=flow123. Скопируйте её кнопкой рядом.

Кнопка есть у ботов Telegram и Макс.

Шаг 2. Задайте свою метку

Вместо flow123 можно написать понятную метку: в триггере «Старт с параметром» укажите, например, youtube. Ссылка станет t.me/ваш_бот?start=youtube.

Что важно знать о метке:

  • только латиница, цифры, дефис и подчёркивание, до 64 знаков — кириллица и пробелы не подойдут;
  • метка должна совпасть целиком: ссылка ?start=youtube2 не запустит сценарий с меткой youtube;
  • в Telegram метки, которые начинаются с ck-, заняты кодовым словом в комментариях.

Шаг 3. Поставьте ссылку и проверьте

Ставьте ссылку в описание видео, пост, рекламу, на сайт или в QR-код. Проверьте со второго аккаунта: перейдите по ссылке и нажмите «Старт» (в Макс — «Начать»).

Сценарий запускается и у новых людей, и у тех, кто уже писал боту.

Метка в сообщениях и условиях

Бот запоминает метку в переменной {{var.start_param}}. Её можно:

  • подставить в сообщение: «Вы пришли по ссылке {{var.start_param}}»;
  • проверить условием «Переменная равна»: имя — start_param, значение — youtube.

ВКонтакте

Ссылка vk.me/ваше_сообщество?ref=youtube открывает сообщения сообщества. Метка приходит вместе с первым сообщением и тоже сохраняется в {{var.start_param}}. Добавьте &ref_source=video1 — вторая метка попадёт в {{var.ref_source}}.

Триггера «Старт с параметром» в редакторе ВКонтакте нет. Чтобы ответить по-своему, поставьте в приветственном сценарии условие «Переменная равна»: start_param = youtube.

Сколько людей перешло по ссылке

Ссылка с меткой работает на любом тарифе, но переходы не считает. Если нужно видеть, сколько людей перешло и сколько дошло до бота, сделайте короткую ссылку в разделе «Короткие ссылки» — на тарифах «Плюс» и «Премиум». Сценарий там выбирается в настройках ссылки, отдельная метка не нужна.

Частые вопросы

Почему по ссылке приходит обычное приветствие, а не мой сценарий? Метка в ссылке должна целиком совпасть с меткой в триггере «Старт с параметром» — без пробелов и кириллицы. Если совпадения нет, бот отвечает как на обычный «Старт».

Не перехватит ли ссылку приветствие на «Старт»? Нет. Сценарий с триггером «Старт с параметром» главнее обычного приветствия: приветствие сработает, только если метка не совпала ни с одним сценарием.

Сработает ли ссылка у тех, кто уже писал боту? Да. В Telegram человек увидит кнопку запуска бота, нажатие передаст метку. В Макс метка приходит при каждом переходе по ссылке.

Можно передать в ссылке несколько меток? Нет, метка одна. Если нужно несколько данных, соедините их через подчёркивание: ?start=youtube_reels.

Чем ссылка с меткой отличается от короткой ссылки? Ссылка с меткой запускает сценарий, но не показывает, сколько людей по ней перешло. Короткая ссылка etochatbot.link считает переходы и тех, кто дошёл до бота, открывает приложение, а не браузер, и даёт QR-код.