Seting the bot via text commands
Basic Description
At the beginning of all management commands of the bot you must place an exclamation mark (!) or a dot (.).
As per the given examples, you are required to send the commands to your group in the form of a standard message.
Execution of the actions of manually removing, resticting, and freeing users.
In order to perform manual actions such as banning, restricting, or freeing a user, please reply to the user's message and issue one of the following commands:
!kick 1
!silence 1
!free
The number 1 indicates the duration that the user remains silent, or unable to return to the group after being banned. For example, if you want a user to remain silent for 24 hours, you should reply this command:
!silent 24
If you enter 1000 as the duration, it wil become permanent.
To remove all warnings issued to a user:
!reset
Commands related to renewal and credit
Bot credit Renewal
!renew
Checking the bot expiry date and time
!credit
Different types of locks:
Prohibition of telegram links
To prevent posting of joinchat telegram links
For instance:
!lock link
!unlock link
Prohibition of username
To prevent usernames (tags starting with @).
For instance:
!Lock username
!unlock username
Prohibition of website links
To block off-telegram links (URLs of other sites or softwares)
For instance:
!lock website
!unlock website
Prohibition of pornographic words
To smartly prevent sending any pornographic words (English and persian supported only).
For instance:
!lock porn
!unlock porn
Prohibition of hashtag
To prevent tags starting with #.
Prohibition of Texts
To prevent sending text messages.
For instance:
!Lock text
!unlock text
Prohibition of Forward
To prevent forwarding messages to the group (From user or from channels)
For instance:
!Lock Forward
!unlock forward
Prohibition of Forwarding from channels
To prevent forwarding messages to the group (Only from channels)
For instance:
!Lock Forward from channel
!unlock forward from channel
Prohibition of Photos
To prevent sending photos to the group
For instance:
!Lock photo
!unlock photo
Prohibition of movies
To prevent sending videos
For instance:
!lock movie
!unlock movie
Prohibition of Sticker
To prevent sending stickers
For instance:
!Lock sticker
!unlock sticker
Prohibition of Location
To prevent sending location
For instance:
!Lock location
!unlock location
Prohibition of Phone Number
To prevent sending phone numbers
For instance:
!Lock phone number
!unlock phone number
Prohibition of voice messages
To prevent sending voice messages
For instance:
!Lock voice
!unlock voice
Prohibition of file
To prevent file upload (except softwares)
For instance:
!lock file
!unlock file
Prohibition of Software
To prevent sending softwares
For instance:
!lock software
!unlock software
Prohibition of GIFs
To prevent sending gifs (animations) to the group
For instance:
!Lock GIF
!unlock gif
Prohibition of Polls
To prevent sending polls created through telegram (polls created by bots are not prohibited by this option).
For instance:
!Lock poll
!unlock poll
Prohibition of slash commands
To prevent sending bots slash commands, like:
/start
For instance:
!Lock slash
!unlock slash
Prohibition of textless posts
To prevent posts that contain only image or video and do not contain a caption below them.
For instance:
!Lock without caption
!unlock without caption
Prohibition of posts containing emojies alone
To prevent sending messages that only have emoticons inside them.
For instance:
!Lock emoticons alone
!unlock emoticons alone
Prohibition of posts containing emoticons
To prevent sending messages that contain emoticons
For instance:
!Lock emoticons
!unlock emoticons
Prohibition of games
To prevent sending games
For instance:
!Lock Game
!unlock game
Prohibition of English characters
To prevent sending posts containing English letters.
For instance:
!Lock English
!unlock english
Prohibition of Arabic and Farsi
To prevent sending Arabic and Farsi letters (Both languages will get limited together).
For instance:
!lock Arabic and farsi
!unlock arabic and farsi
Prohibition of replying of regular users
This lock is used To prevent regular users from replying each others' messages. Ordinary users can only reply on admins' messages, and admins can reply on everybody's messages.
For instance:
!Lock Reply
!unlock reply
Prohibition of external reply
This lock is used To prevent regular users from replying on other chats messages
For instance:
!Lock external reply
!unlock external reply
Ignore all rules for one user (whitelist)
Reply on a user's message or on a message in which the bot has addressed the user, and sending the following command you can exempt that user from all restrictions:
Note: If you add a user to the whitelist, the bot will not check any of their messages.
!add to whitelist
Removing a user from whitelist
Reply on the user's message and send this command:
!remove from whitelist
Erasing the whitelist:
Removes all users from the whitelist,
!wipe whitelist
Determination of a specific penalty for each of the prohibitons
You can set different penalties for different prohibitons. For example, if someone sends a link, ban them, and if they forwarded a message, just delete their message:
For instance:
!kick link
For instance:
!delete Forward
!delete forward
For instance:
!silence photo
Management of users messages counts
Limitation of messages count
This command restricts users from sending more than a specified number of messages within a specific timeframe.
For instance:
!messages number limit set on 5
!messages number limit set on disable
The timeframe of calculation of the number of messages
This command determines the duration during which the number of user messages will be monitored. For instance, if the message count limit is set to 3 and this field is configured for 60 minutes, each user will be restricted from sending more than 3 messages within a 60-minute timeframe.
For instance:
!in every 2 hours
Max number of duplicates allowed
This command serves the purpose of preventing multiple duplicate messages from being sent to a group within a specific timeframe. For instance, By setting this option to 3, it ensures that a message cannot be replicated more than 3 times within the designated interval you have specified.
For instance:
!duplicate set on 3
!duplicate set on disable
Duplicated messages counting timeframe
In this command, duplicate messages are taken into account within the specified time frame. For instance, if you set the maximum number of duplicates to 3 and the time interval to 60 minutes, each message will be limited to a maximum of 3 repetitions within every 60-minute time frame.
For instance:
!duplicate in every 2 hours
Minimum number of message words
This lock function will automatically delete any message that contains fewer words than the specified threshold. For instance, if you set this option to 2, any message consisting of only a single word will be deleted.
For instance:
!minimum number of words set on 3
!minimum number of words set on disable
Maximum number of message words
This lock feature will delete any message that exceeds the specified word count.
For instance:
!maximum number of words set on 10
!maximum number of words set on disable
Mandatory Memberships
Pyramid Lock - FORCEDADD
This option mandates that each user must invite a certain number of users to the group before being permitted to send a message to the group.
For instance:
!forced add set on 5
!forced add set on disable
Exempt old group members from ForcedAdd
All members who were part of the group prior to executing this command will be exempted from the forcedadd requirement.
!ignore forcedadd for all
To reactivate the forcedadd for all users:
!enable forced add for all
To ignore ForcedAdd for a particular user
You have to reply this command to the user's message, if the user's message has already been deleted, please reply to the message sent by the bot in which the user is mentioned.
!ignore from forcedadd
To re-activate ForcedAdd for the exempted user:
Reply on one of thier messages and send this command:
!enable forced add
Mandatory Channel Membership
Each user must subscribe to a channel before sending a message to the group.
!join @username
!join disable
To use this, you need to have made the bot an admin in your channel.
To exmept a user from mandatory channel joining
You have to reply this command to the user's message, if the user's message has already been deleted, please reply to the message sent by the bot in which the user is mentioned.
!ignore channel
To re-enable mandatory channel joining for the exempted user:
Reply on one of thier messages and send this command:
!enable channel
Prohibition of bots, spammers and userbots
Prohibition of invitation of bots
Any bot added to the group will be deleted immediately.
For instance:
!Lock bot
!unlock bot
Banning the one who invited a bot to the group.
Anyone who invites a bot will be banned from the group.
For instance:
!lock bot inviter
!unlock bot inviter
Prohibition of Advertiser bots (userbots)
Userbots are regular accounts that are programmed to send out promotional messages or add malicious bots. The bot recognises them in other groups and bans them as soon as they join your group:
For instance:
!kick tabchie
For instance:
!silent tabchie
For instance:
!free tabchie
Prohibition of advertisements of unofficial apps of telegram
Unofficial telegrams misuse users' accounts and send their own ads to groups without their permission. This is a lock To prevent these kind of messages.
For instance:
!Lock unofficial telegram
!unlock unofficial telegram
Setting Timings for settings
You can set a start and end time for each setting so that the rule only be executed at its own time. To do this, just type in the words "from x to y" in the command.
!Lock link from 23:30 to 8:10
Silent times settings
Silent time
Using this command, the silent time is automatically activated and deactivated at the specified times.
It is possible to specify the up to three silent times in a day.
!First silent time from 23 to 8
!disable first silent time.
!Second silent time from 10 to 14
!disable second silent time.
!Third silent time from 18 to 20
!disable third silent time.
In order to delete all silent times settings:
!Delete all silent times
Temporary pause (Manual)
Using this command you can manually lock the group and it will remain locked until it is manually released.
For instance:
!lock group
!unlock group
Censoring words
Censoring pornographic words (Only English and Farsi is supported)
The bot has a database of pornographic words that can automatically and intelligently detect them and you do not need to enter words manually.
For instance:
!lock porn words
!unlock porn words
Censoring specific words
You can use the following command to filter specific words:
For instance:
!censor blah
To uncensor the word:
For instance:
!uncensor blah
To see the list of censored words:
For instance:
!censor list
You can also refer to the management panel to see the list of censored words.
Cleaning up
Count based cleanup
For example to delete 100 recent messages of the group:
!Cleanup 100
Time based Cleanup
For example to delete messages sent in the last 24 hours:
!cleanup 24 hours
Cleaning up from one message to the last message of the group
Reply on a message and send the following command:
!cleanup from here
Cleaning up the whole group
Deletes all group messages.
!Cleanup the whole group
Cleaning up bots
Detects and bans all the bots in the group.
!Cleanup bots
Cleaning up the group from deleted accounts
Detects and removes all the deleted accounts from group.
In groups with more than a thousand members, Telegram does not allow any of the group administrators to scan all the members of the group.
!Cleanup deleted accounts
Other settings:
Sending welcome message
A welcome message is sent to the group when a new member joins
For instance:
!enable welcome
!disable welcome
Sending Rules message
A message containing group rules is sent when a new member joins the group.
For instance:
!enable Rules
!disable rules
If the rules text is blank, a message containing active bot locks will be sent.
To edit the welcome message text and the rules text, refer to the management panel.
Auto deletion of bot messages
Enabling this option will cause the bot to automatically remove all the messages that the bot sends after a period of time. This is To prevent the group from getting crowded.
For instance:
!Enable self-destruct
!disable self-destruct
Auto deletion of bot messages time
The bot deletes its own messages after this period of time.
!self-destruct time set on 2
The bot deletes its own messages after 2 minutes.
Removal of join and leave notification
Deletes srvice messages indicating the user has been added to the group or has left the group.
For instance:
!Delete join and leave
!delete join and leave
For instance:
!dont delete join and leave
Send user an admonition message for violation of the rules
By enabling this option, the bot announces the reason of warning to the user whenever it deletes a message.
For instance:
!enable adminition
!disable adminition
Automatically counting users warnings
When this option is enabled, it will keep track of the number of violations committed by users.
For instance:
!Enable Auto warning
!disable auto warning
Timeframe of keeping warnings (days)
In accordance with the specified time frame in this option, each warning will be automatically erased from the bot's memory.
!keep warnings for 2 days
Will keep warnings for up to 2 days with this command.
Maximum number of warnings allowed
If the number of warnings surpasses the specified threshold, the user will be silenced for a duration of 12 hours.
!maximum warnings set on 10
Introduction of Group Administrators to the bot
Although the bot automatically detects changes to the group admins list, if you wish to manually trigger a reload of the admin list, you can use the following command:
!reload
Administrators are granted exemption from all rules and possess access to the bot settings within the group.
Check rules violation by admins
By enabling this option, group admins will be treated as regular members. Their violations will no longer be overlooked, and they will be restricted from commanding the bot. Only the owner of the group will have access to the settings.
For instance:
!Lock admins
!unlock admins
Administrators who possess the privilege of adding new admins are designated as the group owner and will not be subject to any limitations imposed by enabling this option.
Counting the number of invitations
The bot consistently keeps track of the number of members added by each individual member, and you can request the members's count at any time.
To obtain the list of users who have invited the highest number of other users, please refer to the following command:
Using this command, you can retrieve the list of users who have invited the highest number of other users:
For instance:
!who added the most?
To limit the list to a specific time period, with a maximum limit of 30 days, you can utilize the following command:
For instance:
!from 2 days ago, who added the most?
For instance:
!from 3 hours ago, who added the most?
Getting the number of a specific user invitations
To obtain the statistics or information regarding a specific user, you can utilize the following command:
This command must be replied on the user's message
How many people did this user invite?
Info
The two aforementioned commands are considered public commands, which means they can be executed by all members of the group. These commands do not require the use of an exclamation mark (!) as a prefix.
Public Commands
Public commands are those that regular users can utilize without the need for an exclamation mark (!) as a prefix. These commands are accessible to all members of the group.
Public commands list
To obtain the group link
Send group link
To obtain the group description
What is this group for?
To inquire about the user who added a specific member, you can employ the following command:
Who added me?
Who added this user?
To inform group admins about a specific message, reply on that message:
Report
To retrieve the number of adds done by a particular member:
How many people did I add?
How many people did this user add?
The above command must be replied to a user's message
My info
Info
The above command must be replied to a user's message
To inquire about the reason for deleting a user's message:
If a user sends this public command to the group, the bot will announce the reason why their message was deleted.
Why was my message deleted?
Deactivation of public Commands
By enabling this option, the bot will cease responding to public commands from regular users, restricting access to public commands only for administrators.
For instance:
!Lock public commands
!unlock public commands
To modify the text of bot messages:
To modify the texts of bot messages within your group, you can refer to the management panel by clicking the button provided in the bot's private chat.
Setting the bot from management panel
In addition to text commands, you can also configure the bot settings through the management panel. To access the management panel, navigate to the bot's private chat and click on the "Management Panel" button to proceed.
