https://github.com/merrcurys/mention-bot
A bot for mentioning users in telegram chats.
https://github.com/merrcurys/mention-bot
mention-bot notification-bot pyrogram pyrogram-bot telegram-bot
Last synced: about 1 month ago
JSON representation
A bot for mentioning users in telegram chats.
- Host: GitHub
- URL: https://github.com/merrcurys/mention-bot
- Owner: Merrcurys
- License: gpl-3.0
- Created: 2024-02-18T20:12:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-06T09:30:47.000Z (4 months ago)
- Last Synced: 2025-03-28T18:54:03.480Z (about 2 months ago)
- Topics: mention-bot, notification-bot, pyrogram, pyrogram-bot, telegram-bot
- Language: Python
- Homepage:
- Size: 75.2 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## О боте
Mention bot - это бот, который может оповещать всех пользователей в чате.
Бота можно найти и протестировать по этому адресу: [@fast_mention_bot](https://t.me/fast_mention_bot?start=c1686051798545-ds)
[Канал](https://t.me/merrcurys_software/41), где оповещаю об обновлениях бота.
## Функционал бота
1. `/help`, `/command` - справка по всем командам.
2. `/all`, `/here`, `/everyone` - позвать всех пользователей.
3. `/access_toggle` - тумблер прав доступа к оповещениям.
4. `/names_visibility` - тумблер для видимости имен при оповещении.
5. Смена языка (ru / en).
6. Все ошибки бот отправляет в админский чат.
## Ограничения бота
* Бот работает только до 75 участников, без учета отправителя сообщения, ботов и удаленных аккаунтов.
* Команду `/all` нельзя вызывать в одном чате, чаще чем раз в минуту.
* В одном сообщение хранится не больше 5 ссылок на пользователей.
## Установка
Создание виртуального окружения
Для Linux
```
python3 -m venv venv
source venv/bin/activate
```
Для Windows
```
python -m venv venv
venv\Scripts\activate
```
Установка зависимостей:
```
pip install -r requirements.txt
```
Подготовка админского чата:
Добавьте бота в админский чат.
Заполните файл .env
```
API_TOKEN = <получить можно через @BotFather>
API_ID = <получить можно на https://my.telegram.org>
API_HASH = <получить можно на https://my.telegram.org>
ADMIN_CHAT_ID = <войдите в чат и скопируйте последние цифры в адресной строке браузере>
```
Запуск бота
```
python main.py
```