The Devs Bot: модератор групп Telegram

Группа растёт, а вместе с ней растёт и мусор: реклама чужих каналов, боты, которых кто-то добавил без спроса, споры, которые пора остановить. The Devs Bot это рабочий экземпляр открытого модератора, который сообщество разработчиков написало для собственных чатов. 🛡️

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

Откуда он взялся

Бот создан для группы The Devs Network и называется The Guard. Он написан на JavaScript, распространяется по лицензии AGPL-3.0, а исходники лежат в открытом доступе.

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

Что он делает сам

Без вашего участия бот чистит группу от типичного мусора:

• Реклама. Удаляет рекламу каналов и групп и предупреждает автора.
• Чужие боты. Выгоняет ботов, которых пользователи добавили в чат.
• Служебные сообщения. Убирает команды и временные ответы, чтобы лента оставалась чистой.
• Синхронизация. Решения действуют сразу во всех группах одного владельца.

Три роли и пара десятков команд

Права разделены просто: владелец, администратор и все остальные. Это помогает не раздавать полный доступ случайным людям.

• Для всех: /staff показывает администраторов, /link выдаёт ссылку на группу, /groups перечисляет группы сети, /report зовёт модератора, /help и /commands подсказывают список.
• Для администратора: /warn, /ban, /unban, /unwarn, /nowarns, /del, /permit и /user.
• Для владельца: назначение и снятие админов, выход бота из группы, скрытие группы из списка.

Если команду /ban или /warn отправить ответом на сообщение, это сообщение заодно удаляется. Адресата можно указать и упоминанием, и числовым идентификатором.

Хотите такого же у себя

Код открыт, так что бота можно развернуть самому. Понадобится Node.js версии 18 или новее и токен от официального сервиса создания ботов Telegram.

1. Создайте бота и сохраните токен.
2. Скачайте исходники и установите зависимости командой npm install.
3. Скопируйте файл настроек и отредактируйте его под себя.
4. Запустите бота командой npm start.
5. Добавьте его в группу с правами администратора.

Есть и вариант с Docker, если так привычнее. 🐳

Чем пользоваться: свой экземпляр или общий

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

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

Полезные привычки модератора

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

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