User's guide | Group Help

GroupHelp is a Telegram Bot among the most complete that accompanies you in the management of your groups easily and safely!
Thanks to its many features and commands, enjoy a complete and customizable management.

Developed by @Bruninoit in PHP7, it is online since April 13, 2016 and is continuously updated!

Table of contents

Basics

• What is this Bot for?
• Create a Telegram group
• Add Group Help to a group
• Set Group Help as an administrator
• Main Telegram roles and their permissions
• Adding new administrators
• Anonymous administrators
• Basic commands
• Commands to manage users manually
• Identifying users in a command
• Group Help Security
• List of commands

Advanced

• Clones
• Reduced mode
• The BlockList
• Lang Custom
• Start Custom
• GroupHelp Pro
• GroupHelp UltraPro
• User Roles
• Staff Group
• Log Channel
• Custom buttons
• Backup and Restore
• Command Limitations
• Personals, Replies, Aliases

• Having problems? Contact Us!

What is this Bot for?

Group Help is the most complete Telegram Bot to help you manage your groups easily and safely!

This Bot offers all the most important features:

• group control and protection: anti-flood, anti-spam, banned words, warning system, captcha, media control, anti-porn, night mode, expulsion of inactives, etc.

• utility and simplification of work: welcome message, payment, personalized orders, recurring or programmed messages, statistics, etc..

This manual explains all the commands, settings and features present in the Bot as well as some tips to better manage your group!

👉🏻 Back to the table of contents

Create a Telegram group

Group Help is only useful for managing groups, so if you haven't created a group yet, this is definitely the first thing you should do, and it's simple!

Open the Telegram app and in the left sidebar select "Create Group" and enter the title you want to set.

To finish creating your group you need to add at least one user or bot, we recommend searching for @GroupHelpBot in the search bar that appears and select our Bot. Then finish the operation and the group will be created!

👉🏻 Back to the table of contents

Add GroupHelp to a group

To start using the Bot you first have to add it to your group and set it as an admin. This way you can get started immediately!

There are two ways to add it:

• Go to the group and click on the title at the top
• Click on "add members".
• Search for @GroupHelpBot and select it
• Done!

or click here and select your group!

➕ Send /settings to open the Bot settings
➕ Add @GHSecurityBot and @GHSecurity2Bot for better performance

👉🏻 Back to the table of contents

Set Group Help as administrator

Most of the group management functions require the Bot to have group administrator privileges, here is how to set them:

• Go to the group and click on the title at the top
• Scroll down the list of group users and find the Group Help Bot
• Press and hold (right click on PC) on »Group Help« and select »Promote«
• Press the check mark at the top right or the »Save« button
• Go to the group and click on the title at the top
• Done!

👉🏻 Back to the table of contents

Main roles and their permissions Telegram

In the groups there are 4 types of members depending on the permissions they have:

• Administrators (also includes the group founder) are those who have permissions to manage the group info, users and/or messages.
For each administrator, you can set all or only some of these permissions when you promote that role.
The permissions assigned to an administrator will also be valid for commands used via the Bot.

• Normal users include all users who are able to send messages normally according to the general permissions defined in the group.

• Restricted users are users who, in addition to being subject to the general permissions defined in the group, are subject to other specific restrictions on sending messages, which can range from blocking certain multimedia messages to blocking the group entirely. Members will remain in the group with the ability to only read messages.

• Banned users are excluded from the group, they cannot enter it again and therefore cannot read or write messages.

👉🏻 Back to the table of contents

Adding new admins

It may happen that you need to make some users administrators to get help in managing the group and/or the bot, here is how to add one:

• Go to the group and click on the title at the top
• Click on »Edit« or on the pencil
• Go to »Administrators«.
• Click on »Add admin«, select the user to be promoted as admin and confirm
• Send /reload in group
• Done!

👉🏻 Back to the table of contents

Anonymous administrators

The Telegram »Send anonymously« permission allows the administrator who is the recipient of this permission to not display their profile picture, name or other information within the group.

Anonymous administrators do not appear in the lists of group users and on each message they send, the group's information is displayed instead of its own information, namely:

• The name of the group
• The profile picture of the group
• For any other type of link with an anonymous admin, the information of a bot created by Telegram will be displayed: @GroupAnonymousBot [ID 1087968824 or 12345]

