Conditions and chats

Conditions are additional filters layered on top of a trigger. All enabled conditions are combined with AND: the reaction fires only if all of them pass. The chat scope — where the reaction can fire at all — is configured separately. Both settings are in the reaction editor (the Conditions and In chats sections).

With labels

Fire only for users who have the required labels. Choose "Has labels" or "No labels" mode and select from the bot's label list. Labels are subscriber tags (VIP, paid, new, etc.); see People (CRM) for details.

With parameters

Check user parameter values. Each rule consists of a key, an operator, and a value. Operators: equals, not equals, greater than, less than, contains, is set, is not set. The bot accumulates parameters through actions (for example, saving dialog responses) — see Actions.

With user IDs

A list of numeric Telegram IDs for whom the reaction is permitted. Useful for personal or administrative reactions.

Time since first seen

Compares how much time has passed since the user first appeared: "less than" / "greater than" mode and a duration in seconds. For example, a special reaction for newcomers within their first 24 hours.

Message count

Compares the user's message count: "less than" / "greater than" / "equals" and a value. Suitable for onboarding flows and activity-based rewards.

Chat membership

Checks whether the user is a member of specified chats: "is" / "is not" plus a list of chat IDs. Membership is tracked via chat-member events. A common use case is "content only for channel members" bots.

Else branch

The "If conditions are not met — run reaction" field specifies a fallback reaction: if the filters don't pass, the specified reaction runs instead of the current one. This is a simple way to split two scenarios with a single rule.

Chat scope ("In chats")

Defines where the reaction can fire at all:

  • Fire in private chat with the bot — direct messages.
  • In groups and channels — only when the bot is addressed — the reaction in groups is active only when the bot is mentioned or replied to.
  • Also in chats whose IDs are stored in user parameters — a dynamic list of chats from user parameters.

If nothing is selected, the reaction only fires in private chats.

User filters

Additional flags (values Any / Yes / No):

  • Started a private chat with the bot — whether the user has an existing private dialog.
  • Blocked the bot — whether the user has blocked the bot.

What's next