CSUBOT is a super administrator bot.

Currently, it can verify new members through verification codes, automatically preventing spam bots in group chats. More features will be added in the future.

Advantage: Does not post verification requests in the group, avoiding interrupting group chats and disturbing other group members.

You can click here to test the CSUBOT bot’s group entry review function: Join CSUBOT’s discussion group

Recommended: Check the public IP of this machine when accessing different websites to check the current network environment.

Open the bot: @csubot

How to join a group as a user?

After you click the group joining invitation link, depending on the type of group you are joining, you may see one of the following two prompts:

  • If the group is a private group: You will see a group profile and a prompt that you need to be approved by an administrator to join the group, with a “Request to Join Group” button.
  • If the group is a public group: You can see the group chat history, and the join button at the bottom is “Apply to Join Group”.

After clicking the button to send a join request, the bot will send you a private message with a message containing a verification button. You only need to find this message, click the button, complete the verification in the pop-up webpage, and you can join the group.

Of course, you need to upgrade Telegram to at least the following versions to use the related functions. These versions of the client were released in 2022, which means that if your Telegram client was installed after 2022, you can use the CSUBOT bot to complete the group entry review.

  • Telegram iOS v8.7.0 (23204)
  • Telegram Android v8.7.0 (2622)
  • Telegram macOS 8.6.0 (228674)
  • Telegram Desktop 3.7.0

Of course, you can also use the web version of Telegram to complete CSUBOT’s verification. Login address:

How to start using the bot as a group administrator

Prerequisites

To perform this operation, you need to be one of the following:

  • Group Owner
  • Group Administrator with “Invite Users via Link” and “Add New Admins” administrator permissions for the group

The bot needs Invite Users via Link, Ban Users and Delete Messages permissions. Among them,

  • Invite Users via Link and Ban Users are used to verify new members
  • Delete Messages is used to delete messages from group members joining and leaving the group. The future AI review function will also use this permission.

Operation steps

First add the bot as a group administrator, then turn on the group entry review switch.

If you cannot find the relevant settings in the following text, please upgrade your client to the latest version.

Add bot as administrator

Method 1: Open https://t.me/csubot?startgroup=start&admin=delete_messages+ban_users+invite_users , select the group to add the bot to, confirm that you grant the three permissions: Invite Users via Link, Ban Users and Delete Messages, and then click the “Add Bot as Admin” button.

Method 2:

  1. Click on the group where you need to enable the bot (or open the settings of the channel bound to the group on the Android client), open the profile page, and click “Edit” or “Manage Group”.
  2. Click “Administrators”, click “Add Administrators”
  3. Enter @suabot (including @)
  4. Confirm that you grant the three permissions: Invite Users via Link, Ban Users and Delete Messages

Turn on the switch for group entry review

Enable group entry review for public groups

  1. Click on the group where you need to enable the bot (or open the settings of the channel bound to the group on the Android client), open the profile page, and click “Edit” or “Manage Group”.
  2. Click “Group type”, in the “Who can send messages” section, select “Only members” (if you don’t have this option, please proceed to the next step directly)
  3. Turn on the “Approve New Members” switch that appears below, and click “Save” or “Done” to make the changes effective.

Enable group entry review for private groups

  1. Click on the group where you need to enable the bot (or open the settings of the channel bound to the group on the Android client), open the profile page, and click “Edit” or “Manage Group”.
  2. Click “Group type”, in the “Who can send messages” section, select “Only members” (if you don’t have this option, please proceed to the next step directly)
  3. Turn on the “Approve New Members” switch that appears below, and click “Save” or “Done” to make the changes effective (if you don’t have this option, please proceed to the next step directly)
  4. In “Manage Group”, click “Invite Links” to enter the group link management page
  5. Click the “Create a New Link” button at the bottom of the management page to enter the new invite link creation page. On this page, turn on the “Request Admin Approval” switch. Do not make any other restrictions. After ensuring that the settings are correct, click the “Create” button.
  6. Share the link created in the previous step. Do not share the default link. The bot cannot review group entries through the default invitation link. (If you accidentally shared the default invitation link, you can click the “…” button on the right side of this link and click “Revoke” to ensure that the previously shared link is invalid.)

Common questions

I cannot pass the Cloudflare CAPTCHA verification

I can open CSUBOT’s verification page, but I cannot pass the Cloudflare CAPTCHA verification. What should I do?

When the Cloudflare CAPTCHA widget is loading, you can randomly move the mouse or slide the screen on CSUBOT’s verification page.

If it still doesn’t work, try another client or the web version of Telegram. Web version login address:

If your network speed is too slow or your IP changes frequently, it may also cause verification failure.

Why am I prompted that csubot will collect IP addresses?

This is Telegram’s fixed prompt.

Telegram’s web app is built on web technology. Similar to when you use a browser to visit other websites, when you use it, your IP address will be included in the network request sent to csubot.

If it is a malicious Bot, it may abuse your information. So Telegram displays this prompt to avoid taking responsibility.

Please rest assured that csubot will not store any data about you personally or the groups you join.

You can visit csubot’s source code repository to review and audit its code.

What are the connections and differences between csubot and tg-watchdog?

csubot has undergone many iterations and is currently the fourth major version. The previous versions used Python, Javascript, and other languages, focusing on AI review and not open source.

In actual use, it was found that AI review has many false positives, and using the same prompt cannot meet the review requirements of various groups.

In fact, the solution of [robot confirming that the person joining is human, plus group administrators manually reviewing group members’ speeches] can meet the requirements of most groups to block advertising robots.

Therefore, the csubot author referred to the implementation of the mature tg-watchdog project and rewrote the fourth major version of csubot,

Currently, the code is fully compatible with the tg-watchdog project. You can use the tg-watchdog front-end + csubot back-end; or the csubot front-end + tg-watchdog back-end.

Currently, there are the following differences:

  • The back-end is written in more efficient Golang
  • The web front-end and robot back-end support more localized languages
  • Support deleting messages from group members joining and leaving the group

Can I deploy a csubot myself?

Of course! Click here to view the deployment documentation: Deployment Documentation

Why am I prompted to grant csubot personal data?

You may see the following message on our website:

Asks for your consent to use your personal data to:

  • Personalised advertising and content, advertising and content measurement, audience research and services development
  • Store and access information on a device

To ensure compliance with regulations in the European Economic Area (EEA), the UK and Switzerland, we display this prompt to users in those regions. Services provided by Google and Cloudflare may collect this data.

Some US states also have similar regulatory requirements, so similar prompts will also be displayed.

Acknowledgements

https://github.com/tg-watchdog/tg-watchdog , the front-end is forked from this project. The back-end of the CSUBOT project can be used with the front-end of this project and is fully compatible. The documentation also refers to this project.

https://t.me/bot_zh The documentation refers to this channel

Github, Google, ChatGPT

Other versions of this webpage

This article is available in multiple languages.

If you would like to leave a comment, please visit the following webpages:

ZH EN ZH-TW JA

These pages are read-only and do not support comments or leaving messages, but provide more language options and faster loading times:

ZH EN ZH-TW JA RU KO CS ES AR FR PT DE TR IT NL SV DA FI PL UK HE RO HU EL HR TH HI BN ID SW VI NO