Skip to main content

🔫 Triggers

The Triggers feature allows administrators to automate responses or actions in their community based on specific keywords, commands, or patterns in messages. Triggers can be used to share pre-saved information, handle sensitive content like contract addresses, or even filter and remove spam-like messages to maintain community security.

Overview​

Triggers enable automated moderation and responses in your community. When a message matches a defined condition, the bot can automatically perform actions like sending responses, deleting messages, or applying moderation actions to users.

Configuration​

To access Triggers:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → 🔫 Triggers
  3. Select Create Trigger to begin setup

Setting Up Triggers​

1. Define the Title​

This will be displayed in the list of active triggers, so it's helpful to choose a recognizable and descriptive title.

Example titles:

  • "Contract Address Response"
  • "Buy Instructions"
  • "Spam Filter"

2. Define the Condition​

Prompt: "📝 Please send a condition for this trigger."

💡 The condition can be a keyword, phrase, or command.

Common Condition Examples
  • /buy to provide token purchase instructions
  • /ca to share the token's contract address
  • Spam keywords to filter unwanted content

After typing in the condition, select how the trigger should behave with the following options:

Condition Type​

  • Full Match: The message must exactly match the condition
  • Partial Match: The condition can be anywhere in the message
  • Regular Expression: Use regex for advanced pattern matching
  • Starts With: The message must start with the condition
  • Ends With: The message must end with the condition
🤖Regex Generator
Create regex for:

Additional Options​

  • Case Sensitive: Enable or disable case sensitivity for the trigger
  • Add Condition: Add multiple conditions triggering the same action within one trigger
Multiple Conditions

Use the Add Condition option to create triggers that respond to multiple keywords or phrases with the same action.

3. Select the Action​

After defining the condition, choose what action the bot should take when the condition is met. You can select multiple actions:

  • Delete the message: Removes the triggering message
  • Send a message: Sends a pre-defined response (e.g., "Here is the contract address: 0x123…")
  • Kick: Removes the user from the group
  • Ban: Permanently bans the user from the group
  • Mute: Temporarily silences the user
  • Warn: Sends a warning to the user
  • Unrestrict: Lifts any restrictions previously applied to the user
  • Award XP: Awards XP to the user who met the trigger condition
Action Order

Set up all your desired conditions first and select Save. Then if you're sending a message, a new option: Message will appear in the trigger configuration menu.

4. Configure the Message (If Applicable)​

After clicking on Message, you can create a response to the trigger sent by the bot in the chat.

Configurations​

  • Admin Only: This trigger will only work for admins

5. Create Trigger​

Once all settings are defined, select Save to finalize the setup. A confirmation message will appear:

✅ Trigger created successfully.

Common Use Cases​

Auto-Response for Commands​

Create triggers to automatically respond to frequently asked questions:

Example: Token Purchase Instructions

  • Condition: /buy or how to buy
  • Type: Partial Match
  • Action: Send a message
  • Response: "To buy tokens, visit our DEX at [link] or use our official partners."

Contract Address Protection​

Prevent phishing by deleting user-posted contract addresses and sharing the official one:

Example: Contract Address Filter

  • Condition: 0x (common in Ethereum addresses)
  • Type: Partial Match
  • Actions: Delete the message + Send a message
  • Response: "⚠️ Please don't share contract addresses. The official address is: 0x123..."

Spam Prevention​

Automatically remove spam messages:

Example: Spam Keyword Filter

  • Condition: airdrop|giveaway|free money (regex)
  • Type: Regular Expression
  • Actions: Delete the message + Warn user
  • Message: "Spam content is not allowed."

Admin Commands​

Create admin-only triggers for quick actions:

Example: Admin Announcement

  • Condition: /announce
  • Type: Full Match
  • Action: Send a message
  • Admin Only: Enabled
  • Response: "Official announcement: [your message]"

Managing Existing Triggers​

Editing Triggers​

  1. Navigate to 🛡️ Moderation → 🔫 Triggers
  2. Select the trigger you want to edit
  3. Modify the settings as needed
  4. Save your changes

Deleting Triggers​

  1. Navigate to the trigger list
  2. Select the trigger to delete
  3. Confirm deletion

Troubleshooting​

Trigger not activating?

  • Verify the condition type matches your use case
  • Check if case sensitivity is affecting matches
  • Ensure the trigger is enabled
  • Verify bot has necessary permissions for the action

Trigger catching unintended messages?

  • Switch from Partial Match to Starts With or Full Match
  • Refine your regex pattern
  • Add case sensitivity if needed
  • Review and adjust the condition

Bot not sending trigger response?

  • Ensure you saved the trigger after adding the message
  • Check that the bot has permission to send messages
  • Verify the Message option was configured after saving the condition

Actions not executing?

  • Confirm bot has admin privileges
  • Check if the action requires specific permissions (ban, kick, mute)
  • Verify the user isn't whitelisted or an admin

On this page