Перейти к основному содержанию

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 символов, буквы, цифры, дефисы).
  • Тестируйте свои ссылки на втором аккаунте или с доверенным контактом, прежде чем массово делиться.

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

Узнайте, как зарабатывать Маврики в мини-игре и заходить в призовые Розыгрыши по Билетикам.

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

Полный справочник всех команд бота, доступных участникам.