Реферальный бот в Telegram с личными ссылками-приглашениями
Дайте каждому участнику личную ссылку-приглашение, засчитывайте каждого новичка тому, кто его привёл, и пусть участники проверяют свой счёт одной командой.
Соберите этого бота бесплатно. Подключите бота и получите 14 дней Pro, без карты.
Начать бесплатноШаблон Referral Program собирает всё сам: два сценария и таблицу referrals. Вы импортируете шаблон, делитесь ботом, а строки заполняются по мере того, как люди присоединяются.
Панель управления на английском, но ваш бот может общаться с пользователями на любом языке.
Что делает реферальный бот
Реферальный бот выдаёт каждому человеку ссылку, которая принадлежит только ему. Когда друг открывает бота по этой ссылке, бот запоминает, кто его пригласил. Потом любой участник может спросить у бота, сколько людей пришло по его ссылке, а вы видите всю картину в одной таблице.
На этом строятся розыгрыши с бонусами за друзей, сообщество, которое растёт за счёт рекомендаций, магазин, который благодарит покупателей за приведённых друзей, или партнёрская программа, где вознаграждения вы рассчитываете сами.
Настройка за пять минут Pro
- Подключите бота. Вставьте в панель управления токен, который выдаёт @BotFather.
- Импортируйте шаблон. Откройте Templates, найдите Referral Program и нажмите Import. Вы получите два сценария, Referral: invite links и Referral: my link, и коллекцию referrals.
- Получите свою ссылку. Отправьте боту
/myref. Он ответит вашей личной ссылкой-приглашением и текущим счётом. Делитесь этой ссылкой и попросите участников отправить/myref, чтобы получить свои.
Если у вашего бота уже есть сценарий на /myref, импорт выберет следующую свободную команду, например /myref2, и сообщит, какую именно.
Как работает ссылка-приглашение
Каждый участник получает код из 8 букв и цифр: он выбирается случайно и сверяется с уже сохранёнными кодами. Буквы и цифры, которые легко перепутать (0, O, 1, I и L), не используются. Ссылка участника выглядит так:
t.me/yourbot?start=K7M2QX9P
Это диплинк Telegram. Когда человек открывает её и нажимает Start, Telegram отправляет вашему боту /start K7M2QX9P вместо обычного /start. Часть после пробела и есть код: шаблон ищет его в коллекции referrals и узнаёт, кто поделился ссылкой.
Код создаётся один раз и сохраняется. Дальше он всегда читается из строки участника, поэтому его ссылка никогда не меняется. Счёт тоже не хранится отдельным числом: /myref считает строки, в которых referred_by содержит код этого участника.
Два сценария
Referral: invite links
Этот сценарий отвечает только на /start с кодом. Обычный /start по-прежнему ведёт в привычный приветственный сценарий вашего бота.
Для новичка в referred_by записывается код из ссылки, если этот код принадлежит участнику, и поле остаётся пустым, если нет.
Referral: my link
Этот сценарий отвечает на /myref. Того, кого ещё нет в коллекции, бот сразу добавляет с пустым referred_by, чтобы он мог начать делиться ссылкой.
Сообщения шаблона написаны на английском. Замените текст в редакторе на русский: бот отвечает ровно тем текстом, который вы напишете.
Что вы видите на вкладке Data
Откройте Data в панели управления и выберите коллекцию referrals. Это общая коллекция, поэтому строки всех участников лежат в одной таблице.
| Колонка | Что хранит |
|---|---|
user_id | Telegram user id участника |
username | Его @username в Telegram, пусто, если его нет |
name | Его имя в Telegram |
code | Его личный код из 8 символов |
referred_by | Код участника, который его пригласил, или пусто |
joined | Дата добавления в формате YYYY-MM-DD по UTC |
Чтобы увидеть, кто кого привёл, сопоставьте referred_by одной строки с code другой.
Функция Pro: шаблон сохраняет и читает строки блоками хранения данных, а они входят в Pro. Pro стоит $4,99 в месяц, а бесплатный 14-дневный пробный период начинается, когда вы подключаете бота (без карты). Если план вернётся к Free, оба реферальных сценария перестанут отвечать.
Как это можно использовать
Розыгрыши
Давайте дополнительные шансы тем, кто приводит друзей, по счёту из /myref и вкладки Data.
Сообщества
Пусть участники растят группу или канал, делясь своей ссылкой, а вы видите, кто приглашает.
Магазины
Благодарите покупателей, которые приводят друзей. Колонка referred_by показывает, кого именно благодарить.
Партнёрские программы
Отслеживайте, какой партнёр привёл каждого нового участника, и рассчитывайтесь на своих условиях.
Вопросы
Что будет, если участник откроет чужую ссылку-приглашение?
Он получит приветствие «с возвращением» со своей ссылкой, и ничего не сохранится. Тот, кто поделился ссылкой, не получает зачёт, потому что этот участник уже был в боте.
Может ли участник пригласить сам себя?
Нет. Код новичка создаётся после проверки ссылки, поэтому он никогда не совпадёт с его собственным кодом, а участник, у которого уже есть строка, повторно не регистрируется.
Что если открыть ссылку с несуществующим кодом?
Человек всё равно присоединится и получит свой код и ссылку. Колонка referred_by просто останется пустой.
Записывает ли обычный /start людей в коллекцию referrals?
Нет. Обычный /start по-прежнему ведёт в обычный сценарий /start вашего бота. Людей добавляют, когда они открывают ссылку-приглашение или отправляют /myref.
До какого числа считает /myref?
Счёт учитывает до 100 приглашённых на одного участника. Сама коллекция referrals вмещает до 50 000 строк, и все они видны на вкладке Data.
Запустите свою реферальную программу
Подключите бота, импортируйте Referral Program и отправьте /myref, чтобы получить ссылку, которой будете делиться.
Соберите этого бота бесплатно. Подключите бота и получите 14 дней Pro, без карты.
Начать бесплатно