Реферальная программа

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

Превью сценария

Реферальное менюПриветствие приглашённых

Обзор

Личные ссылки-приглашения: бот отмечает, кто кого привёл, и уведомляет владельца о каждом новом реферале. Награды вы выдаёте сами.

Для кого

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

Что нужно для запуска

  • Какая награда за приглашения и за сколько друзей?
  • Кто должен получать уведомления о новых рефералах?
  • Какое имя у вашего бота — оно нужно для ссылок-приглашений?
  • Если вы отложили имя бота при настройке — впишите его в переменную botUsername без @ (например, mycompany_bot). Пока оно не задано, ссылки-приглашения не работают.
  • Отметьте всех, кто должен получать уведомления о рефералах, выбранным тегом на странице «Контакты».
  • Награды выдаются вручную: в каждом уведомлении есть ID нового пользователя и ID пригласившего — найдите пригласившего на странице «Контакты» и выдайте награду.

Разбор узлов

  • Участник запускает бота и видит условия награды
  • Нажимает «Пригласить друзей» и получает личную ссылку-приглашение
  • Друг открывает ссылку — бот понимает, что это приглашение
  • Новый пользователь получает тег «referred», а пригласивший записывается в его карточку
  • Владелец сразу получает уведомление: кто пришёл и кто пригласил
  • Приглашённый видит приветствие с наградой и попадает в главное меню

Подробности

Полезно знать

  • Ссылка приглашения собирается из переменной botUsername — системной переменной с именем бота нет, поэтому имя запрашивается при настройке.
  • Реферальные ссылки открывают сценарий для приглашённых, а обычный /start — меню: специальная метка «ref» в ссылке имеет приоритет. Не убирайте её.
  • Шаблон записывает, кто кого пригласил, и присылает уведомление о каждом реферале. Счётчиков приглашений и рейтингов в нём нет.

Что важно помнить

  • Не обещайте автоматический подсчёт приглашений и рейтинги — шаблон записывает, кто кого привёл, и присылает уведомления, а награды владелец выдаёт сам.
  • Не убирайте метку «ref» из настройки ссылки — без неё приглашения и обычный /start начнут перехватывать друг друга.