# Inviter

The Inviter module adds users to your Telegram channels and groups. It supports four different methods depending on your needs -- from simple direct invites to admin-based inviting with automatic permission management.

![Inviter settings (top)](/files/zafpRaWBZgZBH0HghYDl)

![Inviter settings (bottom)](/files/pFnxOm3jBQY4uYf9Kdpz)

## Invite Methods

| Method            | Description                                                                                                                          |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Direct Invite** | Each account directly invites users to the target channel/group. Simple and straightforward.                                         |
| **Via Contacts**  | Accounts first add users as contacts, then invite them. Can have higher success rates in some cases.                                 |
| **Admin (Owner)** | The owner account grants temporary admin rights to other accounts, which then invite users. Admin rights are revoked after the task. |
| **Admin (Multi)** | Like Admin (Owner), but uses a separate list of admin accounts instead of the selected accounts.                                     |

## Settings Reference

### Method

| Setting           | Description                                                             |
| ----------------- | ----------------------------------------------------------------------- |
| **Invite Method** | Choose from: Direct Invite, Via Contacts, Admin (Owner), Admin (Multi). |
| **Threads**       | How many accounts to use at the same time. Default: 1.                  |

### Audience

| Setting                          | Description                                                                                                             |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Source**                       | Where to get users to invite: **From Parser (XLSX)** or **Manual Input**.                                               |
| **Invites per Account**          | How many users each account invites before switching to the next. Only visible for Direct/Contact methods. Default: 50. |
| **Delete Contacts After Invite** | Remove users from contacts after inviting. Only visible for the Via Contacts method.                                    |

### Parser Results / Recipients

| Setting        | Description                                                                                                       |
| -------------- | ----------------------------------------------------------------------------------------------------------------- |
| **XLSX File**  | Path to the Audience Parser output file. Visible when Source is "From Parser".                                    |
| **Recipients** | Manual recipient list, one per line: @username, phone number, or user\_id. Visible when Source is "Manual Input". |

### Target Resources (Direct / Contact methods)

| Setting     | Description                                                                          |
| ----------- | ------------------------------------------------------------------------------------ |
| **Targets** | Channels or groups to invite users into. One per line: @channel, t.me/+invite\_hash. |

### Admin Settings (Admin methods)

| Setting                 | Description                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Target Resource**     | The single channel/group to invite users into. @channel or t.me/+hash.                                          |
| **Owner Account Phone** | Phone number of the account that owns (or has admin rights on) the target resource. Must exist in the database. |
| **Invites per Admin**   | How many users each admin account invites. Default: 50.                                                         |
| **Global Invite Limit** | Maximum total invites across all admins. Set to 0 for no limit.                                                 |
| **Admin Phones**        | List of accounts to use as temporary admins. One phone per line. Only visible for Admin (Multi) method.         |

### Limits

| Setting               | Description                                                                                          |
| --------------------- | ---------------------------------------------------------------------------------------------------- |
| **Batch Size**        | How many users to invite per API call. Default: 1. Larger batches are faster but may trigger limits. |
| **Batch Delay (sec)** | Pause between batches. Default: 1 second.                                                            |

### Delays

| Setting                   | Description                                                               |
| ------------------------- | ------------------------------------------------------------------------- |
| **Delay Min / Max (sec)** | Random delay between individual invite operations. Default: 5-15 seconds. |

## How to Use (Direct Method)

1. Go to **Inviter** in the sidebar
2. Select **Direct Invite** as the method
3. Choose your audience source (XLSX or manual)
4. Enter the **Target** channel(s) or group(s)
5. Set **Invites per Account** and **Delays**
6. Select a **Proxy list**
7. Select accounts in the **Accounts** section
8. Click **Start**

## How to Use (Admin Method)

1. Select **Admin (Owner)** or **Admin (Multi)** as the method
2. Enter the **Target Resource** (@channel)
3. Enter the **Owner Account Phone** (must be in your database)
4. For Admin (Multi): enter the admin account phones
5. Set up audience, limits, and delays
6. Click **Start**

The module will:

1. Connect as the owner account
2. Grant temporary admin rights to the inviting accounts
3. Invite users through the admin accounts
4. Revoke admin rights when done

## Understanding the Results

| Result         | What It Means                                           |
| -------------- | ------------------------------------------------------- |
| **invited: X** | Successfully invited X users                            |
| **already: X** | X users were already members                            |
| **skipped: X** | X users could not be found or resolved                  |
| **failed: X**  | X invites failed (privacy settings, restrictions, etc.) |

{% hint style="warning" %}
If an account gets restricted or banned during inviting, its remaining recipients are automatically re-queued to the next available account.
{% endhint %}


---

# 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/inviter.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.