# Joiner

The Joiner module makes your accounts join channels, groups, and bots in bulk. It can also react to posts, view posts, and view stories -- all in one pass.

![Joiner settings](/files/gezdoBaxqJFNvvgT8tgy)

## Settings Reference

### Settings

| Setting               | Description                                                                                                           |
| --------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Threads**           | How many accounts to process at the same time. Default: 3. Max: 20.                                                   |
| **Limit per Account** | Maximum number of targets each account will process. Set to **0** for no limit (every account processes all targets). |

### Actions

Toggle which actions each account should perform on the targets:

| Setting                           | Description                                                        |
| --------------------------------- | ------------------------------------------------------------------ |
| **Join Channels / Groups / Bots** | Subscribe to the target channel, join the group, or start the bot. |
| **React to Posts**                | Add a reaction to the latest post in the target.                   |
| **View Posts**                    | Mark recent posts as read.                                         |
| **View Stories**                  | View the target's stories.                                         |

{% hint style="info" %}
You can combine multiple actions. For example, enable both **Join** and **React** to join a channel and immediately react to its latest post.
{% endhint %}

### Reaction

| Setting            | Description                                                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Reaction Emoji** | Which emoji to use when reacting. Only visible when "React to Posts" is enabled. Choose from a list of supported reactions. |

### Targets

Enter the channels, groups, or bots you want to interact with, one per line:

```
@channelname
t.me/channelname
t.me/+invite_hash
t.me/channel/123
```

### Delays

| Setting             | Description                                 |
| ------------------- | ------------------------------------------- |
| **Delay Min (sec)** | Minimum pause between actions. Default: 5.  |
| **Delay Max (sec)** | Maximum pause between actions. Default: 15. |

## How to Use

1. Go to **Joiner** in the sidebar
2. Set the number of **Threads**
3. Toggle on the **Actions** you want (Join, React, View, etc.)
4. Paste your **Targets** (one per line)
5. Configure **Delays**
6. Select a **Proxy list**
7. In the **Accounts** section, select which accounts should perform the actions
8. Click **Start**

## Understanding the Results

The log shows what each account did:

| Result                                 | What It Means                                                              |
| -------------------------------------- | -------------------------------------------------------------------------- |
| **OK (joined:5, reacted:5, viewed:5)** | Account successfully performed all requested actions. Numbers show counts. |
| **already:3**                          | Account was already a member of some targets.                              |
| **FROZEN**                             | Account is restricted by Telegram.                                         |
| **BANNED / AUTH\_KEY\_DEAD**           | Account is dead.                                                           |

The summary shows totals across all accounts: joined, already member, reacted, viewed, stories viewed, and failed.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/modules/joiner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.