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

Сначала определите задачу бота

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

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

Создайте бота через BotFather

Telegram регистрирует ботов через официальный аккаунт @BotFather. В диалоге отправьте /newbot, выберите отображаемое имя и username по подсказкам BotFather, затем сохраните выданный токен.

Токен позволяет управлять ботом. Храните его как пароль: не публикуйте в группе, документах или открытом чате. Если токен стал известен постороннему, отзовите его через BotFather и обновите подключённый сервис.

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

Добавьте бота в группу

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

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

Проверьте режим конфиденциальности

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

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

Проверьте работу на тестовом сценарии

Не ограничивайтесь командой /start в личном чате. Проверьте в самой группе:

1. Видит ли бот только те сообщения, которые ему нужны.
2. Отвечает ли на предусмотренные команды и упоминания.
3. Может ли он выполнить нужное действие с выданными правами.
4. Что происходит, если права отозваны или участник выполняет необычное действие.
5. Понятно ли участникам, как обратиться к администратору, если автоматический ответ не помог.

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

Подключение Metricgram — отдельный сценарий

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

Привязка аккаунта и добавление бота в группу — разные шаги. Обычное подключение не требует api_id, api_hash или номера телефона. Эти данные относятся к отдельному необязательному потоку извлечения данных, а не к настройке группы.

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

Пересматривайте права

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

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