Бот в Telegram не работает: диагностика без сброса настроек

«Бот не работает» может означать, что он не отвечает в личке, не показывает группу, пропускает спам или не присылает запись об удалении. Это разные неисправности. Сначала назовите конкретное наблюдение, затем меняйте один параметр и повторяйте тот же тест.

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

Найдите точку, в которой расходятся ожидание и результат

С чего начать по наблюдаемому симптому
Что вы видите	Первая проверка	Какой вывод пока делать нельзя
Нет ответа на Start в личке	Правильный ли бот, не заблокирован ли он и отправляются ли сообщения в Telegram.	Что неверно настроен фильтр группы.
Ответ есть, но группы в панели нет	Участие бота в группе и ваши права администратора.	Что все настройки удалены.
Панель работает, сообщение не удаляется	Выбранная группа, включение правила, роль автора и настройка удаления.	Что сервис вообще не получил сообщение.
Сообщение удалилось, мута нет	Отдельное действие над участником и право ограничивать его.	Что удаление и мут включаются одним переключателем.
Действие произошло, журнал пуст	Включение журнала, категория события и доставка в выбранный чат.	Что действие не выполнялось.

До правок запишите время начала проблемы и последний известный успешный случай. Уточните у других администраторов, меняли ли они права, фильтр, тему для уведомлений или второго бота. Формулировка «сообщение новичка осталось в 17:20 по Москве» полезнее, чем «всё сломалось».

1. Отделите личный чат от работы в группе

Откройте официального @defendy_bot и отправьте /start именно в личном чате. Проверьте, не заблокировали ли вы его в Telegram. Убедитесь, что обычные сообщения отправляются: общую проблему соединения легко принять за отказ бота.

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

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

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

2. Проверьте группу и два разных вида полномочий

В списке администраторов Telegram убедитесь, что нужный бот остаётся администратором. В мини-приложении сверьте название и ID группы. Правка тестовой группы не меняет рабочую.

Отдельно проверьте, может ли бот выполнить действие и можете ли вы его запрашивать или настраивать. Роль модератора Defendy не равна полному набору прав Telegram. Для конкретной команды сверьтесь с ролями и правами бота.

Если недавно менялся состав администраторов, администратор Telegram может выполнить /reload в группе. Команда обновляет список администраторов в Defendy. Она не перезапускает сервер, не возвращает удалённые сообщения и не обнуляет настройки. Прочитайте ответ команды, чтобы убедиться в результате.

Предупреждение Defendy о правах для полного функционала может перечислять широкий набор полномочий. Сопоставьте его с нужными действиями. Выдавать всё подряд ради одного неудалённого сообщения не стоит: можно расширить доступ и так и не найти причину.

Почему совет про BotFather часто не подходит

В FAQ Telegram для ботов различаются права администратора и privacy mode. Боту-администратору не нужно отключать privacy mode, чтобы получать обычные сообщения группы.

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

Бот перестал отвечать после преобразования группы

Уточните, не стала ли обычная группа недавно супергруппой. Telegram описывает такое преобразование как миграцию группы; в ошибке Bot API новый идентификатор может приходить в поле migrate_to_chat_id. Прежнее название в приложении ещё не подтверждает, что интеграция обращается к актуальному чату.

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

Сохраните текущую конфигурацию, пока оператор проверяет привязку. Не начинайте с пересоздания группы или смены токенов. /reload обновляет список администраторов; исправление идентификатора чата не является документированной задачей этой команды. Этот диагностический шаг не подтверждает автоматический перенос всех настроек Defendy. Преобразование одной группы в Telegram также отличается от переезда сообщества в другую, не связанную с ней группу.

3. Различите ошибку сохранения и ошибку обновления экрана

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

Форму с кнопкой Сохранить нужно сохранить до выхода.
Обычные переключатели и списки выбора сохраняются при изменении. После ошибки откройте раздел повторно и посмотрите фактическое значение.
Сообщение «настройка сохранена, но свежие данные не удалось загрузить» означает успешную запись и неудачное обновление экрана. Используйте повторную проверку, не отправляйте сохранение снова и снова.
Ошибка загрузки или некорректные настройки не означают, что модуль выключен. Зафиксируйте сообщение и разберитесь с чтением, прежде чем перезаписывать значения.
Пометка Скоро означает недоступную функцию. Антифлуд, антирейд и общий импорт/экспорт настроек в текущем меню нельзя использовать как работающие инструменты.

На скриншоте для поддержки полезны выбранная группа, название модуля и текст ошибки. Скройте посторонние данные участников, переписку и всё, что относится к авторизации.

4. Воспроизведите одно совпадение и одно исключение из него

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

Условный пример: в стоп-список добавлен единственный маркер пробныймаркер, выбран точный поиск, удаление включено, действие над участником — Нет. Участник отправляет маркер, затем «Встречаемся у входа». Запишите судьбу каждого сообщения. Такой опыт проверяет простое правило с заранее известным совпадением; AI-классификация для проверки связи не нужна.

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

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

Не считайте /spam безопасным просмотром решения. В Defendy ручная AI-проверка может удалить сообщение, признанное спамом; если спам не найден, результат может быть без публичного ответа. Одно только молчание не доказывает неисправность. Подробнее: ручная проверка спама.

Если результат меняется после правки или реакции

Используйте отдельную тестовую группу и обычного участника, согласившегося на проверку. Оставьте одно правило стоп-слов с уникальным маркером и режимом Точный, действие над участником Нет и включённое удаление; заранее проверьте исключения и другие фильтры. Используйте текст и медиа, которые не жалко удалить.

Отправьте безобидный текст, затем целиком замените его на пробныймаркер. Зафиксируйте исходную и изменённую версии отдельно. Если сообщение удалено, для следующей проверки возьмите новое.
Отправьте фотографию с безобидной подписью, затем замените только подпись на пробныймаркер. Не смешивайте этот опыт с проверкой текстового сообщения.
Отправьте ещё одно безобидное сообщение. Добавьте или уберите реакцию, не меняя текст. Посмотрите, изменилось ли что-нибудь; реакция не обязательно вызовет действие.

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

В описании edited_message Telegram учитывает изменения полей, которые бот может не использовать или не получать. В уточнении сотрудника Telegram к ним отнесены реакции и другие изменения помимо содержимого. Отдельное сообщение о реакциях и тегах участников требует разбора; само по себе оно не подтверждает всеобщий сбой Telegram или воспроизведённое повторное наказание в Defendy.

Defendy проверяет обычные правки сообщений группы с учётом исключений. Для автоматических варнов от фильтров используется ограниченная по времени защита от повторного начисления по паре «группа + ID сообщения», поэтому новая правка не обещает нового варна. В проверенной реализации нет подписки на обновления постов канала, а автоматические пересылки в обсуждение и их правки исключены из проверки. Испытывайте сообщение участника, а не пост канала или корень его обсуждения.

5. Проверьте действие отдельно от записи о нём

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

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

Когда не работает только капча, переходите к её диагностике и повторяйте настоящий путь вступления. Работающий текстовый фильтр ничего не говорит об обработке заявки на вход.

Если бот ваш: проверьте, где выполняется его сценарий

Регистрация в BotFather создаёт учётную запись бота, а не готовую программу модерации. Убедитесь, что сервис или no-code-сценарий, который должен отвечать, настроен и запущен. Если сбой начался после подключения второй платформы, сначала разберите это изменение, а не перевыпускайте токен наугад.

Telegram доставляет обновления через webhook или long polling; способы взаимоисключающие. Ответственный за сценарий должен проверить ошибки доставки без раскрытия реквизитов доступа. Не меняйте адрес доставки чужого сервиса, не открывайте для публичного скриншота API-ссылки с токеном и не подключайте рабочего бота к ещё одному конструктору «для проверки».

Длительный сбой: ручной резерв и восстановление пропущенного периода

Запишите первое наблюдаемое нарушение работы, часовой пояс и последнее подтверждённое успешное действие. Отделяйте проверенный период сбоя от предположений о его длительности. Если настройки открываются, но удаление не выполняется, отметьте непроверенную работу удаления; не объявляйте все модули недоступными без проверки.

Как поддержать группу, пока автоматизация ненадёжна

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

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

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

Что могло не попасть в обработку

Telegram хранит недоставленные обновления Bot API не дольше 24 часов. Это предел доставки, а не гарантия обработки всех сообщений за последние сутки. Уже принятые сервисом события, его собственное состояние и работа отдельных модулей требуют отдельного уточнения у оператора.

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

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

Как вернуть автоматизацию без повторных наказаний

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

Пройдите затронутые сценарии:

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

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

Исправьте причину и проверьте восстановление

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

Оставьте короткую запись: симптом, установленная причина, изменение, результат и ответственный. Если причина пока неизвестна, так и запишите; проблемный сценарий оставьте под наблюдением человека.

В поддержку по проверенному личному контакту передайте ID группы, время с часовым поясом, модуль, ожидаемый и фактический результат, обезличенный пример. Укажите роль автора теста и текст ошибки. Не отправляйте токены ботов, коды входа Telegram, полный адрес запуска мини-приложения или всю личную переписку.

Что проверено

Исходные шаги диагностики сверены 6 октября 2026 года с реализацией Defendy и продуктовой справкой. Раздел о длительном сбое и восстановлении, включая сроки доставки и удаления из источников Telegram, проверен 7 октября 2026 года. Примеры описывают план диагностики, а не проведённые в реальной группе испытания. Они помогают сузить причину, но не подтверждают доступность сервиса в момент чтения.