Метки источника в Телеграме
Как разложить переходы из рекламы, партнёрских ссылок и QR-кодов на отдельные метки стартовым параметром Телеграма и провести код в тег диалога и карточку CRM.
Стартовый параметр Телеграма — значение после ?start= в ссылке на бота или после команды /start, которое сохраняется в переменной start_parameter. Каждому рекламному объявлению, партнёрской ссылке и QR-коду присваивается свой код, и агент видит, кто именно привёл клиента. Дальше метка идёт в приветствие, в тег диалога и в карточку CRM, и в отчёте вместо одной обезличенной строки появляются каналы по отдельности.
Три рекламных объявления — в Telegram Ads, в закреплённом посте у блогера и на баннере в ленте ВКонтакте — ведут на одну и ту же ссылку на бота. В отчёте по итогам месяца они слипаются в одну строку: «переходы в Telegram», без единого намёка, какое объявление сработало, а какое просто съело бюджет. Разложить эту строку на три помогает один параметр самого мессенджера, а не отдельный сервис аналитики.
Что такое стартовый параметр и как его подставить в ссылку
Стартовый параметр — значение, которое Телеграм передаёт агенту вместе с первым сообщением, если оно добавлено к ссылке на бота или введено вместе с командой /start. Платформа Савви сохраняет его в переменную start_parameter, и дальше с этим значением можно делать то же, что с любой другой переменной канала.
Есть два способа его передать. Первый: ссылка вида https://t.me/example_bot?start=vk_reklama, код после знака равенства подставляется в рекламный баннер, в QR-код или в партнёрский материал, и клиент просто нажимает на неё. Второй — команда /start vk_reklama, которую человек вводит вручную сам; для рекламы такой способ неудобен, зато годится в переписке с партнёром, который присылает код текстом.
Если параметр получен, он виден в шапке экспорта диалога вместе с остальными служебными переменными, ровно там, где и так проверяют канал и время обращения, без отдельного отчёта по рекламе.
Как разложить рекламные каналы, партнёрские ссылки и QR-коды на разные метки
Правило простое: у каждого отдельного размещения свой код, даже если все они ведут на одного и того же бота. Объявление в рекламном кабинете, персональная ссылка партнёра и QR-код на листовке: три разных кода, а не один общий «реклама».
| Источник | Пример метки | Где вставить |
|---|---|---|
| Реклама в VK или Telegram Ads | vk_reklama_sent | поле ссылки в рекламном кабинете |
| Партнёр или блогер | partner_ivanova | персональная ссылка, которую отдаёте партнёру |
| QR-код на листовке или баннере | qr_listovka_okt | адрес, который кодируется в сам QR |
| Рассылка по имеющейся базе | rassylka_sent | ссылка в тексте сообщения |
Проверьте на своих диалогах.Регистрация без карты, 500 ₽ на тест по промокоду BLOG500
Собрать агентаКак метка попадает в приветствие и в саму беседу
Значение start_parameter — обычная переменная канала, и агент может сослаться на неё в инструкции так же, как на имя клиента или номер сделки. Пример: если код называет акцию буквально, инструкция может дать команду поблагодарить клиента за переход именно по этому объявлению вместо одинакового приветствия для всех источников.
Код источника здесь ничем не отличается от других канальных переменных: чем они устроены иначе, чем те, что агент заполняет сам в разговоре, показывают «Переменные ИИ-агента». Для источника достаточно знать одно: значение уже пришло вместе с первым сообщением, и просить агента специально его запоминать не нужно.
Как метка становится тегом диалога
Метка превращается в тег через действие «Базовый шаг» с условием срабатывания по значению start_parameter. Как только диалог пришёл по конкретному коду, действие проставляет заранее выбранный тег, а сам разговор идёт своим чередом — постановка тега на ход беседы не влияет.
Сам запуск по триггеру настраивается одинаково для любого условия, а не только для кода источника — правила собраны в статье «Действие по триггеру». Что делать с готовым тегом дальше и как читать распределение диалогов в статистике, показывает статья «Целевое действие и теги».
На каждый рекламный код заводите свой тег, а не общий тег «пришёл по рекламе». Иначе три объявления из примера выше снова сольются в одну строку, только теперь уже внутри статистики тегов, а не в отчёте рекламного кабинета.
Как код добирается до карточки CRM
Дальше код работает как любая другая переменная канала: его подставляют в аргумент вебхука, а вебхук записывает значение в нужное поле CRM или передаёт его во внешнюю систему аналитики. С Телеграмом этот шаг не связан и работает одинаково для любого канала — устройство вебхуков показывает статья «Вебхуки для ИИ-агента».
Так один код проходит длинный путь: родился в рекламном кабинете как параметр ссылки, стал переменной канала на входе в диалог, разошёлся тегом в статистике и осел отдельным полем в карточке сделки — там, где менеджер по продажам видит источник клиента, даже не открывая переписку.
Что сделать в первую очередь
Прочитайте последний отчёт по рекламе за месяц и найдите в нём ссылку на бота без единого параметра — обычно она там есть просто потому, что её один раз скопировали и разослали сразу по всем каналам. Замените эту ссылку на отдельный код для каждого места, где она стоит: в рекламном кабинете, в закреплённом посте у партнёра, в QR-коде на листовке.
Отдельного бюджета это не требует. Строка «переходы в Telegram» в следующем отчёте распадается на канал за каналом, и видно, какое объявление привело живого клиента, а какое просто крутилось без толку. Подключение канала, кнопки и работа с вложениями — тема статьи «Чат-бот для Телеграма», а здесь речь только о том, что стоит за одной строчкой адреса после ?start=.
Частые вопросы
Что такое стартовый параметр в Телеграме
Значение, которое Телеграм передаёт агенту вместе с первым сообщением, если оно было добавлено к ссылке на бота после знака start= или введено вместе с командой /start. Платформа Савви сохраняет его в переменную start_parameter и показывает в шапке экспорта диалога.
Чем ссылка с параметром отличается от команды /start
Ссылка вида https://t.me/example_bot?start=vk_reklama встраивается в рекламный баннер, QR-код или пост партнёра, и клиент просто нажимает на неё. Команда /start vk_reklama требует, чтобы человек ввёл код вручную, поэтому для автоматической разметки трафика почти всегда используют ссылку.
Где видно, какая метка пришла с конкретным диалогом
В шапке экспорта диалога, рядом с остальными служебными переменными канала. Значение появляется там же, где менеджер и так смотрит источник обращения и время начала разговора, без отдельного отчёта.
Можно ли автоматически поставить тег диалогу по значению метки
Да, действием «Базовый шаг» с запуском по триггеру: условие проверяет значение start_parameter, и при совпадении с нужным кодом диалогу присваивается заранее выбранный тег. Диалог при этом продолжается как обычно, постановка тега на разговор не влияет.
Сколько разных меток заводить на одну рекламную кампанию
Одна метка — одно конкретное размещение: объявление, партнёрская ссылка или QR-код, а не кампания целиком. Если объединить пять разных площадок в один код ради экономии времени, отчёт снова покажет одну строку вместо пяти, и вся настройка потеряет смысл.
Получится ли разметить рекламу, которая уже идёт без кода
Задним числом нет: переходы, которые уже прошли без параметра, в отчёте так и останутся обезличенными. Код добавляют в новую версию ссылки и с этого момента заменяют старый адрес везде, где он стоит: в рекламном кабинете, на баннере и в QR-коде.
Хотите сразу к продукту: Конструктор ботов ТГ
Читайте дальше
Все статьи темы →
Переменные ИИ-агента: как бот запоминает данные клиента
Фиксированные и динамические переменные, функция memorize и куда значение уходит дальше: в вебхук, фоллоу-ап, рассылку или уведомление.
Целевое действие и теги диалогов: как размечать обращения
Как целевое действие ставит тег диалогу, чем оно отличается от тега в инструкции агента и файла быстрых ответов, и почему без запуска теги вообще не появятся.
Чат-бот для Телеграма: подключение за 10 минут
Как подключить ИИ-агента к Telegram: токен из BotFather, бот или личный аккаунт, кнопки внутри диалога, работа в группах и что агент понимает из голосовых.
