> ## Documentation Index
> Fetch the complete documentation index at: https://mavrodi.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Реферальные ссылки: приглашайте новых участников в InviteBot

> Создавайте и делитесь пригласительными ссылками, чтобы приводить людей в InviteBot, автоматически назначайте Наставника, задавайте стартовую стадию и отслеживайте статистику.

Реферальная ссылка — это специальный диплинк Telegram, который регистрирует нового участника по вашему инвайт-коду. Когда человек переходит по ссылке, бот автоматически назначает ему Наставника, при необходимости ставит на конкретную стадию онбординга и фиксирует регистрацию по вашему инвайту — так вы видите, кого привели, и получаете реферальные бонусы, когда они начинают участвовать.

## Получение инвайт-кода

Прежде чем делиться ссылкой, нужен инвайт-код. Используйте в боте две команды:

* `/invite` — просмотр и управление существующими инвайт-кодами или добавление новых.
* `/invites` — готовые реферальные ссылки в форматированном виде, удобные для копирования.

<Note>
  Инвайт-коды должны быть уникальны в пределах платформы: 6–20 символов, только буквы, цифры и дефисы. Зарегистрироваться по собственной инвайт-ссылке нельзя.
</Note>

## Формат ссылки

Каждая реферальная ссылка имеет такую структуру:

```text theme={null}
https://t.me/YOUR_BOT_NAME?start=PARAMETERS
```

Часть `PARAMETERS` состоит максимум из трёх частей, разделённых определёнными разделителями:

```text theme={null}
g-INVITE_CODE--GUIDER_ID---STAGE
```

| Часть         | Разделитель                 | Описание                                                                               |
| ------------- | --------------------------- | -------------------------------------------------------------------------------------- |
| Префикс `g-`  | —                           | Необязательный. Активирует **игровой режим** (Тапалка), минуя стандартную регистрацию. |
| `INVITE_CODE` | —                           | Ваш уникальный инвайт-код.                                                             |
| `GUIDER_ID`   | `--` (двойной дефис перед)  | Необязательный. Принудительно задаёт Наставника по его Telegram ID.                    |
| `STAGE`       | `---` (тройной дефис перед) | Необязательный. Задаёт стартовую стадию онбординга.                                    |

## Примеры ссылок

<Tabs>
  <Tab title="Простой инвайт">
    Самая распространённая ссылка. Регистрирует пользователя по вашему инвайт-коду, а система Ротации назначает Наставника автоматически.

    ```text theme={null}
    https://t.me/YOUR_BOT_NAME?start=my_invite_code
    ```

    Новый участник прикрепляется к вашему инвайту и получает Наставника через Ротацию.
  </Tab>

  <Tab title="Принудительный Наставник">
    Укажите Наставника по его Telegram ID, чтобы обойти Ротацию.

    ```text theme={null}
    https://t.me/YOUR_BOT_NAME?start=my_invite_code--123456789
    ```

    Участник напрямую назначается Наставнику с ID `123456789`.
  </Tab>

  <Tab title="Своя стадия">
    Начать нового участника на конкретной стадии онбординга вместо стандартной.

    ```text theme={null}
    https://t.me/YOUR_BOT_NAME?start=my_invite_code---welcome
    ```

    Участник входит в систему на стадии `welcome`.
  </Tab>

  <Tab title="Игровой режим">
    Сочетание инвайт-кода, Наставника и стадии с префиксом `g-` отправляет пользователя сразу в мини-игру Тапалка.

    ```text theme={null}
    https://t.me/YOUR_BOT_NAME?start=g-my_invite_code--123456789---game_start
    ```

    Участник пропускает стандартную регистрацию и сразу попадает в игровой режим, назначенный указанному Наставнику.
  </Tab>

  <Tab title="Только Наставник">
    Привязать Наставника без привязки к инвайту. Оставьте часть с инвайтом пустой и сразу начинайте с `--`.

    ```text theme={null}
    https://t.me/YOUR_BOT_NAME?start=--123456789
    ```

    Участник получает указанного Наставника, но не учитывается ни в одном инвайт-коде.
  </Tab>
</Tabs>

## Игровой режим (префикс `g-`)

Добавление `g-` перед инвайт-кодом активирует **игровой режим**. Новый пользователь пропускает стандартный поток регистрации и сразу попадает в Тапалку. Он может зарабатывать Маврики (Тапы) и Билетики с момента прихода, а позже снова открывать игру командой `/game`.

Ссылки с игровым режимом полезны, когда вы хотите привлечь людей через игровой опыт, прежде чем они погрузятся в полный цикл взаимопомощи.

## Как назначается Наставник

Если в ссылке не указан Guider ID, система определяет Наставника автоматически в таком порядке:

<Steps>
  <Step title="Поиск по инвайту">
    Система проверяет, связан ли ваш инвайт-код с конкретным Наставником.
  </Step>

  <Step title="Общая Ротация">
    Если по инвайту Наставник не найден, система выбирает его из общей очереди Ротации, равномерно распределяя новичков.
  </Step>
</Steps>

Указание `--GUIDER_ID` в ссылке пропускает оба шага и назначает Наставника напрямую.

## Как определяется стартовая стадия

Когда стартовую стадию могут задавать несколько источников, система применяет приоритет (выигрывает верхний):

1. Стадия из ссылки (`---STAGE`)
2. Стадия из записи Ротации для инвайта
3. Стадия из профиля приглашающего
4. Стадия из профиля Наставника
5. Системная стадия по умолчанию (`start`)

<Tip>
  Если хотите, чтобы все, кто приходит по ссылке, стартовали с одной и той же стадии, явно укажите её в ссылке через суффикс `---STAGE`.
</Tip>

## Отслеживание статистики

После публикации ссылки отслеживайте её эффективность командой:

```text theme={null}
/stats_YOUR_INVITE_CODE
```

Команда показывает:

* **Количество кликов** — сколько человек открыло ссылку.
* **Количество регистраций** — сколько из них завершили регистрацию.

Замените `YOUR_INVITE_CODE` на свой код, например `/stats_my_invite_code`.

## Правила и ограничения

* Вы **не можете** пригласить себя — собственный инвайт-код нельзя использовать для своей же регистрации.
* Вы **не можете** быть собственным рефером.
* Инвайт-коды должны быть **уникальны** в пределах всей платформы (6–20 символов, буквы, цифры, дефисы).
* **Тестируйте свои ссылки** на втором аккаунте или с доверенным контактом, прежде чем массово делиться.

<CardGroup cols={2}>
  <Card title="Тапалка и Билетики" icon="gamepad-2" href="/invites/game-and-tickets">
    Узнайте, как зарабатывать Маврики в мини-игре и заходить в призовые Розыгрыши по Билетикам.
  </Card>

  <Card title="Команды участника" icon="terminal" href="/participants/commands">
    Полный справочник всех команд бота, доступных участникам.
  </Card>
</CardGroup>