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

# Liens de parrainage : inviter de nouveaux participants dans InviteBot

> Créez et partagez des liens d'invitation pour faire entrer de nouvelles personnes dans InviteBot, attribuer automatiquement un Mentor, définir une étape de départ et suivre vos statistiques de parrainage.

Un lien de parrainage est un deeplink Telegram spécial qui enregistre un nouveau participant via votre code d'invitation. Lorsqu'une personne clique sur votre lien, le bot lui attribue automatiquement un Mentor, la place éventuellement à une étape d'onboarding précise et enregistre l'inscription sur votre invite — pour que vous puissiez suivre qui vous avez amené et toucher des bonus de parrainage lorsqu'il commence à participer.

## Obtenir votre code d'invitation

Avant de pouvoir partager un lien, vous avez besoin d'un code d'invitation. Utilisez ces deux commandes dans le bot :

* `/invite` — consultez et gérez vos codes d'invitation, ou ajoutez-en de nouveaux.
* `/invites` — affichez vos liens de parrainage prêts à l'emploi, formatés et prêts à copier.

<Note>
  Les codes d'invitation doivent être uniques sur l'ensemble de la plateforme : 6 à 20 caractères, lettres, chiffres et tirets uniquement. Vous ne pouvez pas utiliser votre propre lien d'invitation pour vous inscrire vous-même.
</Note>

## Format des liens

Chaque lien de parrainage suit cette structure :

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

La partie `PARAMETERS` est construite avec jusqu'à trois éléments, séparés par des séparateurs spécifiques :

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

| Partie        | Séparateur                 | Description                                                                      |
| ------------- | -------------------------- | -------------------------------------------------------------------------------- |
| Préfixe `g-`  | —                          | Facultatif. Active le **mode jeu** (Tapalka), en sautant l'inscription standard. |
| `INVITE_CODE` | —                          | Votre code d'invitation unique.                                                  |
| `GUIDER_ID`   | `--` (double tiret avant)  | Facultatif. Impose un Mentor précis via son ID Telegram.                         |
| `STAGE`       | `---` (triple tiret avant) | Facultatif. Définit l'étape d'onboarding de départ.                              |

## Exemples de liens

<Tabs>
  <Tab title="Invitation simple">
    Le lien le plus courant. Inscrit le nouvel utilisateur sous votre code d'invitation et laisse le système de Rotation lui attribuer un Mentor automatiquement.

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

    Le nouveau participant est rattaché à votre invite et reçoit un Mentor via la Rotation.
  </Tab>

  <Tab title="Mentor imposé">
    Indiquez un Mentor par son ID Telegram pour court-circuiter la Rotation.

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

    Le participant est attribué directement au Mentor d'ID `123456789`.
  </Tab>

  <Tab title="Étape personnalisée">
    Faites démarrer le nouveau participant à une étape d'onboarding précise au lieu de celle par défaut.

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

    Le participant entre dans le système à l'étape `welcome`.
  </Tab>

  <Tab title="Mode jeu">
    Combinez code d'invitation, Mentor et étape avec le préfixe `g-` pour envoyer le nouvel utilisateur directement dans le mini-jeu Tapalka.

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

    Le participant saute l'inscription standard et arrive directement en mode jeu, rattaché au Mentor indiqué.
  </Tab>

  <Tab title="Mentor seul">
    Rattachez un Mentor sans lier à un code d'invitation. Laissez la partie invite vide et démarrez directement par `--`.

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

    Le participant reçoit le Mentor indiqué mais n'est rattaché à aucun code d'invitation.
  </Tab>
</Tabs>

## Mode jeu (préfixe `g-`)

Ajouter le préfixe `g-` avant votre code d'invitation active le **mode jeu**. Le nouvel utilisateur saute le flux d'inscription standard et arrive directement dans le mini-jeu Tapalka. Il peut gagner des Mavriks (Taps) et des Tickets dès son arrivée, et accéder au jeu plus tard via `/game` dans le bot.

Utilisez les liens en mode jeu lorsque vous souhaitez d'abord attirer des participants par l'expérience du jeu, avant qu'ils ne s'engagent dans le flux complet d'entraide.

## Comment fonctionne l'attribution du Mentor

Si vous n'indiquez pas d'ID de Mentor dans le lien, le système en détermine un automatiquement dans cet ordre :

<Steps>
  <Step title="Recherche basée sur l'invite">
    Le système vérifie si votre code d'invitation est associé à un Mentor spécifique.
  </Step>

  <Step title="Rotation générale">
    Si aucun Mentor n'est trouvé via l'invite, le système en choisit un dans la file de Rotation générale, répartissant les nouveaux venus de façon équilibrée.
  </Step>
</Steps>

Préciser `--GUIDER_ID` dans le lien court-circuite les deux étapes et attribue directement ce Mentor.

## Comment l'étape de départ est déterminée

Quand plusieurs sources peuvent fixer une étape de départ, le système suit cet ordre de priorité (la plus haute l'emporte) :

1. Étape issue du lien (`---STAGE`)
2. Étape définie dans l'entrée de Rotation de l'invite
3. Étape issue du profil du parrain
4. Étape issue du profil du Mentor
5. Étape système par défaut (`start`)

<Tip>
  Si vous voulez que toute personne arrivant via votre lien démarre à la même étape, indiquez-la explicitement dans le lien avec le suffixe `---STAGE`.
</Tip>

## Suivre vos statistiques de parrainage

Après avoir partagé un lien, suivez ses performances avec :

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

Cette commande vous indique :

* **Nombre de clics** — combien de personnes ont ouvert le lien.
* **Nombre d'inscriptions** — combien d'entre elles ont finalisé leur inscription.

Remplacez `YOUR_INVITE_CODE` par votre code réel, par exemple `/stats_my_invite_code`.

## Règles et limites

* Vous **ne pouvez pas** vous inviter vous-même — votre propre code d'invitation ne peut servir à votre propre inscription.
* Vous **ne pouvez pas** être votre propre parrain.
* Les codes d'invitation doivent être **uniques** sur toute la plateforme (6 à 20 caractères, lettres, chiffres, tirets).
* **Testez vos liens** avec un compte secondaire ou un contact de confiance avant de les diffuser largement.

<CardGroup cols={2}>
  <Card title="Tapalka et Tickets" icon="gamepad-2" href="/invites/game-and-tickets">
    Apprenez à gagner des Mavriks dans le mini-jeu et à participer aux Tirages avec des Tickets.
  </Card>

  <Card title="Commandes des participants" icon="terminal" href="/participants/commands">
    Référence complète de toutes les commandes du bot disponibles aux participants.
  </Card>
</CardGroup>