There are two ways for the bot to manage the permissions to be assigned to anonymous administrators:

• Global permissions:
  All anonymous administrators have the same permissions, even if you assign none via Telegram. You can set them here:
• /settings » ▶️ Other » 🕹 Commands permissions » 👻 Anonymous Admin
• Permissions granted individually:
  Each anonymous administrator can have the permissions that were actually assigned to them via Telegram if they have a different custom title than the other administrators.
• To set a custom title:
• group info » Edit » Administrators » select admin
  scroll to the bottom and add a Custom Title different from the others.

👉🏻 Back to the table of contents

Basic commands

The basics to know and use to manage the operation of the Bot in a group are:

• /reload
  It allows you to check that the Bot is perfectly operational: in case of malfunction or error to be corrected, this will be indicated directly in the message from the bot.
  It needs to be used every time you change the permissions of an admin so that the bot detects the changes.
  🔑 This command can be used by administrators and moderators.
• /settings or /config
  It is used to access the configuration menu for the functions that the Bot can perform in the group.
  The options are basically divided into PROTECTIONS and MANAGEMENT.
  Each option in the settings is explained in a simple way directly from the menu that appears when you click on it.
  The permissions for this command can be configured directly from the bot's settings, in the section:
• ▶️ Other » 🕹 Commands permissions » /settings
• /lang
  It allows you to set the language and/or the time zone of the group.
  The default language of the group is based on the user who added the Bot to the group the first time, the default time zone is CET (Central European Time Zone).
• /chimpostazioni
  It allows you to decide which admins can open the bot settings.
  🔑 This command can be only used by the owner (and his co-founder).

👉🏻 Back to the table of contents

Clones

Clones are copies of Group Help having the same identical functions, but giving you the ability to customise your Bot. When you will change clone in the group the settings will remain saved. Clones are faster and more stable.

You can use an official clone or create your own:

• Start @BotFather
• Send the command /newbot
• Type the name the clone will have
• Type the username the clone will have
• Forward (not copy-paste) the message you receive from BotFather containing the Token to @GroupHelpBot
• Done!

👉🏻 Back to the table of contents

Log Channel

A log channel is a channel where all actions concerning the bot and the group are recorded and saved.

To create a log channel, follow these instructions:

• Create a channel (only the group founder can do it)
• Add as admin the same bot present in the group (be careful not to confuse the bots, even if they are similar they are different)
• In the group, go to:

• /settings » ▶️ Other » 🔍 Log Channel » ➕ Add Log Channel

• Send a message in the channel
• Forward (not copy-paste) the message to the group

👉🏻 Back to the table of contents

Staff Group

Group Help allows full integration between the main groups and the staff group which contains the group administrators.

To create a log channel, follow these instructions:

• Add @GroupHelpOfficialCloneBot (or a clone) as administrator to the main group
• Add @GHStaffBot as an administrator to the staff group, not to the main group
• The founder of the main group must send the command /gruppostaff to the staff group
• Forward the message with the ID to the main group to be associated
• Return back to the staff group and press OUI
• Integration completed!

Commands that can be used in the staff group:

▪️ /ban,/unban,/kick,/mute,/unmute,/warn,/unwarn,/warns,/info,/infopvt
▪️ /send - Sends a message to the main group(s) through the GH bot
▪️ /stat - Displays the statistics of the groups linked to the staff group
▪️ Personal, Reply and Alias commands

👉🏻 Back to the table of contents

Reduced mode

The reduced version of Group Help is activated instead of the »full« version when the server encounters problems or when a scheduled maintenance is performed. However, most commands are fully functional.

Some controls and functions are disabled:

• Any operation in private chat with the bot
• Role management commands (modo, director...)
• Modify the parameters
• Information or warning commands
• Night mode start/end notification
• Scheduled deletion, self-destruction, total deletion and delall
• Official support via bots, use official groups instead

👉🏻 Back to the table of contents

Group Help Security

Here we will describe an essential part of Group Help, the two support bots:
• @GHSecurityBot
• @GHSecurity2Bot

To understand their uses, keep in mind that bots have restrictions imposed by Telegram. They cannot do more than X actions in X amount of time, so it is VERY IMPORTANT to have both in the group, or at the very least keep @GHSecurityBot.

The first Security, @GHSecurityBot:
• Will halve the load of the main clone
• Record users who leave the group in the log channel
• Possibly ban some userbot flodders preventively, so that they can't even join your groups.

