Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mavrodi.org/llms.txt

Use this file to discover all available pages before exploring further.

A referral link is a special Telegram deeplink that registers a new participant through your invite code. When someone clicks your link, the bot automatically assigns them a Guider, optionally places them into a specific onboarding stage, and records the registration against your invite — so you can track who you brought in and earn referral bonuses once they start participating.

​
Getting your invite code

Before you can share a link, you need an invite code. Use these two commands in the bot:
  • /invite — view and manage your existing invite codes, or add new ones.
  • /invites — see your ready-made referral links, formatted and ready to copy.
Invite codes must be unique across the platform: 6–20 characters, using letters, numbers, and dashes only. You cannot use your own invite link to register yourself.
Every referral link follows this structure: 
https://t.me/YOUR_BOT_NAME?start=PARAMETERS
The PARAMETERS portion is built from up to three parts, joined by specific separators: 
g-INVITE_CODE--GUIDER_ID---STAGE
PartSeparatorDescription
g- prefix—Optional. Activates game mode (Tapalka), skipping standard registration.
INVITE_CODE—Your unique invite code.
GUIDER_ID-- (double dash before)Optional. Forces a specific Guider by their Telegram ID.
STAGE--- (triple dash before)Optional. Sets the starting onboarding stage.
The most common link. Registers the new user under your invite code and lets the Rotation system assign them a Guider automatically.
https://t.me/YOUR_BOT_NAME?start=my_invite_code
The new participant is attached to your invite and receives a Guider via Rotation.

​
Game mode (g- prefix)

Adding the g- prefix before your invite code activates game mode. The new user skips the standard registration flow and goes straight to the Tapalka mini-game. They can earn Mavriks (Taps) and Tickets from the moment they arrive, and access the game later via /game in the bot. Use game-mode links when you want to attract participants through the game experience first, before they engage with the full mutual aid workflow.

​
How Guider assignment works

If you don’t specify a Guider ID in the link, the system determines one automatically in this order:
1

Invite-based lookup

The system checks whether your invite code is associated with a specific Guider.
2

General Rotation

If no Guider is found via the invite, the system picks one from the general Rotation queue, distributing newcomers evenly.
Specifying --GUIDER_ID in the link skips both steps and assigns that Guider directly.

​
How starting stage is determined

When multiple sources could set a starting stage, the system follows this priority order (highest wins):
  1. Stage from the link (---STAGE)
  2. Stage set in the invite’s Rotation entry
  3. Stage from the referrer’s profile
  4. Stage from the Guider’s profile
  5. Default system stage (start)
If you want everyone arriving through your link to start at the same stage, include it explicitly in the link using the ---STAGE suffix.

​
Tracking your referral statistics

After you share a link, track its performance with: 
/stats_YOUR_INVITE_CODE
This command shows you:
  • Click count — how many people opened the link.
  • Registration count — how many of those completed registration.
Replace YOUR_INVITE_CODE with your actual code, for example /stats_my_invite_code.

​
Rules and limits

  • You cannot invite yourself — your own invite code cannot be used for your own registration.
  • You cannot be your own referrer.
  • Invite codes must be unique across the entire platform (6–20 characters, letters, numbers, dashes).
  • Test your links with a secondary account or a trusted contact before sharing them widely.

Tapalka & Tickets

Learn how to earn Mavriks in the mini-game and enter prize Rounds with Tickets.

Participant commands

Full reference of all bot commands available to participants.