🔫 Triggers
Triggers are keyword-based automations: when a message matches one of your conditions, the agent responds — with a message, a deletion, or a moderation action. They're perfect for auto-answering repeated questions and for zapping known spam phrases on sight.
Triggers fire on message text matching your phrases. ⚙️ Automations fire on Discord events (joins, reactions, role changes, and more). ✨ Smart Triggers let the AI judge each message against a plain-language prompt instead of exact phrases.
Overview
- Match messages by Contains, Equals message, Starts with, Ends with, or Regex — with per-condition case sensitivity
- One trigger can hold several conditions; it fires when any of them match
- Chain actions in order: send a response, delete, warn, mute, kick, or ban
- Restrict a trigger to admin messages, or make its response a reply to the matching message
Configuration
To configure triggers:
- Open your project in the Fren One webapp.
- Select the Discord server you want to configure.
- In the sidebar under Agent Configuration, select Moderation, then the Triggers tab.
- Select "Add Trigger" to open the editor, or edit an existing trigger from the list. Each row shows an enable toggle, its action badges, and an "Admin only" badge where set.
Match conditions
Give the trigger a Title (required), then add condition rows. The trigger fires when a message matches any condition.
| Match mode | Fires when the message… |
|---|---|
| Contains | Contains the phrase anywhere (partial match). |
| Equals message | Is exactly the phrase (full match). |
| Starts with | Begins with the phrase. |
| Ends with | Ends with the phrase. |
| Regex | Matches the pattern. Max 500 characters. |
Each row has its own Case sensitive option.
Actions
Actions are required and run in order when the trigger fires:
| Action | Description |
|---|---|
| Send response | Sends the Response Message (see below). |
| Delete message | Removes the matching message. Deleting the message also skips the remaining moderation checks for it. |
| Warn member | Issues a warning through the warn system. |
| Mute member | Times the member out. Reveals a Mute duration field — up to 28 days. |
| Kick member | Kicks the member. |
| Ban member | Bans the member. |
If the warn reaches the community's warn limit, the warn system's punishment replaces this trigger's mute.
Options
| Option | Description |
|---|---|
| Admin only | The trigger only fires on messages sent by admins. |
| Reply to message | Sends the response as a reply to the matching message. Not available when a Delete action is present. |
Response Message
Shown when Send response is selected; required. This is the message the agent sends when triggered. It supports these variables:
| Variable | Inserts |
|---|---|
{user} | A mention of the member who triggered it. |
{username} | The member's username, without a mention. |
{server} | The server name. |
{channel} | The channel where the trigger fired. |
Example triggers
Members ask for the token address a dozen times a day — answer it automatically.
- Conditions: Contains
contract address· Containswhat's the ca - Actions: Send response
- Options: Reply to message
- Response: "Hey
{user}! The official contract address is0x1234…abcd— always verify it against our pinned announcement. Anything else is a scam."
A known scam phrase should never sit in chat waiting for an admin.
- Conditions: Contains
free nitro· Containsclaim your airdrop - Actions: Delete message, Warn member
- Repeat offenders escalate through the warn limit automatically.
Give admins a shorthand that expands into the full support spiel.
- Conditions: Equals message
!support(case sensitive) - Actions: Send response
- Options: Admin only
- Response: "Need help? Open a ticket in the support channel and the team will pick it up — please don't DM admins directly."
Saving your changes
This page uses a batched save — trigger edits stay local until you select Save in the bar that appears at the bottom of the page. Leaving the page with unsaved changes shows a warning first.
Best practices
- Prefer Equals message or Starts with for command-style triggers; reserve Contains for phrases unlikely to appear mid-sentence.
- Group related phrasings ("contract address", "what's the ca") as multiple conditions on one trigger instead of separate triggers.
- Pair Delete message with Warn member for spam phrases so repeat offenders escalate through the warn system on their own.
- Remember that Delete disables Reply to message — a reply needs something to reply to.
Troubleshooting
A trigger isn't firing?
- Check the trigger's enable toggle in the list, and that your edits were saved via the Save bar.
- Case-sensitive conditions must match capitalization exactly.
- With Admin only on, the trigger ignores everyone but admins.
The response didn't appear as a reply?
- Reply to message can't be combined with a Delete action — the target message no longer exists.
A mute didn't stick?
- If the trigger also warns and that warn hits the community's warn limit, the warn system's punishment replaces the trigger's mute.
- Mutes cap at Discord's 28-day maximum.
Related features
- ⚙️ Automations - Event-based workflows: joins, reactions, role changes, threads, and more
- ✨ Smart Triggers - AI-judged triggers written as plain-language prompts
- 🧹 Filters - Pre-built checks for links, invites, caps, and emoji spam
- ⚠️ Warns - The warn limit that trigger warns count toward