The second Security, @GHSecurity2Bot:
• It will halve the load of the main clone + the load of @GHSecurityBot
• Will allow to use the »Member management« functions in the settings
• Delete messages more quickly

👉🏻 Back to the table of contents

Identify users with a command

Some Bot commands require you to specify one or more users on which to run a command, there are different ways to make the bot understand which user you intend to run a command on:

• User name: for users who have configured a user name, you can use it to identify them

• Mention: for users without a username, just write an @ in the message bar and then start writing their name, then click on the right result

• Telegram ID: this is a unique number that is used to distinguish a Telegram account. Being the only data that cannot be changed by account owners, they are also the most reliable.

• Reply to a message: you can identify a user by replying to his message in the group, while using a command.
  To reply to a group message, click on it and select »Reply«.

👉🏻 Back to the table of contents

Commands to manage users manually

We will now explain the basic commands to manage and/or sanction group users with the Bot.

🔑 The commands listed in this section can be used by administrators with the »Ban users« permission and by moderators.

• /ban ¹ ²
  This command bans the selected user from the group without giving him the possibility to come back.
  It is also possible to specify a duration and/or a reason by entering it after the user User identifier.
  If you set a time limit, the user will be able to rejoin the group via the link when the time limit has expired.
• Example: /ban @Bruninoit 3 hours rule violation
• /unban ¹ ²
  This command is the reverse action of /ban, it will unblock the selected user and allow him to join the group again (even if a time limit was applied).
  It is also possible to define a reason in the command.
• Example: /unban @Bruninoit The user has apologized

• /mute ¹ ²
  This command will restrict the selected user, i.e. he/she will not be able to write to the group (minimum 30 seconds).
  It is possible to specify a reason and duration of the restriction (minimum 30 seconds).
• Example: /mute @Bruninoit 3 hours violation of the rules
• /unmute ¹ ²
  This command is the reverse action of /mute, it will unblock the selected user and allow him/her to write to the group again (even if a timeout was applied).
• Exemple: /unmute @Bruninoit The user apologized

• /warn ¹ ²
  This command is simply a warning that will not apply any restrictions on the selected user, unless he/she exceeds the maximum allowed limit.
  A time limit can also be applied so that it is automatically deleted.
• Exemple: /warn @bruninoit 3 hours violation of the regulation
• /unwarn ¹
  This command is the reverse action of the warning. A warn will be removed for the selected user. Here it is not possible to enter a reason or duration.
• Exemple: /unwarn @Bruninoit
• /warns ¹
  This command allows you to add and remove warnings for the selected user more quickly.

👉🏻 Back to the table of contents

The BlockList

🚷 The Group Help BlockList is a preventive blocking format created in order to penalize only people who do acts aimed at damaging groups.

👤 Only accounts that have been found to be harmful to the groups are added in BlockList, that is: users who carry out flood, raid, boost actions, participation in stormer teams, sending NSFW material where not allowed, sending child pornography material, who abuses or attempts to damage the services offered by the bot, who impersonates the bot or pretends to be part of the official support of it. All other accounts that we believe are managed by a person who already has at least one account in the BlockList are also entered in the BlockList.

🕓 The permanence of an account in Blocklist has a minimum duration of 30 days, and in some cases it can be extended indefinitely.

ℹ️ In order to request the removal from the blocklist, contact @GroupHelpBot -> Support, by the blocklisted account.

👉🏻 Back to the table of contents

User roles

User roles allow you to assign certain permissions to a user without having to make them an administrator.

They can be permanently or temporarily assigned.

Syntax: /command [reply/username/ID] [Duration]

The available roles:

Related commands

▪️ /listroles - 👮 Sends the list of all assigned roles in private chat
▪️ /staff - Displays the group's team

👉🏻 Back to the table of contents

Backup & Restore

Group Help can create a group backup that will contain the Bot's settings with its custom commands and magic stickers.

📤 To create a backup:
• Send the /backup command to the group
• You will receive a QR code representing your backup in a private message.

📥 To import a backup:
• To import and apply the backup, just send it to the group.

👉🏻 Back to the table of contents

Personals, Replies, Aliases

Custom commands They allow you to perform an action such as sending a message or media.

To create a personal commands:
• Send a message or media to the group
• Reply to this message with:

• /personal [Name of the command]

