> ## 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>