Help Center

Three things before you start:

1. A Telegram bot token. Get one by messaging @BotFather on Telegram, sending /newbot, and following the steps. Copy the token it gives you.
2. Your Telegram group's chat ID. Add the bot to your group, make it admin, then use /id after generating to confirm the ID matches your .env.
3. Node.js installed on your computer (or a server). Download the LTS version from nodejs.org.

Generate your bot with the ID Command feature selected. Add it to your group, start it, then type /id in the group. The Chat ID shown is the value to put in your .env as GROUP_ID_1.

Chat IDs for supergroups always start with -100. If your group was recently converted from a regular group, the ID will have changed. The /id command always shows the current correct ID.

Open your Telegram group, tap the group name at the top, go to Administrators, tap Add Admin, search for your bot, and enable at minimum: Delete Messages and Ban Users. Without these permissions moderation commands will silently fail.

By default Telegram bots only see messages that start with /. Disabling privacy mode lets the bot read all messages, which is required for features like word filter, anti-spam, anti-link, auto-reply, and rank XP tracking.

To disable: message @BotFather, send /setprivacy, choose your bot, select Disable.

Work through this checklist in order:

1. The bot is a member of your group.
2. The bot is an admin with Delete Messages and Ban Users permissions.
3. Privacy mode is disabled via @BotFather (/setprivacy → Disable).
4. The GROUP_ID_1 in your .env matches the ID shown by /id in your group. They must be identical including the minus sign.
5. The bot window is still open and shows the startup message.
6. You ran Step 3 - Register Commands so commands appear in the menu.

The commands are registered but the bot is not running, or it is running against the wrong group ID. Verify the bot is started (launcher window open and showing the startup message) and that GROUP_ID_1 is correct.

@mention resolution only works for users who have sent at least one message in the group since the bot started. For users who have not spoken yet, always reply to one of their messages instead of using @mention. The bot learns usernames as people talk.

The group ID in your .env does not match the actual group. Use /id in your group to get the correct ID, update GROUP_ID_1 in your .env, and restart the bot.

That is expected. The bot only runs while the launcher window is open. To keep it running permanently you need to host it on a server. The Advanced - Hosting Guide.md inside your bot folder walks through free options including Railway and Render.

Make sure you are using Node.js 18 or higher. The launcher checks this automatically. If you see a specific error, share the full console output (including the error message and the lines above it) with support@tgbotforge.com along with your bot.log file.

In large supergroups Telegram sometimes hides bots from the visible member list even when they are present. Try sending a command directly. If the bot responds, it is working correctly.

A license key is a personal code that unlocks Growth or Pro features in the wizard. You receive it in your purchase receipt email from Dodo Payments immediately after payment. Enter it in Step 1 or Step 4 of the wizard.

Each paid key allows up to 3 bot generations total. This is a lifetime limit, not a daily one. Additional generations are evaluated case by case by support and are not guaranteed. If you need more than 3 generations regularly, purchasing a new key is the standard path.

Contact support@tgbotforge.com. We review requests individually. Additional generations are not guaranteed and depend on the circumstances. Purchasing a new key is the standard option.

Your existing bot keeps running. You own the code and it has no phone-home or kill switch. You just cannot generate new bots with the expired key. Renewing the subscription restores generation access.

Yes. Pro subscribers receive top priority in the support queue. Growth and Starter requests are handled on a best-effort basis after Pro tickets.

All sales are final once a bot has been generated or a license key has been issued, due to the digital nature of the product. If you have a problem before generating, contact support@tgbotforge.com and we will help resolve it.

No. Keys are personal and non-transferable. Sharing a key is a violation of the Terms of Service and will result in the key being revoked without refund.

The generated code is provided for your personal use under the BotForge license. Modifications are technically possible since you have the source files, but any changes you make are entirely at your own risk. BotForge is not responsible for issues caused by modified code and will not provide support for modified bots.

If something is not working as expected on an unmodified bot, contact support and we will help. If you have modified the code, we may ask you to regenerate a clean version before investigating.

You may use your generated bot to manage your own Telegram communities, including communities related to a business. You may not resell, redistribute, or repackage the generated code as your own product.

The Feedback Board at tgbotforge.com/feedback is a public suggestion board where anyone can submit feature requests or ideas and vote on existing ones. No account is required.

Yes. Your IP address is hashed with SHA-256 before being stored - the raw IP is never saved. You can optionally add a Telegram username to your submission, but this is entirely optional and is purely for public display so we can follow up if needed.

You can submit up to 2 suggestions per day per IP address. This limit exists to prevent spam.

Each IP address gets one vote per suggestion. You can upvote or downvote. Clicking the same button again removes your vote. Clicking the opposite button switches direction. The net score (upvotes minus downvotes) determines the default sort order.

Yes. We review submissions regularly and update the status badge on each suggestion to one of: Under Review, Planned, In Progress, Done, or Declined. High-scoring suggestions are the most likely to be prioritised.

Submissions cannot be self-deleted since they are anonymous. If you need a suggestion removed, email support@tgbotforge.com with the content of the suggestion and we will remove it.