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 acquisition 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

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
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.

Prompt: "📝 Please send the message to be sent for this trigger."

Configurations​

  • Send as reply: The bot will send the set message as a reply to the condition
  • Admin Only: This trigger will only work for admins
  • Link Preview: Add a link preview if your trigger response is a link

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]"

Best Practices​

Effective Trigger Management
  • Use descriptive titles for easy trigger identification
  • Start with simple conditions and expand to regex as needed
  • Test triggers in a private group before deploying
  • Combine actions thoughtfully (e.g., Delete + Warn for spam)
  • Use Admin Only for sensitive commands
  • Enable Send as reply for contextual responses
Avoid Over-Automation
  • Don't create too many overlapping triggers
  • Be careful with broad partial matches that might catch unintended messages
  • Consider the user experience: too many auto-responses can be annoying
  • Review and update triggers regularly
  • Monitor false positives and adjust conditions as needed

Advanced Pattern Matching​

Regular Expression Examples​

For advanced users, regex enables powerful pattern matching:

Match multiple variations:

(buy|purchase|get) tokens?

Matches: "buy token", "purchase tokens", "get token"

Match URLs:

https?://[^\s]+

Matches any HTTP/HTTPS URL

Match Ethereum addresses:

0x[a-fA-F0-9]{40}

Matches valid Ethereum contract addresses

Regex Testing

Test your regex patterns using online tools before implementing them in triggers to ensure they work as expected.

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

Temporarily Disabling Triggers​

Toggle triggers off without deleting them for temporary situations.

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
tip

Remember to give the Fren One bot admin privileges in your chat for all trigger actions to work properly.