• Define its parameters and save it

➕ You can use HTML and {ID}, {MENTION}, {NAME}, {SURNAME}, {USERNAME}, {GROUPNAME}.
➕ When /[command] is used, the bot will send the message or media that you have defined.
➕ You can also use the syntax: /personal [Name] [Message/Media]
➕ This command can be called with: /command !command #command .command

Custom Replies: You can create custom responses in the same way as personal commands, but using the /reply command.

E.g.: /reply Hello Hi {USERNAME}!
• When a user sends »Hello« the Bot will reply »Hi @[username]!«

➕ You can use HTML and {ID}, {MENTION}, {NAME}, {SURNAME}, {USERNAME}, {GROUPNAME}

Custom Aliases
An alias is a secondary command that allows one command to be executed with another.

To add an alias, proceed as follows:

/alias byebye ban 24 hours

• In this example, the alias /byebye will be created and will perform the same action as /ban for 24 hours.

👉🏻 Back to the table of contents

Custom buttons

Under some of the Bot messages, GH is able to add custom URL buttons.

These buttons use the {[Text - Link/Function]} format and can be used on the welcome message, on the checkout, in commands, in custom replies and on recurring messages.

{[MyButton - telegram.org]} » will open the telegram.org web page

{[MyButton - popup:MyText]} » will open a popup containing "MyText
{[MyButton - rules]} » run the /rules command
{[MyButton - del]} » delete this same message

⚠️ PRO
{[MyButton - cmd:command]} » execute a custom command
{[MyButton - cmdu:MyCmd]} » The same but can only be used by the user who executed the command
{[MyButton - delu]} » removes this same message but is only usable by the user who executed the command

👉🏼 A demo is available HERE

👉🏻 Back to the table of contents

Command limitations

Due to several abuses, a limitation on the use of certain Bot commands in groups is imposed. This limitation concerns only normal users (neither admin, mod, free) and commands that run on the group.

• @admin and /link are usable once every 30 seconds for the whole group
• /staff and /rules can be used once every 90 seconds for the whole group
• Customized command: each command can be used once every 20 seconds for the whole group

Administrators, moderators and Free users are not subject to the limitations.

👉🏻 Back to the table of contents

🔰 GroupHelp Pro

• Customized replies
Send personalized responses with the bot when specific messages are detected

• Active tags
When a user is tagged, they are notified by a private bot alert (or @ghtagbot if enabled)

• Inline blocker and view counter
Possibility to block messages sent with inline bots or those with a view counter

• ANTI-PORN function
Blocking media considered pornographic

• Improvement of recurring messages
Configure up to 3 recurring messages and the possibility to choose a shorter delay (every 1,2,3 or 5 minutes)

• Advanced buttons
Execute commands instead of links in the buttons (+ info)

• Auto-destruction (2.0)
Program a scheduled self-destruction of messages by filtering by type (text, photos/videos, stikers/gifs....) or/and by role

• cmd:
The ability to use the command (cmd:) syntax to make one personal command trigger another personal command

• Without profile pictures You can choose a punishment for members without profile pictures

• /kool or /fiko and donor group Universal and global command that indicates you have made a donation to Group Help. You will also have access to the GH donor group.

How to get PRO
• Start @GHDonateBot
• Choose a payment method
• Select »GroupHelp - Pro«.
• Follow the instructions to make the donation
• PRO will be added to your account

Activate and deactivate PRO
Use /pro in the group to activate the Group Help PRO mode
Use /unpro in the group to deactivate the Group Help PRO mode

➕ In private chat with a Group Help Bot, send /groupspro to display the number of pro groups available and those you already have.

➕ On the group, send /umh to check if the Pro mode is activated.

👉🏻 Back to the table of contents

💎 GroupHelp ULTRAPRO

• All the Pro advantages
Get all the benefits of the Pro version

• Custom Roles
Create roles with the name and permissions of your choice

• Obligation to subscribe
Require users to subscribe to a channel to write or stay in the group

• Obligation to add users
Force users to add others in order to write or stay in the group

• Second list of banned words
Second list of banned words with different words, a different punishment and the possibility to detect them in the user's profile

• Recurring message 2.0
Up to 50 recurring messages
Choice of days of the week
Choice of a time slot
Choice of an end date

• Improvement of the suppression
Ability to delete all group messages every 6 hours instead of 24

