Skip to main content
[Game in Telegram] Game

How to run a game in a Telegram channel

David P. avatar
Written by David P.
Updated over 2 weeks ago

The automation "[Telegram Game] Game" is a key step for participants, where they receive tasks, can invite their friends, and earn points. The entire process involves several steps, including subscription check, providing referral links, and awarding points for completed activities.

The template is pre-configured and ready for use. All you need to do is replace the default links in the messages and buttons with your own, adjust the conditions for subscription verification and boost checking, and in the action "Referral Link," select the pre-added template "[Game in Telegram] Referral."

Let's take a closer look at this template below:


How to add the template

  1. Open the Automations section.

  2. Select the "[Game in Telegram] Game" template.

  3. Choose the account for which the referral system is being set up.

  4. Click the "Add template" button.

Next, add all other required game templates in a similar manner. For the referral system, these include: [Telegram Game] Referral and [Telegram Game] Points for Referral.

Important! If this isn't your first time configuring the game, be sure to replace all tags in your automations with the new ones. This step ensures that participants who have played before can experience the scenarios as if playing for the first time, get familiar with the rules, reset their referral counters, and so on.

Only after adding three templates can you proceed to configuring the referral system.


Automation start

  • Condition “Assigned tags”: At the beginning of the automation, the system checks for the presence of the "Started / Telegram Game" tag.

  • If the tag is present, the message "You're already in the game" is sent to inform the user they’re already participating.

  • If the tag doesn't exist, it is assigned using the "Add tags" action, and the main game scenario begins.

Welcome message

  • After the tag is assigned, a welcome message is sent with an invitation to participate in the game.

  • If the client clicks the "Start" button, a subscription check is performed.

Subscription check

  • The subscription check is performed similarly to the automation "[Game in Telegram] Referral."

  • The subscription is checked three times, and if it is not successful after three attempts, the user still continues with the scenario.

Pay attention: If the referral system is set up for a Telegram bot, you must select your Telegram channel in every condition that includes a subscription check. To do this, add the Telegram bot to the list of administrators of your channel.


If necessary, you can create a looped subscription check to ensure that only channel subscribers can participate in the game. In this case, it is important to make the check button reusable for repeated verifications:

Condition with tag check

  • After the subscription check, the system verifies the presence of the "Joined to play / Game in Telegram" tag, which is assigned in the "[Ref. System] Referral" automation.

  • ​If the tag exists, the user moves to the next step, skipping the repeated information about the game rules. This prevents a referral who already learned the rules before entering the automation from having to read them again.

  • If the tag does not exist, a detailed message is sent explaining the game rules and possible rewards.

Task assignment

Once a new player is familiar with the rules, they receive a message with the main tasks. The message outlines the available activities for earning points.

The message includes buttons for each activity:

  • Invite a Friend

  • Give a Boost

  • Reactions

  • Comments

Invite a friend: Referral link distribution

When the "Invite a Friend" button is clicked, the "Assigned tags" condition is checked to see if the "Received link / Game in Telegram" tag is present.

If the tag is not present, the player receives a message explaining the friend invitation rules along with their own unique link.

  • The "Received Link / Game in Telegram" tag is then assigned, and the variable {{ referral_CP }} is set to 0 to track the number of referrals.

  • In the next step, a unique referral link for the player is generated using the "Referral Link" action.

Important! Make sure to select the automation "[Game in Telegram] Referral" template, which must be added to the account in advance.

If this step is skipped, the referral system will not function properly, as users will receive a link to the ChatPlace bot instead.

  • The link is displayed using the variable {{ referral_link_CP }}, and the player receives an explanatory message: "Here is your link, send it to your friends!"

Once the player receives their referral link, the second activity begins: checking whether the player has voted or not. This check is performed using the "Assigned tags" condition.

  • After the link is issued, a 30-minute delay is set, and the looped section of the sequence begins, checking once per day whether the player has voted for the channel.

  • If the "Voted / Game in Telegram" tag is not assigned, the player receives a reminder inviting them to vote (boost) for the channel. After that, a one-day delay follows before the next check, and this cycle continues until the end of the game or until the player votes for the channel.

Activity: Give a boost

  • When the player clicks the "Give a Boost" button, they receive a message with the rules: "Vote for this channel and get 150 points!"

  • The condition "Vote (Boost)" is checked:

Important! Make sure to select your channel in the "Vote (Boost)" condition:

  • If the condition is not met (the player has not yet voted), a reminder is sent with a "Get points for boost" button.

  • If the condition is met, the system checks for the "Voted / Game in Telegram" tag.

  • If the tag is already set, a message with information about the earned points is displayed.

  • If there is no tag, one is added, and the player receives a message indicating the earned points (150 points). At the end, 150 points are awarded using the "Gamification Points" action.

Activity: Reactions

  • When the player clicks the "Reactions" button, a message is sent explaining how they can earn points for reacting to posts in the Telegram channel. The number of points awarded for reactions depends on the gamification settings.

Activity: Comments

  • When the player clicks the "Comments" button, they receive a message explaining the rules for comments:

    • The character limit required for comments.

    • The number of points that can be earned from comments.

    • The conditions under which comments will be considered.

Automation completion

In the final step, after task distribution, a message is sent informing the player how to check their game statistics. To do this, the player must send a trigger from a separate, dedicated automation:

Start trigger setup

After configuring all the game automations, a trigger can be set up. The trigger is configured in the upper right corner of the automation builder:

This automation is usually the main one, so the trigger can be /start or game.

More details at about automation triggers.


This automation effectively encourages players to complete different tasks and earn points while also attracting new participants through the referral system.

You can also come up with various tasks to increase players' interest.

Did this answer your question?