Zerogram

Zerogram is a powerful Telegram bot infiltration and monitoring tool designed to forward, delete, and manage messages within Telegram bots and chats. It enables security researchers to silently monitor and manipulate Telegram bot messages, automate interactions, and extract information from targeted bot chats. Note: Employing this tool may lead to the suspension or banning of your Telegram account. Proceed with caution and at your own risk.

Looking for the UI version? Check out the UI at https://github.com/Seadox/Zerogram-UI

Disclaimer (Legal & Ethical Use)

This tool is provided solely for educational and research objectives. It aims to assist cybersecurity experts analyze and comprehend Telegram bot interactions, especially those that could involve security risks.

Any use of this tool for unlawful purposes or unauthorized access is strictly prohibited. You bear full responsibility for all activities conducted using this tool. The authors and contributors disclaim any liability for misuse, damages, or legal repercussions resulting from its use.

If you do not accept these conditions, please refrain from using this tool.

Features

• Forward messages from one chat to another
• Send text messages to a target chat
• Delete all messages in a chat
• Change the bot's display name
• Send various types of files (photos, videos, audio, documents, animations, voice messages)
• Logout and leave chats
• Command-line interface for flexible usage

Requirements

• Python 3.7+
• Install dependencies from the requirements file:

pip install -r requirements.txt

• Create an account on my.telegram.org/apps to obtain your Telegram API credentials: api_id, api_hash, and your phone_number.

• Create a .env file in the project root with the following format:

TELEGRAM_API_ID=123456
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_PHONE=+900000000000

Usage

Run the script from the command line with the following options:

python zerogram.py -t <bot_token> -c <chat_id> [options]

Required arguments

• -t, --token : Your Telegram Bot API token.
• -c, --chatid : Target chat ID (usually a numeric chat or user ID).

On the first run, Telegram will send you a login code that you need to enter into the terminal to proceed with running the script.

Optional arguments

| Flag | Description | Example | | ----------------------- | ---------------------------------------------------- | --------------------------- | | -ci, --my_chat_id | My Chat ID | -ci "1969833298" | | -df, --download_files | Download files sent to the bot chat (if implemented) | -df | | -mi, --msg_id | Starting message ID for forwarding or deletion | -mi 10 | | -sm, --send_msg | Send a text message to the chat | -sm "Hello from Zerogram" | | -d, --delete_messages | Delete all messages in the bot chat | -d | | -sn, --set_name | Set a new name for the bot | -sn "NewBotName" | | -f, --file | Send a file to the chat | -f ./path/to/file.jpg | | -l, --logout | Leave the chat and logout the bot | -l |

Examples

Forward all messages

python zerogram.py -t "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11" -c "987654321"

Send a message

python zerogram.py -t <bot_token> -c <chat_id> -sm "Hello there!"

Delete all messages in the chat

python zerogram.py -t <bot_token> -c <chat_id> -d

Change the bot name

python zerogram.py -t <bot_token> -c <chat_id> -sn "MyCoolBot"

Send a file

python zerogram.py -t <bot_token> -c <chat_id> -f "./images/photo.jpg"

License

This project is open source under the MIT License.