Рефералы
Кто приводит друзей и что за это получает. Здесь же настраивается реферальная программа: бонусные дни или деньги, подарок другу, множитель за Telegram Premium, удержание бонуса и уровни амбассадора.
Раздел Рефералы находится в меню слева, в группе «Финансы». У каждого клиента есть своя ссылка приглашения — в боте и в кабинете, на странице «Друзья». Когда по ней приходит друг, пригласивший появляется в этом разделе.
Что здесь есть
Плитки вверху:
- «Пригласивших» — сколько людей привели хотя бы одного друга; ниже — у скольких друзья платили.
- «Друзей пришло» — всего друзей и сколько в среднем на одного пригласившего.
- «Дней начислено» — все бонусные дни; ниже — сколько за оплаты и сколько за приход.
- «Начислено деньгами» — деньги по денежной программе и партнёрам; ниже — сколько сейчас лежит на балансах или сколько партнёров.
«Лидеры» — пять лучших пригласивших. Вкладки Друзья, Дни и Деньги (последняя появляется, если деньги кому-то начислялись) меняют, по чему считать.
«Условия программы» — текущие правила одним списком: режим, подарок другу, бонусы за подключение и оплату, множитель Premium, удержание, процент и вывод, уровни амбассадора. После сохранения настроек список обновляется сразу.
Список пригласивших
Поиск по полю «Имя, @username или Telegram ID».
| Колонка | Что в ней |
|---|---|
| Пригласивший | Имя, @username. У партнёров — бейдж «Партнёр ₽» |
| Друзей | Сколько пришло по его ссылке |
| Дней начислено | Все бонусные дни |
| За приход | Дни за подключившихся друзей |
| За оплаты | Дни за оплаты друзей |
| Баланс | Деньги на реферальном балансе; ниже — сколько начислено всего |
| Регистрация | Когда сам пригласивший зарегистрировался |
Нажмите на строку — откроется карточка пригласившего:
- «Друзей» и сколько из них оплатили;
- «Начислено днями» — за приход, за оплаты, за уровни;
- «Начислено деньгами» и сколько на балансе;
- «В пути» — бонусы, которые ждут конца удержания;
- уровень амбассадора и сколько оплативших друзей до следующего;
- список «Друзья», новые сверху: что каждый принёс и что ещё «в пути».
Кнопка «Карточка пользователя» открывает полную карточку в разделе Пользователи. Там на вкладке «Рефералы» человека можно сделать партнёром.
Настройки программы
Кнопка «Настройки программы» справа вверху открывает окно «Реферальная программа». Изменения применяются кнопкой «Сохранить» внизу окна.
Изменения действуют со следующих событий
Уже начисленное не пересчитывается. Новые проценты, дни и режим применяются к следующим приходам и оплатам друзей.
Режим программы
- «Бонусные дни» (по умолчанию). Все получают дни подписки за приглашения и оплаты друзей. Партнёрам — процент деньгами.
- «Денежный бонус». Все получают процент от оплат друзей на реферальный баланс с выводом. Бонуса за приход, множителя Premium и уровней в этом режиме нет — это награды днями.
Если у пригласившего есть активная подписка, дни прибавляются к ней сами. Если нет — копятся, и клиент забирает их кнопкой «Забрать» на странице «Друзья».
Поля режима «Бонусные дни»
| Поле | По умолчанию | Что делает |
|---|---|---|
| «Бонус за приглашение» | 3 дня | Начисляется, когда друг активировал пробный период и прокачал через VPN от 3 МБ. Один раз за каждого друга. От 0 до 3650, 0 — не начислять |
| «Бонус за покупку реферала» → За месяц | 14 дней | За каждую оплату другом месячной подписки |
| «Бонус за покупку реферала» → За год | 120 дней | За каждую оплату годовой подписки |
Бонус за покупку не зависит от пакета — Лайт, Плюс или Ультима. Значения от 0 до 3650, 0 — не начислять. Доплата за смену пакета, сброс БС, покупки в магазине Stars/Premium и ручная выдача бонус не дают.
Блок «Деньги»
Действует в денежном режиме и для партнёров в режиме дней.
| Поле | По умолчанию | Что делает |
|---|---|---|
| «Процент от оплаты» | 10 % | Сколько процентов от суммы оплаты друга идёт на реферальный баланс. От 0 до 100 |
| «Мин. сумма вывода» | 500 ₽ | С какой суммы можно подать заявку на вывод. От 0 до 1 000 000 ₽ |
Партнёру можно задать свой процент в его карточке. Пустое поле — действует общий процент. Заявки на вывод — в разделе Выводы.
Блок «Подарок, Premium и защита»
| Поле | По умолчанию | Пределы | Что делает |
|---|---|---|---|
| «Подарок другу» | 4 дня | 0–365 | Друг по ссылке получает пробный период длиннее на столько дней. 0 — без подарка |
| «Друг с Telegram Premium» | ×2 | 1–5 | Во сколько раз больше дней за шаги друга, у которого Telegram Premium. 1 — выключено |
| «Удержание бонуса за оплату» | 7 дней | 0–60 | Сколько дней бонус за оплату друга «в пути». 0 — начислять сразу |
| «Лимит бонусов за приход» | 20 в мес. | 0–1000 | Сколько раз в месяц один человек получает бонус за подключившегося друга. 0 — без лимита |
Подарок другу. Telegram-аккаунт получает подарок сразу. Аккаунт с сайта — только после подтверждения почты или входа через Google или Яндекс. С одного IP регистрации подарок дают не чаще раза в 30 дней — так фермы регистраций не получают дни пачкой. Бот показывает другу, сколько дней пробного периода он получит с подарком.
Множитель Premium умножает только дни: за приход и за оплаты. На денежный процент он не влияет. Признак Premium обновляется при каждом входе клиента в бота или Mini App.
Удержание. Бонус за оплату друга сначала стоит «в пути». Клиент видит это на странице «Друзья», бот сообщает, когда бонус придёт. Через срок удержания бонус начисляется сам: дни — к подписке, деньги — на баланс. Если за это время платёж вернули, бонус отменяется. Это работает для возвратов, отмеченных в Платежах, и для автоматических возвратов YooKassa и чарджбэков Platega. Проверка идёт раз в 10 минут.
Без удержания возврат бонус не отменит
Если поставить удержание 0, бонус за оплату начисляется сразу. При возврате оплаты отозвать уже начисленные дни или деньги будет нельзя.
Уровни амбассадора
Разовая награда днями, когда у человека набралось нужное число оплативших друзей. По умолчанию:
| Название | Друзей | Дней |
|---|---|---|
| Свой | 3 | 30 |
| Амбассадор | 10 | 90 |
| Легенда | 25 | 365 |
Каждая строка — название (от 1 до 24 символов), «друзей» и «дней» (от 0 до 3650). Кнопка «Добавить уровень» добавляет строку, корзина — удаляет. Всего до 6 уровней. Удалите все строки — уровни выключатся.
- Порог друзей у каждого следующего уровня должен быть больше предыдущего. Иначе при сохранении появится ошибка «Уровень N: друзей должно быть больше, чем на предыдущем уровне».
- Оплативший друг — тот, кто хоть раз оплатил подписку деньгами, и с этой оплаты прошёл срок удержания. Доплата за пакет, сброс БС и магазин не считаются.
- Уровни работают только в режиме «Бонусные дни» и не действуют для партнёров.
- Награды проверяются раз в 10 минут по всей базе. Если человек проскочил сразу два уровня, он получит дни за оба, а бот поздравит с высшим.
Смена порогов
Уже выданные уровни остаются у людей. Если поменять пороги, новые пороги дадут награду заново тем, кто их достиг.
Партнёры
Блогерам и каналам можно платить деньгами, даже если у остальных бонусные дни. Откройте человека в Пользователях, вкладка «Рефералы», включите «Партнёр» и при желании впишите свой процент (от 0 до 100; пусто — общий). С этого момента за оплаты его друзей он получает процент на баланс, с тем же удержанием. Бонуса за приход, множителя Premium и уровней у партнёра нет.
Частые ситуации
- Друг пришёл, а бонус за приглашение не начислился. Друг должен включить пробный период и прокачать через VPN от 3 МБ. Проверьте также лимит бонусов за приход в месяц.
- Бонус за оплату не пришёл сразу. Он «в пути» до конца удержания. В карточке пригласившего это видно в блоке «В пути».
- Переключили на «Денежный бонус», а у людей остались дни. Дни остаются. Деньги начисляются со следующих оплат друзей. Остаток денег от прошлого денежного режима клиент может вывести и в режиме дней.