Перейти до основного вмісту

Documentation Index

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

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

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

Отримання інвайт-коду

Перш ніж ділитися посиланням, потрібен інвайт-код. Скористайтеся в боті двома командами:
  • /invite — перегляд і керування наявними інвайт-кодами або додавання нових.
  • /invites — готові реферальні посилання у відформатованому вигляді, зручні для копіювання.
Інвайт-коди мають бути унікальними в межах платформи: 6–20 символів, лише літери, цифри й дефіси. Зареєструватися за власним інвайт-посиланням не можна.

Формат посилання

Кожне реферальне посилання має таку структуру:
https://t.me/YOUR_BOT_NAME?start=PARAMETERS
Частина PARAMETERS складається максимум із трьох частин, розділених певними роздільниками:
g-INVITE_CODE--GUIDER_ID---STAGE
ЧастинаРоздільникОпис
Префікс g-Необовʼязковий. Активує ігровий режим (Тапалка), оминаючи стандартну реєстрацію.
INVITE_CODEВаш унікальний інвайт-код.
GUIDER_ID-- (подвійний дефіс перед)Необовʼязковий. Примусово задає Наставника за його Telegram ID.
STAGE--- (потрійний дефіс перед)Необовʼязковий. Задає стартову стадію онбордингу.

Приклади посилань

Найпоширеніше посилання. Реєструє користувача за вашим інвайт-кодом, а система Ротації призначає Наставника автоматично.
https://t.me/YOUR_BOT_NAME?start=my_invite_code
Новий учасник прикріплюється до вашого інвайту й отримує Наставника через Ротацію.

Ігровий режим (префікс g-)

Додавання g- перед інвайт-кодом активує ігровий режим. Новий користувач пропускає стандартний потік реєстрації й одразу потрапляє в Тапалку. Він може заробляти Маврики (Тапи) і Білетики з моменту приходу, а пізніше знову відкривати гру командою /game. Посилання з ігровим режимом корисні, коли ви хочете привабити людей через ігровий досвід, перш ніж вони зануряться в повний цикл взаємодопомоги.

Як призначається Наставник

Якщо в посиланні не вказано Guider ID, система визначає Наставника автоматично в такому порядку:
1

Пошук за інвайтом

Система перевіряє, чи повʼязаний ваш інвайт-код з конкретним Наставником.
2

Загальна Ротація

Якщо за інвайтом Наставника не знайдено, система обирає його з загальної черги Ротації, рівномірно розподіляючи новачків.
Указівка --GUIDER_ID у посиланні пропускає обидва кроки й призначає Наставника напряму.

Як визначається стартова стадія

Коли стартову стадію можуть задавати кілька джерел, система застосовує пріоритет (виграє верхній):
  1. Стадія з посилання (---STAGE)
  2. Стадія із запису Ротації для інвайту
  3. Стадія з профілю запрошувача
  4. Стадія з профілю Наставника
  5. Системна стадія за замовчуванням (start)
Якщо хочете, щоб усі, хто приходить за посиланням, стартували з однієї стадії, явно вкажіть її в посиланні через суфікс ---STAGE.

Відстеження статистики

Після публікації посилання відстежуйте його ефективність командою:
/stats_YOUR_INVITE_CODE
Команда показує:
  • Кількість кліків — скільки людей відкрили посилання.
  • Кількість реєстрацій — скільки з них завершили реєстрацію.
Замініть YOUR_INVITE_CODE на свій код, наприклад /stats_my_invite_code.

Правила та обмеження

  • Ви не можете запросити себе — власний інвайт-код не можна використовувати для своєї реєстрації.
  • Ви не можете бути власним рефером.
  • Інвайт-коди мають бути унікальними в межах усієї платформи (6–20 символів, літери, цифри, дефіси).
  • Тестуйте свої посилання на іншому акаунті або з довіреним контактом, перш ніж масово ділитися.

Тапалка та Білетики

Дізнайтеся, як заробляти Маврики в мінігрі й заходити в призові Розіграші за Білетиками.

Команди учасника

Повний довідник усіх команд бота, доступних учасникам.