Referral Program

Perfect if word-of-mouth is one of your best growth channels and you want to actually track it instead of guessing who invited whom. Members get a personal link to share; anyone who joins through it is automatically credited to them, and you get an alert with both names attached. It's simple, transparent growth — you decide what the reward is and hand it out yourself from the alerts you receive.

Flow Preview

Referral MenuReferral Welcome

Overview

Every member gets a personal invite link. When a friend joins through it, the new user is tagged, the inviter is recorded, and you're alerted instantly — rewards are yours to grant by hand.

Who It's For

Perfect if word-of-mouth is one of your best growth channels and you want to actually track it instead of guessing who invited whom. Members get a personal link to share; anyone who joins through it is automatically credited to them, and you get an alert with both names attached. It's simple, transparent growth — you decide what the reward is and hand it out yourself from the alerts you receive.

Setup Requirements

  • What's the reward for a successful referral, and after how many invites?
  • Who should receive the new-referral alerts?
  • What's your bot's username, so invite links work?
  • If you didn't set it during install, open Variables and set botUsername to your bot's username without the @ (for example mycompany_bot) — invite links are built from it.
  • On the Contacts page, tag yourself (and anyone else who should hear about new referrals) with the alert tag you chose during setup.
  • Press Deploy, then test the loop yourself: grab your invite link from the bot, open it from a second account, and confirm the alert arrives naming both accounts.
  • Decide on your reward and grant it manually from each alert — this template tracks who invited whom, but doesn't count or pay out rewards automatically.

Node Breakdown

  • A member opens the bot and sees what they'll get for inviting friends
  • They tap Invite friends and receive their own personal link, built from your bot's username and their ID
  • A friend taps that link and lands in a dedicated welcome — the bot already knows who invited them
  • The new user is tagged as referred and welcomed with the same reward mention
  • You get an instant alert naming the new user and exactly who invited them
  • The new user taps Get started and lands in your main menu like anyone else

Details

Good to know

  • Invite links carry a short, safe payload (just letters, numbers, and a couple of symbols) — well inside what Telegram allows, so links always work.
  • Attribution is per new user plus an alert to you for every signup — there's no running leaderboard or per-referrer counter built in; if you want one, you'll need to track it yourself from the alerts.
  • Rewards are granted manually: each alert gives you the new user's ID and their inviter's ID, so you look up the inviter on the Contacts page and send the reward yourself.
  • The invite links won't work until your bot's username is set — that's the one thing this template can't guess for you.

Keep in mind

  • Don't promise automatic reward tracking, running totals, or a leaderboard — this template tells you who invited whom; you grant rewards by hand.
  • Don't advertise the invite link before botUsername is set — it won't resolve to anything until then.
  • Keep the reward simple and clearly stated so members know exactly what they're inviting friends for.