> For the complete documentation index, see [llms.txt](https://docs.quickbotify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quickbotify.com/bots/forwarder-bot.md).

# Forwarder Bot

The Forwarder Bot automatically forwards messages, files, or media from one chat/channel to another based on configured rules.

## Features

1. **General Forwarding**: Easily redirect messages to multiple groups or channels using specified rules.&#x20;
2. **Anonymous Forwarding**: Hide the source group/channel of the message along with the sender.

## Usage

First things first, you can add the forwarder bot from the home page after your login. For more info on how to add a bot and its initial setup, have a look [here](https://docs.quickbotify.com/fundamentals/getting-set-up).

{% hint style="warning" %}
Please note that the forwarder bot only works when your telegram bot is added to both the source group/channel and target group/channel(s) as an admin.&#x20;
{% endhint %}

### General Forwarding

{% stepper %}
{% step %}
First piece of information that you need to setup the forwarder bot is the group/channel id of both the source and target. Our telegram bot, **@quickbotifybot** can help you with that.&#x20;

* Add **@quickbotifybot** to both source and target group/channel(s) as an admin. To do that, open your group/channel in Telegram, click on 3 dots icon at the top.

<figure><picture><source srcset="/files/XLlHiiIFfg9irr7xBSUy" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2F1Urx7RUKRbrkaxUCv6NI%2Fmanage_channel_light.png?alt=media&amp;token=c1ac28b3-6115-479c-b33c-4a5c80b3171d" alt=""></picture><figcaption></figcaption></figure>

* Click on Manage Channel/Manage Group and then go to Administrators. Click on Add Administrator.

<figure><picture><source srcset="/files/1X5v4DnxAMaQQEExvmfT" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FnaEJzdgNlyHWkSmZdF5J%2Fscreenshot%20(8).png?alt=media&amp;token=a306d1ba-70ca-457b-a999-e2b98d92d62b" alt=""></picture><figcaption></figcaption></figure>

* Search for **quickbotifybot,** click on it and click OK if telegram shows any prompt asking to add the bot as an admin. Make sure you select the bot with the correct username.&#x20;

<figure><picture><source srcset="/files/Uwb0nu5zH4e5wSuWE7BE" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FJXRKLXvxB1Eeh3gVFBWq%2Fadd_bot_light.png?alt=media&amp;token=e7ebd03d-9e8b-49a6-a4dc-2e3400cf0bcc" alt=""></picture><figcaption></figcaption></figure>

* Once the bot is added, send **/getgroupid** in the chat and **quickbotifybot** will provide you the group/channel id. You can do this for both source and all the targets. Once you have them all, proceed to next step.

<figure><picture><source srcset="/files/IALGHegOZORcIcaVmi0S" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2F7p1pq1F3hvETrgGMqgCZ%2Fimage.png?alt=media&amp;token=4ca9def5-9450-4d15-b48c-770762ab17b7" alt=""></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Now that you have the IDs of both source and target, it is time to configure them on Quickbotify.   Go to settings of your forwarder bot on Quickbotify. Scroll to **Advanced Configuration** section on the settings page and click on **Add**.

<figure><picture><source srcset="/files/p40sc3KkQSM2P9DgsBGV" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FoEnFIEi2065zy35ykLej%2Fimage.png?alt=media&amp;token=04a2173a-afac-487a-8615-a105730d1913" alt=""></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
It is time to fill in the values now. You will see 5 fields here of which 2 are mandatory.

<figure><picture><source srcset="/files/BHONZAjwwgzmpwRhmrih" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2F2uoRy187uz1311VCcsJI%2Fimage.png?alt=media&amp;token=8710ee03-cf30-40b9-8620-cef0bdcfaa71" alt=""></picture><figcaption></figcaption></figure>

* **From Group** - Group/Channel id of the source needs to be filled in here. It can only be a single value.
* **To Group** - Group/Channel id of the target needs to be filled in here. It can contain more than one value as well separated by comma(,).
* **Text Match Type (Optional)** - This field works together with the **Text Pattern** field. Clicking on this field opens up a dropdown window which contains 5 conditions i.e., *Starts With, Contains, Ends With, Equals, Does Not Contain.* You need to select a condition here based on your requirement. For e.g., If you want to forward all the messages that contains the word '*ticker',* you will select *contains* here in this field and in the **Text Pattern** field, you will enter *ticker*.
* **Text Pattern (Optional) -** As mentioned above, **Text Match Type** and **Text Pattern** field works together. Have a look at the explanation of **Text Match Type** field to get more info on this.
* **Sent By (Optional)** - If you want to restrict the forwarding to forward the messages only sent by a particular user, you can add the userid of that user in this field. To get your userid, you can send **/getuserid** command to **@quickbotifybot** privately. You can also add more than one user ids here separated by comma.

<figure><picture><source srcset="/files/63USdHfsttgWpl0iuBV5" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FW8MNmF5mGWI1KpLc55YR%2Fimage.png?alt=media&amp;token=218dfeaa-3f69-4f48-903f-6f3b26959be2" alt=""></picture><figcaption></figcaption></figure>

<figure><picture><source srcset="/files/6dsMx0fSIAU7ycxiTtUj" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2Fkf6GZOYKWE16Wr0I3i2H%2Fimage.png?alt=media&amp;token=12656dcd-5bc1-47db-a835-fdf1dc4b615e" alt=""></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Once you are done filling all the fields, click on **Submit**. That is it. You have successfully configured your forwarding bot.  You can obviously add more configurations in this bot by following the same approach.
{% endstep %}
{% endstepper %}

### Anonymous Forwarding

If you have used general forwarding, you know that when a message is forwarded it clearly mentions the actual source of the message.

<figure><picture><source srcset="/files/DGAUPSLKqG46aiQCvZFT" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FmHXae24Z3XhyiWqdMz8z%2Fimage.png?alt=media&amp;token=585a0550-925a-488b-a7d6-83a65cd81ca7" alt=""></picture><figcaption></figcaption></figure>

If you want to avoid this, you can turn on the toggle for **Anonymous Forwarding** option here in the settings of your Quickbotify forwarder bot and click on **Save**.

<figure><picture><source srcset="/files/3y0McXviN6PpeInV21EN" media="(prefers-color-scheme: dark)"><img src="https://2311119282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSRnbHEhdUaWAH59jyQKp%2Fuploads%2FFtBfgkQzSk7Xq08PcoBr%2Fimage.png?alt=media&amp;token=3a16699c-b395-4107-88e1-a3434c897409" alt=""></picture><figcaption></figcaption></figure>
