Template description
The “[Circle in Telegram] Points for referrals” template is designed to automatically give points to a referrer for each invited friend and issue a reward once a specific number of referrals is reached.
It works together with the “[Circle in Telegram] Subscribe to channels” template and is triggered automatically when a referral completes the action “Launch automation for referrer.”
The template is already fully set up. You only need to:
Edit the message texts.
Add your own prize.
Change the number of points per referral if needed.
How to add the template
If you’ve already started setting up your referral system, this template should already be added. If not, follow these steps:
Open the Automations section.
Go to Ready-made templates.
Select [Circle in Telegram] Points for Referrals.
Choose the Telegram bot where your referral system is being configured.
Click Add Template.
How the template works
Note: This automation has no trigger, as it launches automatically after the conditions in the “[Circle in Telegram] Subscribe to channels” template are met.
Awarding points for referrals
Start Block: This block counts the number of invited referrals and assigns points for each one. It includes two actions:
Set variable: increases the variable {{ referral_circle }} by 1 — this variable tracks the number of invited friends.
Gamification points: gives the referrer points for each new friend invited. You can change the number of points in this action’s settings.
Sending a message
Immediately after awarding points, the referrer receives a message like this:
+1 to your total pot 🔥
Total number of friends invited: {{ referral_circle }}
This lets the referrer track their progress in the game.
Checking referral count
The next step checks whether the referrer has invited enough friends to earn a reward.
By default, the template issues a reward after 5 referrals, but you can change this value by editing the condition that checks the variable {{ referral_circle }}.
The Variable value condition
{{ referral_circle }}compares the variable’s value using the parameter “greater than or equal to 5.”If the value is 5 or more, the condition is met and a prize is issued.
If the value is less than 5, no message is sent.
Checking if the reward has already been issued
If the client has enough referrals, the system checks whether they’ve already received a reward for this milestone:
The condition Assigned tags looks for the tag "Received prize / circle", which is assigned when a prize is issued.
If the tag exists → no new reward is sent (the user already received it).
If the tag doesn’t exist → the referrer receives a congratulatory message and their prize (e.g., link, promo code, document).
Issuing the prize
At this stage, the client receives their well-earned reward.
Send a congratulatory message and include the prize — for example, a link, document, or video.
Logging the reward
After issuing the prize, the Add tag action assigns the tag "Received prize / circle" to the user.
This ensures the same user doesn’t receive the prize multiple times and allows you to track everyone who has received it.
That's it! the automation is fully configured at this stage.
Optional improvements
You can enhance the template by offering multiple rewards for different numbers of referrals — for example, rewards for 5, 7, and 10 friends. The more friends, the better the prize!
To do this:
Add several “Variable value” conditions to check different values of
{{ referral_circle }}.Set the condition type to “Is” so that each prize is issued only once.
Add a prize message for each condition.
After issuing each prize, assign a corresponding tag.
Related articles: