# Inviter

Модуль Inviter добавляет пользователей в ваши каналы и группы Telegram. Он поддерживает четыре разных метода в зависимости от ваших потребностей — от простых прямых приглашений до приглашений через администратора с автоматическим управлением правами.

![Настройки Inviter (верх)](/files/1f78e31d772ae31b27ded574876ef7af356ec413)

![Настройки Inviter (низ)](/files/af8b685d1f6966c3f89ce0bad19cec0462071bc5)

## Методы приглашения

| Метод                        | Описание                                                                                                                                                                           |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Прямое приглашение**       | Каждый аккаунт напрямую приглашает пользователей в целевой канал/группу. Просто и понятно.                                                                                         |
| **Через контакты**           | Сначала аккаунты добавляют пользователей в контакты, затем приглашают их. В некоторых случаях может давать более высокий процент успеха.                                           |
| **Администратор (владелец)** | Аккаунт владельца предоставляет временные права администратора другим аккаунтам, после чего они приглашают пользователей. Права администратора отзываются после завершения задачи. |
| **Администратор (мульти)**   | Как Admin (Owner), но использует отдельный список аккаунтов администраторов вместо выбранных аккаунтов.                                                                            |

## Справочник настроек

### Метод

| Параметр              | Описание                                                                                           |
| --------------------- | -------------------------------------------------------------------------------------------------- |
| **Метод приглашения** | Выберите из: Прямое приглашение, Через контакты, Администратор (владелец), Администратор (мульти). |
| **Потоки**            | Сколько аккаунтов использовать одновременно. По умолчанию: 1.                                      |

### Аудитория

| Параметр                               | Описание                                                                                                                                                   |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Источник**                           | Откуда брать пользователей для приглашения: **Из парсера (XLSX)** или **Ручной ввод**.                                                                     |
| **Приглашений на аккаунт**             | Сколько пользователей приглашает каждый аккаунт перед переключением на следующий. Отображается только для методов Прямое/Через контакты. По умолчанию: 50. |
| **Удалять контакты после приглашения** | Удалять пользователей из контактов после приглашения. Отображается только для метода Через контакты.                                                       |

### Результаты парсера / Получатели

| Параметр       | Описание                                                                                                                                        |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Файл XLSX**  | Путь к выходному файлу парсера аудитории. Отображается, когда Источник — "Из парсера".                                                          |
| **Получатели** | Список получателей, вводимый вручную, по одному в строке: @username, номер телефона или user\_id. Отображается, когда Источник — "Ручной ввод". |

### Целевые ресурсы (методы Прямое / Через контакты)

| Параметр | Описание                                                                                                 |
| -------- | -------------------------------------------------------------------------------------------------------- |
| **Цели** | Каналы или группы, в которые приглашать пользователей. По одному в строке: @channel, t.me/+invite\_hash. |

### Настройки администратора (методы администратора)

| Параметр                          | Описание                                                                                                                                                |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Целевой ресурс**                | Один канал/группа, в который приглашать пользователей. @channel или t.me/+hash.                                                                         |
| **Телефон аккаунта владельца**    | Номер телефона аккаунта, который владеет целевым ресурсом (или имеет права администратора на нём). Должен существовать в базе данных.                   |
| **Приглашений на администратора** | Сколько пользователей приглашает каждый аккаунт-администратор. По умолчанию: 50.                                                                        |
| **Глобальный лимит приглашений**  | Максимальное общее число приглашений для всех администраторов. Установите 0, чтобы не было лимита.                                                      |
| **Телефоны администраторов**      | Список аккаунтов, которые будут использоваться как временные администраторы. По одному телефону в строке. Отображается только для метода Admin (Multi). |

### Ограничения

| Параметр                          | Описание                                                                                                                   |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Размер пакета**                 | Сколько пользователей приглашать за один вызов API. По умолчанию: 1. Большие пакеты быстрее, но могут вызвать ограничения. |
| **Задержка между пакетами (сек)** | Пауза между пакетами. По умолчанию: 1 секунда.                                                                             |

### Задержки

| Параметр                        | Описание                                                                               |
| ------------------------------- | -------------------------------------------------------------------------------------- |
| **Мин. / макс. задержка (сек)** | Случайная задержка между отдельными операциями приглашения. По умолчанию: 5–15 секунд. |

## Как использовать (метод Direct)

1. Перейдите в **Inviter** в боковой панели
2. Выберите **Прямое приглашение** как метод
3. Выберите источник аудитории (XLSX или ручной ввод)
4. Введите **целевой** канал(ы) или группу(ы)
5. Установите **Приглашений на аккаунт** и **Задержки**
6. Выберите **список прокси**
7. Выберите аккаунты в **Аккаунты** разделе
8. Нажмите **Старт**

## Как использовать (метод администратора)

1. Выберите **Администратор (владелец)** или **Администратор (мульти)** как метод
2. Введите **Целевой ресурс** (@channel)
3. Введите **Телефон аккаунта владельца** (должен быть в вашей базе данных)
4. Для Admin (Multi): введите телефоны аккаунтов администраторов
5. Настройте аудиторию, лимиты и задержки
6. Нажмите **Старт**

Модуль выполнит:

1. Подключится как аккаунт владельца
2. Предоставит временные права администратора приглашающим аккаунтам
3. Пригласит пользователей через аккаунты администраторов
4. Отзовёт права администратора по завершении

## Понимание результатов

| Результат         | Что это значит                                                                     |
| ----------------- | ---------------------------------------------------------------------------------- |
| **приглашено: X** | Успешно приглашено X пользователей                                                 |
| **уже есть: X**   | X пользователей уже были участниками                                               |
| **пропущено: X**  | X пользователей не удалось найти или определить                                    |
| **ошибок: X**     | Не удалось пригласить X пользователей (настройки приватности, ограничения и т. д.) |

{% hint style="warning" %}
Если аккаунт будет ограничен или заблокирован во время приглашения, оставшиеся получатели автоматически будут переназначены на следующий доступный аккаунт.
{% 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/docs-ru/moduli/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.