Бот в Telegram не отвечает на /start: обычный вход, ссылка и зависшая анкета

Вы проверили бота со своего аккаунта — приветствие пришло. Запустили рекламу, и клиент пишет: «Нажимаю “Запустить”, ничего не происходит». Повторная проверка у вас снова проходит. Перезапустить весь сервер в такой ситуации хочется, но сначала полезнее сравнить способы входа.

Один и тот же бот может по-разному обработать простой /start, вход с рекламной меткой и возвращение в незавершённую анкету. Ниже — порядок проверки именно первого шага. Если перестал работать весь диалог, начните с общего разбора почему чат-бот не отвечает: там отдельно рассмотрены сервер, доставка сообщений и отправка ответа.

Сначала воспроизведите сбой, сохранив незавершённый заказ

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

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

Для сравнения нужны три наблюдения. Откройте обычную ссылку на бота без параметров; отдельно повторите переход по той ссылке, на которой жалуется клиент; затем проверьте возврат в ранее начатую анкету на тестовом аккаунте. Один успешный вход не отменяет два других сбоя. Записывайте фактический результат каждого, а не только «бот работает».

Обычный вход работает, а ссылка из рекламы — нет

Ссылка вида https://t.me/ExampleBot?start=campaign_a передаёт боту параметр запуска. В программе нужно обработать и вход с параметром, и вход без него. Это предусмотренный Telegram механизм deep linking; конкретный смысл метки задаёт разработчик.

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

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

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

Новый пользователь получает ответ, вернувшийся в анкету — нет

Бот может хранить текущий шаг диалога: ждёт телефон, адрес или выбор услуги. Если человек вместо ожидаемого ответа отправил /start, программа должна решить, как поступить. Продолжить анкету, предложить отмену или начать заново — это правило вашего сервиса, а не автоматическая функция Telegram.

Для разработчика здесь две отдельные проверки: какие фильтры разрешают обработчик /start и не перехватывает ли сообщение более общий обработчик анкеты. В aiogram 3 поиск обработчика останавливается на первом совпадении фильтров. Поэтому порядок регистрации и подключения модулей имеет значение. Это описано в документации фильтров aiogram.

Важная поправка к распространённому совету: в aiogram 3 обработчик без StateFilter не ограничен состоянием None по умолчанию. Поведение отличается от aiogram 2. Добавлять StateFilter("*") вслепую и объявлять проблему решённой неправильно — сначала проверяют фактические фильтры проекта и версию библиотеки. Основание — руководство по миграции aiogram.

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

Бот молчит только для новых клиентов

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

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

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

Ни один вариант входа не работает

Тогда диагностика выходит за рамки стартового сценария. Разработчик проверяет, запущена ли нужная версия программы, получает ли она обновление, подключён ли модуль обработчика и доходит ли выполнение до отправки приветствия. Для aiogram подключение обработчиков описано в руководстве Router.

Состояние webhook можно прочитать через getWebhookInfo из своей серверной среды. Это проверка состояния, а не команда ремонта. Не удаляйте webhook и не сбрасывайте очередь сообщений по чужому универсальному чеклисту. В частности, drop_pending_updates удаляет ожидающие обновления: вместе с ними могут исчезнуть необработанные обращения. Значение параметра описано в справке Bot API.

Что принять после ремонта

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

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

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

Источники

1. Telegram: параметры запуска бота.
2. aiogram: фильтры и выбор обработчика.
3. aiogram: различия версий 2 и 3.
4. aiogram: middleware.
5. aiogram: подключение Router.
6. Telegram Bot API: удаление webhook и ожидающих обновлений.