Skip to main content

🧠 Smart Triggers

A smart trigger asks AI a yes/no question about each message, such as "Is this message promoting another project?". When the answer is yes, the agent takes the actions you chose. Unlike keyword triggers, it judges meaning and context rather than exact words.

Where to configure it

In the webapp: Open your workspace, select the Telegram group under Channels in the sidebar, then select AI Features, then the AI Moderator tab. Smart triggers are Your custom rules: select Manage custom rules to create and edit them, or + Add rule. Each custom rule's switch saves instantly. The AI Moderator's master switch doesn't pause custom rules; they keep running on their own switches.

In Telegram (bot menu): the /settings menu route below still works.

Creating a trigger in Telegram (bot menu)​

  1. Send /settings, open 🤖 AI → 🧠 Smart triggers, and toggle it 🟢 Enabled.

  2. Select + Create Trigger.

  3. Pick a template, or write your own prompt. The templates are 📢 Promotional Content, ☠️ Toxic Language, 🎣 Scam Attempts, 💰 Price Discussion and 🔞 NSFW Content.

  4. Choose one or more actions:

    ActionNotes
    Delete messageRemoves the message.
    MuteWith a duration.
    KickThe member can rejoin.
    BanWith a duration.
    WarnAdds a warning.
    ReplyReplies to the message with your text. Not available when Delete message is selected.
    Send messagePosts your text in the chat.

    Selecting Reply or Send message adds a Message button for the text.

  5. Set New users only. It's on (✅) by default, so only members who count as new under your new member definition are checked. Turn it off (❌) to check every non-admin member.

  6. Select 💾 Save.

The triggers list shows each trigger's prompt, actions and new-users-only setting, for example:

🧠 Smart trigger 1
💭 Prompt: Does this message discuss price action?
💥 Actions:
• warn
• Send message: Please refrain from discussing price here, thanks!
👶 New users only: ❌ No

Select a trigger to ✏️ Edit it (then 💾 Save) or 🗑️ Delete it (after confirming).

Writing prompts​

Ask one specific yes/no question per trigger, about something visible in the message. "Does this message contain promotional links to external services?" works better than "Is this spam?". More examples:

Is this message asking about when tokens will be listed on exchanges?
Does this message contain financial advice or investment recommendations?
Does this message contain a referral link, affiliate link, or ask people to sign up using a code?

Troubleshooting​

A trigger never fires

  • Check Smart Triggers is enabled, and the trigger's own switch is on.
  • If New users only is on, established members aren't checked.
  • Try the prompt against a message that obviously matches.

It catches the wrong messages

  • Make the prompt narrower and more concrete, or split one broad question into several triggers.

The action isn't carried out

  • The agent needs the matching admin permission, such as deleting messages or banning users.