• Silent mode
To not send sanctions messages in the group

• Personalized Answers 2.0
Ability to send personalized responses from the bot when specific words are detected in a message

Groups with up to 5 members can use the UltraPro version for free for testing.

How to get ULTRAPRO
• Start @GHDonateBot
• Choose a payment method
• Select »GroupHelp - Ultrapro«.
• Follow the instructions to make the donation
• UltraPro will be added to your account

👉🏻 Back to the table of contents

Lang Custom

Lang Custom allows you to add a personal language to the Bot and thus customize all the messages of the Bot. This language is applicable to all the groups for which you are administrator.

It is possible to get Lang Custom for a minimum donation of 1.50€:
• Start @GHDonateBot
• Choose a payment method
• Select »GroupHelp - Lang Custom«.
• Follow the instructions to make the donation
• UltraPro will be added to your account

How to use it

The following guide is for users who have already acquired a custom language and do not know how to use the Translation Bot: @GHTranslationsTeamBot

The Bot must not be added to a group, it must be used in the private chat to define its own translation. In the group it will be enough to change the language of the Bot by the personalized one.

Apply language to a group
To activate your translation in a group, simply go to that group and send the command /lang and select Custom.

In the group, you have nothing else to do!

Finding the Bot's messages
Each message of the Bot is identified by a text entirely in capital letters and without spaces, we will call that in a general way a STRING.
To modify a message, you must know its STRING and there are 2 methods to find the STRING of a message:

Method 1: The /search command
In the Bot, there is the /search command that allows you to get the CHAIN of a particular message, let's see how:

Let's say I want to edit the restriction message (/mute):

So I go to the Translation Bot and look for this message:

The word circled in red is the CHAIN linked to the manual restriction message (/mute), now that I know it, I can change it.

Method 2: Language Variables

In the group, in addition to the »Custom« language, you have another language added, the »Variables« language:

By applying it in the group, all the text answers of the Bot are replaced by their respective CHAINS:

In this way, we can see that the CHAIN we are interested in (still for the example above) is MUTATO_MUTED2 , which corresponds to the one we also found with the first method.

Don't forget to put the Custom language back in the group with /lang

Edit a message when I know its CHAIN
Once the CHAIN is obtained, modifying the message is simple, you just have to execute the command /edit CHAIN, putting of course the name of the string to modify in place of CHAIN.

To continue with our example above, I will do /edit MUTATO_MUTED2, let's see what to do:

All I have to do is copy the currently configured message (indicated by the red arrow) and modify it to my liking, then I send it back to the Bot:

At this point, if you have already followed the first paragraph of the guide to apply the personalized language in the group, the new message is already operational, without requiring additional operations:

This can be done with other messages too. If you still have doubts, ask the support group or in the donor group (if you are there).

Useful information when modifying a CHAIN
Here are some tips when editing a message:

1. Keep the same case sensitivity
2. Leave the html format unchanged as much as possible (there is a risk that you will skip some messages if you don't know exactly what you are changing)
3. Leave variables unchanged (e.g. %3%), which contain a variant part of the text (such as username, names, other information, etc.)

Items you can add in the messages: %id% %name% %mention% %username%

which describes the data of the user who launched the command.

👉🏻 Back to the table of contents

Start Custom

Start Custom allows you to change the start message (/start) of your clone.

It is possible to get Start Custom for 1 clone with a minimum donation of 1.50€:
• Start @GHDonateBot
• Choose a payment method
• Select »GroupHelp - Start Custom«.
• Follow the instructions to make the donation
• StartCustom will be added to your account

How to use

• To activate the custom start: /prostart
• To disable the custom start: /unprostart

• To set the message:
└ /setstart Hi, welcome in the bot...

• In the message you can use:
└ %mention%, %id%, %username% and %name%

• To see the message currently set (without formatting):
└ /getstart

• To set the buttons:
└ /setb Text - link.com || Text - link.org

• To see the buttons currently set:
└ /getb

Command list

Find all the commands on: https://telegra.ph/Group-Help-command-list-08-27

Having problems? Contact us!

The GroupHelp team goes to great lengths to support you and solve your problems.

The best thing to do is to ask directly in the support group of your language.

With /support, you can send a message directly to our team from any Group Help clone.

With /intervention, you can request the intervention of a technician in your group.

👉🏻 Back to the table of contents