Менеджер получил заявку в Telegram, но не знает, откуда пришёл клиент: с сайта, объявления или QR-кода на стойке. Обычная ссылка на бота открывает чат, однако сама по себе не связывает обращение с рекламным источником. Для этого нужно передать метку запуска и сохранить её вместе с заявкой.

Ниже — схема для бизнеса, который принимает обращения через Telegram и хочет различать источники. Она помогает проверить передачу данных, но не заменяет настройку рекламной аналитики и не обещает точную атрибуцию всех продаж.

Почему UTM-метки и параметр start — разные вещи

UTM-метки описывают источник, канал, кампанию и другие признаки перехода в системе аналитики; назначения параметров приведены в справке Google Analytics. Telegram-бот получает события своего диалога. Поэтому добавление привычных параметров к ссылке на чат не означает, что бот увидит их в сообщении пользователя.

Для запуска бота с дополнительным значением Telegram документирует параметр start. Например, ссылка https://t.me/your_bot?start=site_ru1 предназначена для передачи значения site_ru1 в команде запуска. Название your_bot здесь условное: его нужно заменить именем вашего бота. Механизм описан в официальной документации о deep linking.

Короткая метка может обозначать строку в вашем справочнике источников. Например: «кнопка на странице услуги, Россия, кампания A». Сам справочник хранится на сервере или в системе учёта. Не пытайтесь уместить в ссылку всю карточку клиента.

Практическое различие: UTM объясняет переход в аналитике сайта, а start передаёт боту согласованный код запуска. Чтобы соединить эти данные, нужна логика вашего сервиса.

Составьте справочник источников

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

  • Источник: сайт, партнёр, рекламная площадка или офлайн-точка.
  • Размещение: конкретная страница, кнопка, публикация или макет.
  • Кампания: понятное команде название и период использования.
  • Регион предложения: если разные материалы рассчитаны на Россию и Беларусь.
  • Ответственный: кто создал ссылку и согласовал её назначение.

Одна общая метка «реклама» не поможет различить два объявления. При этом не нужно создавать новый код для каждого случайного открытия страницы, если задача ограничивается сравнением размещений. Детализацию выбирайте по вопросу, на который хотите ответить.

Регион ссылки отражает предложение, а не подтверждённую страну клиента. Человек может переслать её коллеге или открыть из другой страны. Если география влияет на услугу, бот должен отдельно уточнить нужный регион. Об организации такого пути есть статья о сайте для России и Беларуси.

Как связать переход с сайта и запуск бота

Для кнопки на сайте возможны два подхода. Первый — заранее заданная ссылка с кодом конкретного размещения. Он подходит, если достаточно узнать, что клиент пришёл со страницы определённой услуги.

Второй — сервер создаёт короткий идентификатор перехода и сохраняет доступные метки кампании в своей записи. В ссылку на бота передаётся этот идентификатор. Когда бот получает команду запуска, он находит запись и связывает её с обращением. Это вариант проектирования, а не встроенная функция Telegram.

В документации Telegram указан предел значения start — до 64 символов; допустимы латинские буквы, цифры, подчёркивание и дефис. Поэтому длинную строку UTM-параметров удобнее хранить отдельно. Проверка формата и обработка неизвестного кода должны выполняться на сервере.

Для передачи данных из сайта в CRM заранее согласуйте поля. Полезно сохранить код источника, его расшифровку и идентификатор заявки, чтобы отчёт можно было проверить по конкретным обращениям. Основные вопросы интеграции разобраны в статье о связи сайта с CRM.

Разделите клик, запуск и заявку

Клиент может нажать кнопку, открыть Telegram и не продолжить диалог. Другой человек запустит бота, но не отправит данные. Если считать эти действия одинаковыми, отчёт покажет красивое число обращений, которых менеджер никогда не получал.

  1. Клик: пользователь нажал ссылку на сайте или в другом отслеживаемом размещении.
  2. Запуск: бот получил событие запуска с меткой.
  3. Заявка: пользователь подтвердил и отправил нужные сведения.
  4. Получение сотрудником: обращение сохранено и доступно для обработки.
  5. Результат: сотрудник указал согласованный статус в CRM или другой системе.

Не выводите событие, которое ваша система не наблюдала. Бот не обязан знать о клике до получения команды запуска. Если переходы фиксирует сайт, а заявки — сервер бота, соедините записи по идентификатору и отдельно учитывайте случаи, где связи нет.

Получение источника не решает потерю заявки при недоступности CRM. Сначала сохраняйте обращение в согласованной системе или очереди, затем передавайте его дальше с контролем результата. Практический контекст есть в материале о потерях лидов между рекламой, сайтом и CRM.

Договоритесь о повторных переходах

Один клиент может открыть бота сначала с сайта, затем из публикации и только после этого оставить заявку. До настройки отчёта решите, что нужно сохранить: первый известный источник, последний известный источник перед заявкой или историю наблюдаемых запусков.

Для начала удобно хранить первый и последний источник отдельно. Правило привязки конкретной заявки должно быть одинаковым для всех кампаний. Не перезаписывайте первую запись новым значением без сохранения истории, если она нужна для отчётности.

Если метки нет, укажите «источник не определён». Если код неизвестен или устарел, сохраните этот факт и дайте клиенту продолжить обычный сценарий. Отсутствие атрибуции не должно запрещать человеку обратиться в компанию.

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

Какие данные не нужно помещать в ссылку

Для кода рекламного источника не нужны имя, телефон, номер заказа, пароль или токен доступа. Ссылка может оказаться в переписке, истории браузера или журнале переходов. Используйте короткий служебный код и храните его расшифровку в управляемом справочнике.

Метка также не подтверждает личность и не даёт права открыть чужую заявку. Доступ к заказам проверяется отдельно. Если используются временные идентификаторы перехода, согласуйте срок их действия и поведение после истечения срока; старый QR-код не должен превращать обращение в ошибку без объяснения.

Чек-лист проверки перед запуском рекламы

  • У каждого размещения есть согласованный код и запись в справочнике.
  • Ссылка проверена новым пользователем и человеком, который уже запускал бота.
  • Метка сохраняется после возврата назад и исправления данных.
  • В отправленной заявке источник совпадает со справочником.
  • Повторная отправка не создаёт дубль обращения.
  • Повторный переход обрабатывается по согласованному правилу атрибуции.
  • Ссылка без метки и неизвестный код не блокируют заявку.
  • В отчёте отдельно видны запуски, заявки и результаты обработки.
  • Регион предложения не подменяет выбранную клиентом страну обслуживания.

Проверьте весь путь на одной условной заявке: открыть нужную ссылку, завершить диалог, найти обращение у сотрудника и увидеть тот же источник в отчёте. Затем повторите проверку для другой ссылки и для входа без метки.

В ТЗ на Telegram-бота включите справочник, правила повторных запусков и критерии приёмки отчёта. С этими вводными можно обсуждать разработку бота с учётом источников заявок без обещания, что одна ссылка заменит всю аналитику продаж.