Telegram-бот с учётом источников заявок: что передавать в ссылке запуска

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

Метка запуска помогает начать разговор в нужном контексте

Telegram поддерживает ссылки личного чата с параметром start. Официальная документация описывает передачу дополнительного значения боту при запуске, ограниченный набор символов и предел 64 символа. Для данных другого вида предлагается кодирование base64url. Это механизм передачи контекста, а не самостоятельный сервис статистики.

Например, короткая запись expo-2026|quote может обозначать кампанию выставки и сценарий запроса расчёта. Рабочий смысл такой записи должен быть заранее известен серверу. Нельзя ожидать, что произвольный текст после start автоматически превратится в поля CRM или отчёт о продажах.

Не помещайте в метку всё содержимое заявки

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

Метка видна в ссылке и может быть изменена пользователем. Base64url — кодирование, а не шифрование или подпись. Если передать слово paid в закодированном виде, это не подтвердит оплату. Сервер должен отдельно проверять действия и права, а контекст кампании принимать только по согласованному справочнику.

Читаемый текст и длина параметра измеряются по-разному

Инструмент ниже сначала переводит исходный текст в байты UTF-8, затем кодирует их в base64url без знаков дополнения. Для учебной строки expo-2026|quote получается 15 байтов и 20 символов параметра. Кириллица и другие символы могут занимать несколько байтов, поэтому счётчика букв недостаточно.

В этой модели 48 исходных байтов дают 64 символа кодирования и ещё помещаются. Для 49 байтов требуется 66 символов, и инструмент отвергает результат. Это ограничение выбранного способа упаковки данных, а не утверждение, что Telegram всегда ограничивает исходный текст сорока восемью буквами.

Что получает разработчик вместе со ссылкой

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

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

Проверка ссылки без подключения к Telegram

1. Укажите имя своего бота; учебное YourExampleBot нужно заменить, оно не обозначает наш аккаунт.
2. Введите короткий неперсональный контекст или идентификатор кампании.
3. Проверьте длину UTF-8 и закодированного параметра.
4. Передайте разработчику полученный параметр и ожидаемые данные после декодирования.
5. В собственной тестовой среде проверьте фактический запуск и запись события на сервере.

Инструмент принимает обычное имя из латинских букв, цифр и подчёркивания длиной 5–32 символа с окончанием bot. Это ограниченный формат модели, а не проверка существования, регистрации или владения ботом. Ссылка выводится как текст; сообщений, публикаций и запросов к Telegram не выполняется.

Что включить в приёмку бота с учётом источников

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

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