This project is a Telegram bot designed to automate message management in groups or individual chats. It comes with special features that make it useful for administrators and moderators.
-
🔧 Token Configuration:
Easily set up your bot'sTOKEN
,GROUP_CHAT_ID
, andADMIN_ID
directly through the graphical interface. -
▶️ Start/Stop Control:
Intuitive buttons to start and stop the bot without manual interruptions. -
📡 Real-Time Logs:
Monitor bot activities such as sent messages, forwarded messages, and errors in a dedicated console within the GUI. -
⚙️ Customizable Settings:
Adjust parameters like auto-deletion time and manage configurations through the GUI.
graph TD;
A[Start Bot] --> B[Load GUI];
B --> C[Set TOKEN, GROUP_CHAT_ID, ADMIN_ID];
C --> D[Click Start];
D --> E{Is BOT Running?};
E -- Yes --> F[Fetch Updates from Telegram API];
F --> G[Process Incoming Messages];
G -->|Admin Commands| H[Execute Admin Commands];
G -->|User Messages| I[Log and Respond to Users];
H --> F;
I --> F;
E -- No --> J[Stop Bot and Logs];
Feature | Description |
---|---|
📩 Message Sending | The bot can send messages to users or groups and delete them automatically after a defined period. |
🔄 Message Forwarding | Allows forwarding messages from one chat to another, while keeping a log of each operation. |
🗑️ Auto Deletion | Automatically deletes sent messages after a configurable time. |
📜 Message Logging | Keeps a detailed log of all sent and forwarded messages, stored in JSON files for future reference. |
👮♂️ Admin Commands | Administrators can send messages to specific users, forward messages, and see a list of users who have interacted with the bot. |
/start
: Start interacting with the bot and register the user in the system./chat <user_id> <message>
: Send a direct message to a specific user./resend <user_id> <from_chat_id> <message_id>
: Forward a message from a source chat to a user./list
: Show a list of users who have sent the/start
command.
- Python 3.x
- Libraries:
requests
json
threading
-
Clone the repository:
git clone https://github.com/youruser/telegram-message-bot.git
-
Install the dependencies:
pip install requests
-
Configure your Telegram token and admin IDs in the bot's main file.
-
Run the bot!
python bot.py
start_log.json
: Log of users who have executed the/start
command.message_log.json
: Log of messages sent and forwarded by the bot.
Enjoy automating your chats with this Telegram bot! 😎