The "[Game in Telegram] Points for Referral" automation is designed to award points to a referrer (the person who brought a new participant to the game). It is a very simple automation and consists of several blocks that allow to fast and efficiently register the attracted user, award points for them, and provide information about the player's progress within the gamification system.
This is the final template in the referral system:
Please note: This template works in combination with two other templates in the referral system for the game. Before setting it up, you must add all three templates to your connected Instagram or Telegram bot account.
After that, you can begin editing them according to your needs.
Key points:
This automation should not have a trigger.
This automation functions as a notification for the referrer, which is sent when a new participant (referral) completes all required steps in the "[Game in Telegram] Referral" automation.
Once the referral has completed all stages, the referrer receives points for inviting them. These points are immediately recorded in the tournament table.
Important notice for Instagram users: Instagram has a 24-hour messaging window rule. This means that if a client has not interacted with your Direct Messages for more than 24 hours, the bot will not be able to send them automated messages.
When using this template in Instagram, keep in mind that the message to the client may not be sent due to this communication time window. However, all actions before the message will still be executed, meaning referrals will still be counted.
How to add the template
This template should be pre-added if you have already started setting up the referral system. However, if you missed this step, add it now:
Open the Automation section.
Go to Ready-made Templates.
Select the "[Game in Telegram] Points for Referral" template.
Choose the account for which you are setting up the referral system.
Click the "Add Template” button.
After that, make sure you have already added the following templates: [Game in Telegram] Game (or another automation where the "Referral Link" action is configured) and [Game in Telegram] Referral. Only after adding all three templates can you proceed with setting up the referral system
Referral counting and point awarding
The starting block includes two actions:
Gamification points
The next step involves using the 'Gamification Points' action with the parameter "Award points to the client", as in this case, the referrer is the client of this automation and goes through it themselves.
It is important that you have planned your gamification points system in advance to ensure the referrer receives the correct number of points. For example, by default, each referral earns 50 points, but the number of points can be adjusted based on the rules of your game.
This block counts the number of referrals brought in by the client.
To do this, it uses the variable {{ referral_cp }}, which we reset when generating the referral link in the [Ref. Links] Link automation.
In this block, we set the parameter: increase the variable value by 1 to count each new referral.
Important! This specific variable must be selected when setting up the tournament table to ensure that the correct and up-to-date number of referrals is displayed to all participants:
More details on Gamification setup in Telegram.
Informative message for the referrer
After earning points, the referrer receives an informative message notifying them that they have invited a friend and earned points. Example:
"Great! You’ve invited a new friend! You've earned 50 points for this. Keep inviting more participants and earn even more!"
Additionally, you can set a daily referral limit.
If you do not plan to use a daily limit, you can remove the following line from the message:
"Friends invited today: {{ referral_cp_control }} / 5"
This text is relevant only if there is a daily limit.
This message also contains two buttons:
"Tournament Table - Leaderboard": Leads to a page displaying the tournament table, where the referrer can track their ranking.
Important! Do not forget to replace the default link in the button with your own link.
"Get link": the second button allows the referrer to retrieve their unique referral link, which was generated earlier, so they can continue inviting new participants.
This automation helps quickly and effectively motivate referrers to invite new users while allowing them to track their progress in the game.