Как добавить бота-модератора в Telegram-группу и проверить настройку

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

Покажем порядок на готовом сервисе @defendy_bot. Для этого не нужны BotFather, собственный токен и сервер. Если вы хотите бота со своим именем и нестандартным поведением, сначала прочитайте руководство по созданию без программирования.

Что подготовить до подключения

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

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

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

Как подключить группу

Откройте личный чат с ботом и нажмите Запустить или отправьте /start.
Нажмите ⚙️ Настройки под ответом бота. Откроется мини-приложение.
Выберите Подключить группу, укажите нужную группу и проверьте запрошенные права администратора в Telegram.
После добавления вернитесь в мини-приложение и откройте группу в разделе Мои группы.
Сверьте название и ID перед изменениями. Похожие названия легко перепутать, а настройки относятся к выбранной группе.

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

Почему бот просит больше прав, чем нужно одному фильтру

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

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

Какое право проверить для нужного действия
Задача	Право Telegram	Проверка результата
Удалять сообщения участников	Удаление сообщений	Новое тестовое сообщение удаляется, разрешённое остаётся.
Выдавать и снимать мут или бан	Блокировка и ограничение участников	Участника, согласившегося на тест, можно ограничить и вернуть ему доступ.
Обрабатывать заявки на вступление	Приглашение пользователей	Работает именно тот путь вступления, который используется в группе.
Закреплять сообщения	Закрепление сообщений	Тестовое объявление можно закрепить и открепить.
Управлять темами форума	Управление темами	Выполняется конкретное запланированное действие с темой.

Смысл прав описан в справочнике Telegram. Выбор существующей темы для отправки уведомлений сам по себе не означает управление темами. А роли модераторов внутри Defendy не заменяют полномочия Telegram: внутренняя роль не выдаст боту отсутствующее право.

Отключать privacy mode для такой установки не требуется. Бот-администратор получает обычные сообщения группы и без этого изменения. Кроме того, настройки BotFather доступны владельцу бота: через свой аккаунт нельзя перенастроить чужой сервис. Это следует из описания privacy mode у Telegram.

Первая проверка: одно правило, один понятный результат

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

Откройте Стоп-слова, включите фильтр и выберите точный поиск для этого одиночного слова.
Создайте список с понятным тестовым названием, добавьте пробныймаркер и сохраните форму.
В действии над участником выберите Нет. Отдельно включите удаление тестового сообщения.
Откройте список заново и проверьте оба значения. Нет означает отсутствие наказания участника, но не отменяет удаление сообщения.
Попросите обычного участника отправить маркер, затем фразу без него. Маркер должен исчезнуть, обычная фраза остаться, а возможность писать сохраниться.
После проверки удалите тестовую запись или выключите тестовую настройку. Реальные правила составляйте по примерам своего чата: подробности про стоп-слова.

Сообщения администратора не подходят для основной проверки: на них могут действовать исключения, а ограничения участников нельзя проверить на администраторе тем же способом. Варн тоже нельзя считать безобидным тестом: он может довести существующий счётчик до порога наказания. Команда /spam не подходит для проверки связи с ботом, поскольку AI-проверка может закончиться удалением.

Успех этого опыта подтверждает только одно правило и одно действие. Капчу, фильтрацию ссылок и другие сценарии проверяйте отдельно, когда действительно решите их включить.

Сохранение настройки и журнал — разные проверки

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

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

Перенос в рабочую группу и исправление ошибок

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

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

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

Несколько ботов и безопасная замена модератора

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

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

Переключайтесь в период, когда администратор на связи:

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

Четыре проверки конфликтующих действий

Это сценарии приёмки вашей комбинации инструментов, а не утверждение о найденных ошибках Defendy.

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

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

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

Источники и границы проверки

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