Skip to content

Commonly Used Terms

J Arun Mani edited this page Sep 9, 2020 · 4 revisions

Before we dive deep into commands, some words may need explicit information, so their context in the bot's usage is clear. They are not really technical, but may have a different meaning usually. Remember, unless otherwise stated, the terms are closely tied to Telegram, for example a group means a Telegram group and not anything else.

Clean interval

It is the time in minutes at which unverified users are removed from gateway group. An admin of a group can change its value by sending /settings in direct message to the bot.

Group

A group refers to combination of three groups; gateway group, moderation group and private group. Every group is identified by its id, which is generally not visible to end users. The trio in every group is unique in their own way, which means, you can't make the same gateway group for two different private groups.

Gateway group

A gateway group or simply gateway is the screening group. It is normally a super group (so it is available globally). Any user who wants to join the real group, first has to join gateway and verify they are legit. After proving, they are added to real group and removed from gateway. The gateway group be cleaned regularly. The bot needs to be admin in this group with full permissions.

Moderation / moderate group

It is a group exclusive to admins. The actual use of this group is for bot to report its private messages and other essential information. The bot need not be an admin here.

Private / real / original group

Private group is the actual group where verified members are allowed to join. It should be a private group. The bot needs to be an admin in this group.

Prompt

Prompt is the verification message or banner you want every user who wants to join your group, to know. This could be a set of rules or code of conduct or a filter question. Filter question means asking a question based on your group's subject to know that the user is really interested in joining the group.

Refresh interval

It is the time in minutes at which the invite link of private group is refreshed. An admin of a group can change its value by sending /settings in direct message to the bot.

Remind interval

It is half of the clean interval. At this interval, unapproved users in gateway group are reminded. Since interval are always positive integers, a clean interval of 5 makes remind interval 2 minutes. (5 / 2 = 2.5 ~= 2)