地球人

地球人的空间

世上本没有路
tg_channel
mastodon
pleroma
HomeArchives🔍 全站搜索 🔍其他LanguageLinksIP

CSUBOT Robot Help Documentation

81
AI Translation
This post is translated from Chinese into English through AI.View Original
AI-generated summary
CSUBOT is a super admin bot designed to verify new members through a captcha, preventing spam bots in group chats. It aims to enhance functionality in the future while avoiding interruptions in group conversations. ### Joining a Group as a User When you click on an invitation link, the prompts differ based on the group type: - **Private Group**: You will see a card indicating that admin approval is required to join, with a "Request to Join Group" button. - **Public Group**: You can view chat history and will see an "Apply to Join Group" button. After applying, the bot will message you privately with a verification button. You need to click it and complete the verification on the web page to join the group. Ensure your Telegram app is updated to the required versions. ### Using the Bot as a Group Admin To use the bot, you must be either the group owner or an admin with specific permissions (Invite Users via Link, Ban Users, and Delete Messages). **Steps to Add the Bot as Admin**: 1. Add the bot as an admin and grant the necessary permissions. 2. Enable member approval for the group. **Enabling Member Approval**: - For both public and private groups, navigate to group settings, select "Only members" under message permissions, and enable "Approve New Members." ### Common Questions - **IP Address Collection**: This is a standard Telegram notice. CSUBOT does not store personal data. - **Difference from tg-watchdog**: CSUBOT has evolved through iterations, now using Golang for efficiency and supporting more languages. It is compatible with tg-watchdog. ### Deployment You can deploy your own CSUBOT by following the provided documentation. ### Acknowledgments The project references tg-watchdog for its front end and has been developed with contributions from various sources.

CSUBOT is a super administrator bot.

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

Advantages: It does not post verification requests in the group, avoiding interruptions to group chats and disturbing other group members.

Recommendation: Check the public IP of this device when accessing different websites for checking the current network environment.

How to join the group as a user?#

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

  • If the group is private: You will see a group card and be prompted that you need administrator approval to join the group, with a join button "Request to Join Group".
  • If the group is public: 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 privately message you with a message containing a verification button. You just need to find this message, click the button, and complete the verification in the pop-up webpage to join the group.

Of course, you need to upgrade Telegram to at least the following versions to use the related features.

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

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" permissions for the group

The bot requires permissions for Invite Users via Link, Ban Users, and Delete Messages. 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 or leaving the group. Future AI review features will also use this permission.

Steps to operate#

First, add the bot as an administrator, then enable the group entry review switch.

If you cannot find the relevant settings mentioned later, please upgrade your client to the latest version.

Adding the bot as an administrator#

Method 1: Open https://t.me/csubot?startgroup=start&admin=can_invite_users, select the group to which you want to add the bot, confirm granting the three permissions: Invite Users via Link, Ban Users, and Delete Messages, then click the "Add Bot as Admin" button.

Method 2:

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

Enabling the group entry review switch#

Enable entry review for public groups#

  1. Click on the group where you want to enable the bot (or open the settings of the channel bound to the group in the Android client), open the profile page, and click "Edit" or "Manage Group".
  2. Click "Group type", and in the "Who can send messages" section, select "Only members" (if this option is not available, proceed to the next step).
  3. Enable the "Approve New Members" switch that appears below, and click "Save" or "Done" to apply the changes.

Enable entry review for private groups#

  1. Click on the group where you want to enable the bot (or open the settings of the channel bound to the group in the Android client), open the profile page, and click "Edit" or "Manage Group".
  2. Click "Group type", and in the "Who can send messages" section, select "Only members" (if this option is not available, proceed to the next step).
  3. Enable the "Approve New Members" switch that appears below, and click "Save" or "Done" to apply the changes (if this option is not available, proceed to the next step).
  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 invitation link creation page. On this page, turn on the "Request Admin Approval" switch. Do not impose any other restrictions. After ensuring the settings are correct, click the "Create" button.
  6. Share the link created in the previous step. Do not share the default link; joining the group through the default invitation link will prevent the bot from conducting reviews. (If you mistakenly shared the default invitation link, you can click the "..." button on the right side of this link and click "Revoke" to ensure the previously shared link becomes invalid.)

Frequently Asked Questions#

Why am I prompted that csubot will collect IP addresses?#

This is a fixed prompt from Telegram.

The web application of Telegram (web app) is built on web technologies. Similar to when you access other websites using your browser, when you use it, your IP address is included in the network requests sent to csubot.

If it is a malicious bot, it may misuse your information. Therefore, Telegram displays this prompt to avoid liability.

Rest assured, csubot does not store any personal data or data from the groups you join.

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

What is the relationship and difference between csubot and tg-watchdog?#

csubot has undergone many iterations and is currently in its fourth major version. Previous versions used Python, JavaScript, and other languages, focusing on AI review and not open-sourcing the code.

In practical use, it was found that AI review had many misjudgments, and using the same prompt could not meet the review requirements of various groups.

In fact, the solution of "the bot confirms that the person joining is human, combined with group administrators manually reviewing group members' speeches" can meet the requirements of most groups to prevent advertising bots.

Therefore, I 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, and you can use the tg-watchdog front end + csubot back end; or csubot front end + tg-watchdog back end.

The current differences are:

  • The back end is written in more efficient Golang.
  • The web front end and bot back end support more localized languages.
  • Supports deleting messages from group members joining or leaving the group.

Can I deploy a csubot myself?#

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

Acknowledgments#

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

https://t.me/bot_zh The documentation references this channel.

Github, Google, ChatGPT

Other versions of this webpage#

This article is available in multiple languages.

If you want to leave a comment, please visit the following webpage:

ZH EN ZH-TW JA

These pages are for browsing only and do not support comments or messages, but provide more language options and shorter 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

Loading...
Ownership of this post data is guaranteed by blockchain and smart contracts to the creator alone.