✅Whitelist: Create And Management

You can set a list of words or regex patterns that tell the bot to process message you receive from source channel only if it has at least one of the whitelisted word or regex pattern match. Make sure to use the right syntax by reading the examples below.

Important Information

  • Using Simple Syntax will match words partially. This means that when you whitelist the word "es", it will allow every message containing best, rest, test because each of them have the word "es" within.

  • If you want to match words fully, please use the regex example

  • Make sure to use the Python Flavor with regex101.com otherwise your regex will not work on

  • When this command is used incorrectly, it will cause redirections to stop working. Always make sure you use the right syntax when using whitelist and do use regex only if necessary. Make sure you build your regex with regex101.com before inserting them into Auto Forward Bot.

Create New Whitelist

1. Basic Command

/whitelist [ACTION] [LABEL] [WORD_LIST]

Command Information

  • ACTION is add or remove

  • LABEL is the nickname you want to define for your Whitelist.

  • Do not use number for LABEL.

  • WORD_LIST is list word you want use as whitelist. Check Example

❇ī¸ Example ❇ī¸

➡ī¸ Only messages containing hello characters will be forwarded: /whitelist add white1 hello

➡ī¸ Only messages containing hello characters will be forwarded: /whitelist add white1 hello

➡ī¸ Only messages containing cat or dog or chicken characters will be forwarded: /whitelist add white1 cat,dog,chicken

➡ī¸ Remove word list with label white1 /whitelist remove white1

➡ī¸ Show all list Whitelist /whitelist

2. Advanced Command with regex ( Only Platinum)

Use the syntax as shown below when you want to achieve result that is not possible with the simple syntax. This syntax uses regex to search for words and its more powerful than Simple Syntax.

We do not support usage of regex, you are on your own if you decide to use regex. Only use it if you know what you are doing.

Syntax
/whitelist [ACTION] [LABEL]_regex [WORD_LIST]

Command Information

  • ACTION is add or remove

  • LABEL is the nickname you want to define for your Whitelist.

  • Do not use number for LABEL.

  • To create whitelist advance with regex please add LABEL suffix is _regex

  • WORD_LIST is list word you want use as whitelist

❇ī¸ Example ❇ī¸

➡ī¸ Process messages only if it has the any @mention word on it. /whitelist add white1_regex @\S+

➡ī¸ Process messages only if it has any "telegram links" /whitelist add white2_regex (telegram.me|t.me)/\w+

➡ī¸ Process messages only if it has the word black or white /whitelist add white3_regex (black|white)

  • black and white : The words black and white are two words you want forward if have one or both

  • In case you want to match more, you can add more |red|blue in regex

➡ī¸ Process messages only if it has the word es fully (refer to Important Information) /whitelist add white3_regex \bes\b

➡ī¸ Process messages only if it has the word word1 and word2 fully (refer to Important Information) /whitelist add white3_regex ^(?=.\bwork1\b)(?=.\bwork2\b).*$

  • work1 and work2 : The words work1 and work2 are two words you want to have in the forward content

  • In case you want to match more, you can add more (?=.\bwork3\b)(?=.\bwork4\b) in regex

* When add whitelist is ^(?=.\bwork1\b)(?=.\bwork2\b).*$ it will only process messages have contain work1 and work2 like:
  "I have work1 to do and work2 as well."
  "work1 and work2 are both important."
  "work2 is harder than work1."
* Will block if not have both work1 and work2 or only have work1 or work2 like:
  "Only work1 is left."
  "work2 is complete"
  "Nothing to do here."

4. Combined many Words or Expression regex ( Only Platinum)

Syntax
/whitelist [ACTION] [LABEL]_regex [WORD_LIST] ==AND== [WORD_LIST]

Command Information

  • ACTION is add or remove

  • LABEL is the nickname you want to define for your Whitelist.

  • Do not use number for LABEL.

  • To create whitelist advance with regex please add LABEL suffix is _regex

  • WORD_LIST or Expression regex is list word or expression regex you want use as whitelist.

  • ==AND== is the conditional keyword (required)

❇ī¸ Example ❇ī¸

  • ➡ī¸ Process messages only if it has the words black and white /whitelist add whiteAndBlack_regex black==AND==white

    ➡ī¸ Process messages only if it has the word vip1 and vip2 and (vip3 or vip4) /whitelist add vip_regex vip1==AND==vip2==AND==(vip3|vip4)

5. Filters User use Whitelist ( Only Platinum Plan)

This feature allows you to forward messages only from specific users that you select. By using a Whitelist, you can specify which users' messages should be forwarded by their USER_ID or USER_NAME.

  1. To use this feature, you'll first need to find the User ID of the users you want to whitelist. Follow these steps:

    • Go to the chat where you want to receive messages from specific users.

    • Use the command /getid in the chat.

    • Note down the User ID that appears. You can then add this User ID to your Whitelist.

Note: To use the /getid command, please make sure you are using a Telegram account that is connected to the AutoForward Telegram Bot.

  1. Next, use the following syntax to create filters based on the whitelist of users:

Syntax
/whitelist [ACTION] [LABEL]_user [USER_ID1,USER_ID2,...,USERNAME1,USERNAME2,...]

Explanation:

  • [ACTION]: The action you want to take (e.g., add, remove, or list).

  • [LABEL]_user: The label you assign to this whitelist (e.g., trusted_user, groupA_user).

  • [USER_ID1,USER_ID2,...]: A list of User IDs.

  • [USERNAME1,USERNAME2,...]: A list of Usernames.

  • You can mix User IDs and Usernames in the same command.

Example Usage:

  • Add multiple users to a whitelist using their User IDs:

    /whitelist add groupA_user 12345678,87654321,23456789
  • Add multiple users to a whitelist using their Usernames:

    /whitelist add vip_user johndoe,janedoe,alice123
  • Add users to a whitelist using both User IDs and Usernames:

    /whitelist add trusted_user 12345678,johndoe,87654321,alice123
  • Add a single user to a whitelist using a User ID:

    /whitelist add staff_user 98765432
  • Add a single user to a whitelist using a Username:

    /whitelist add client_user janedoe

This flexibility allows you to manage your whitelist efficiently, accommodating both User IDs and Usernames as needed.

Apply/Deactivate Whitelist for Task

1. From Auto Forward Messages BOT typing command /whitelist to show list whitelist

2. From your list whitelist choose item whitelist you want apply. Then choose will goto detail whitelist

3. At detail whitelist will show all your task forward

4. Now you can click to task will apply or click apply to all task if want apply for all

Describe Status

Normal status is Deactivate

✅ is status Activated

Remove All Whitelist

⭕ī¸ Use Command /whitelist then select Delete All

Video Whitelist

Last updated