Autoresponder

Autoresponders let Antidote watch messages or reactions in your server and automatically respond with plain text, a saved embed, and/or a reaction on the trigger message. You create and edit them in the dashboard; the bot loads rules from the API and runs them on every matching event.

Limits

Your plan caps how many autoresponders a server may have. Typical defaults in the API are 2 on free tiers and 50 on premium (exact numbers follow your live Server limits / billing configuration).

How the bot runs them

1. On each guild message, the bot loads your server’s autoresponder list and runs handlers whose trigger method is message.
2. On reaction add (and optionally remove), it runs handlers whose trigger method is reaction.
3. Rules are cached per server for about 10 minutes. After you edit responders in the dashboard, allow a short delay or use your normal cache clear tooling if changes do not appear immediately.

[!tip] Order and scope Message autoresponders are evaluated before prefix commands are parsed in the message pipeline. They apply to normal channel messages the bot can see (subject to channel permissions and intents).

Trigger: Message

Field	Purpose
Match type	How the trigger text is compared to the message content (case-insensitive).
Trigger text	The string users must match (required for message triggers).

Match type (value)	Behavior in the bot
0 — “Check entire message…”	The message must contain the trigger as a substring (includes).
1 — “Check start…”	The message must start with the trigger text.
2 — “Check end…”	The message must end with the trigger text.

Trigger: Reaction

Field	Purpose
Reaction to monitor	A server custom emoji to watch for (required). Unicode-only reactions are not selectable here.
Reaction filter type	Any message vs only messages whose full text matches a target string.
Message content to match	When filter type is message, the reacted message’s content must match exactly (after lowercasing), character-for-character aside from case.
Also check remove reaction events	When enabled, removing that emoji can fire the same responses as adding it (if other checks pass).

Bot reactions are ignored — reactions from Discord bots do not run reaction autoresponders.

Basic options (message and reaction)

Option	Effect
Delete trigger message	After a match, the trigger message is deleted after self destruct time seconds (same delay field as self-destruct; set to 0 for immediate delete when that path runs).
Use reply rather than send to channel	Plain send message responses become a reply to the trigger message instead of a standalone channel message.
Self destruct	After the configured delay (0–60 seconds), the trigger message is deleted (message triggers and reaction triggers both target the reacted message for reactions).

Responses (can combine)

Response	Notes
Send a message	Free text (large limit in storage). Honors use reply when enabled.
Send an embed	Uses a saved server embed from the embed library. The bot currently sends this as a normal channel message (not a reply), even if “use reply” is on for text.
Send a reaction	Antidote reacts on the trigger message with a server emoji you pick; the emoji must be visible to the bot in cache (custom emojis defined on the server).

Validation (API)

The server rejects saves when, for example:

• Message trigger is chosen but trigger text is empty.
• Reaction trigger is chosen but monitor emoji is missing.
• Reaction filter type is message but message content to match is empty.
• Send embed is on but the embed ID is not a valid embed for that server.
• Send reaction is on but no reaction is chosen.
• Self destruct is on but time is outside 0–60 seconds.

Ideas for safe use

• Prefer starts with or a very specific substring to avoid accidental fires in busy channels.
• Test in a private channel first; multiple enabled responders can all evaluate the same message.
• Keep self destruct and delete trigger in mind for moderation and audit trails.

Related

• Dashboard — autoresponder list — create, search, edit, delete (per-server URL).
• Custom embeds — build embeds used by Send an embed.
• thrallix/clearcaches (bot operator) — can clear autoresponderServerCache if you need configs to reload immediately after changes.