> ## Documentation Index > Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt > Use this file to discover all available pages before exploring further. # Auto Responders > Create automatic responses to specific triggers in your server ## Overview Auto responders automatically reply when members send messages containing specific triggers. Perfect for FAQs, keyword responses, memes, and automated interactions. Supports text replies, reactions, and custom embeds with advanced flags for precise control. Auto responders can be text messages, emoji reactions, or custom embeds with optional flags for fine-tuned behavior. *** ## Commands Create a new auto responder. ```bash Syntax theme={null} ~autoresponder add [type=text|reaction|embed] [flags=flag1,flag2] ``` ```bash Example theme={null} ~autoresponder add hello Hi there! Welcome to the server ~ar add gm Good morning! ☀️ ~autoresponder add brb 👋 type=reaction ~ar add rules Check the rules in #rules flags=exact,delete ~autoresponder add hi Hello {user.mention}! flags=start ``` **Parameters:** * **trigger** — Word/phrase that triggers the response * **response** — What the bot replies with * **type** — Optional: `text`, `reaction`, or `embed` (auto-detected) * **flags** — Optional: Behavior modifiers (comma-separated) **Type Auto-Detection:** * If response is 1-3 emojis only → `reaction` type * Otherwise → `text` type * Override with `type=` parameter **Aliases:** `ar add`, `autoresponse add`\ **Permissions:** Manage Server Delete an existing auto responder. ```bash Syntax theme={null} ~autoresponder remove ``` ```bash Example theme={null} ~autoresponder remove hello ~ar remove gm ~ar delete rules ``` **Parameters:** * **trigger** — Trigger phrase to remove **Aliases:** `ar remove`, `ar delete`, `ar del`\ **Permissions:** Manage Server Edit an existing auto responder. ```bash Syntax theme={null} ~autoresponder edit ``` ```bash Example theme={null} ~autoresponder edit hello response Hi! How can I help? ~ar edit gm type reaction ~ar edit rules flags exact,delete ``` **Fields:** * **response** (or **reply**) — Change the response text * **type** — Change type: `text`, `reaction`, or `embed` * **flags** — Change flags (comma-separated, no spaces) **Aliases:** `ar edit`, `ar modify`\ **Permissions:** Manage Server View all auto responders (compact view). ```bash Syntax theme={null} ~autoresponder list ``` ```bash Example theme={null} ~autoresponder list ~ar list ``` **What It Shows:** * All triggers and responses * Type and flags for each * Up to 25 responders per page * Compact overview format **Aliases:** `ar list`, `ar show`\ **Permissions:** Manage Server Browse auto responders individually (detailed view). ```bash Syntax theme={null} ~autoresponder listall ``` ```bash Example theme={null} ~autoresponder listall ~ar listall ``` **What It Shows:** * Detailed view of each responder * Full response text * All flags and settings * Navigation buttons (2 per page) **Aliases:** `ar listall`, `ar showall`\ **Permissions:** Manage Server Delete all auto responders in the server. ```bash Syntax theme={null} ~autoresponder clear ``` ```bash Example theme={null} ~autoresponder clear ~ar clear ``` **What It Does:** * Removes ALL responders from server * Cannot be undone * Shows confirmation This permanently deletes all auto responders in your server. **Aliases:** `ar clear`, `ar wipe`\ **Permissions:** Manage Server View all available responder flags. ```bash Syntax theme={null} ~listflags ``` ```bash Example theme={null} ~listflags ~flags ``` **What It Shows:** * All available flags * Detailed explanations * Usage examples * Interactive navigation **Aliases:** `flags`, `flaglist`\ **Permissions:** None *** ## Response Types The bot sends a text message. ```bash theme={null} ~ar add hello Welcome to the server! ~ar add help Check out #support for assistance ``` **Use Cases:** * Greetings and welcome messages * FAQ responses * Helpful information * Commands guides **Supports:** * Plain text * Variables/placeholders * Mentions * Custom formatting The bot reacts with emojis (1-3 emojis). ```bash theme={null} ~ar add brb 👋 ~ar add thanks ❤️ ~ar add nice 👍 😄 ✨ ``` **Use Cases:** * Quick acknowledgments * Emoji responses * Fun interactions * Simple reactions **Limits:** * Maximum 3 emojis * Unicode or custom emojis * Auto-detected if response is only emojis The bot sends a custom embed. ```bash theme={null} ~ar add info {embed}$v{title: Server Info}$v{description: Welcome!}{embed} type=embed ``` **Use Cases:** * Formatted information * Rich content * Professional responses * Multi-field data **Supports:** * Full embed syntax * Variables/placeholders * Images and thumbnails * Custom colors *** ## Available Flags | Flag | Description | Example Use | | ---------- | --------------------------------------------------------------------- | ----------------------------------- | | `case` | Case-sensitive trigger
(`Hello` ≠ `hello`) | Proper nouns, specific formatting | | `exact` | Only triggers if message is exactly the trigger
(no extra text) | Precise commands, one-word triggers | | `start` | Triggers if message starts with trigger
(allows text after) | Prefix-style responses | | `includes` | Triggers if trigger appears anywhere in message
(even in middle) | Keyword detection | | `bot` | Also triggers on bot messages
(normally ignored) | Bot-to-bot interactions | | `dm` | Works in DMs
(normally server-only) | Private responses | | `delete` | Deletes user's message after triggering
(cleanup) | Clean channels, hide commands | | `reaction` | Forces reaction type
(manual override) | Explicit reaction mode | *** ## Flag Usage ```bash theme={null} # Case-sensitive trigger ~ar add Hello Hi there! flags=case # Exact match only ~ar add help Type !help for commands flags=exact # Delete user message ~ar add secret Shhh! flags=delete ``` ```bash theme={null} # Exact + Delete ~ar add rules Check #rules flags=exact,delete # Start + Case ~ar add Hello Hi! flags=start,case # Includes + Bot ~ar add error Error detected! flags=includes,bot ``` ```bash theme={null} # FAQ that must be exact and deletes trigger ~ar add !faq Here's the FAQ: ... flags=exact,delete # Case-sensitive greeting ~ar add Hello Welcome! flags=case,exact # Keyword anywhere in message ~ar add help Need help? flags=includes ``` *** ## Permission Requirements The bot needs: * Send Messages * Manage Messages (for `delete` flag) * Add Reactions (for reaction type) * Embed Links (for embed type) Command Requirements: * **Manage Server** — All autoresponder commands * **None** — Viewing flags with `listflags` *** ## Aliases Full command Short alias Alternative *** ## Usage Examples ```bash theme={null} # Simple text responses ~ar add hello Hi there! Welcome to the server ~ar add bye Goodbye! See you later ~ar add thanks You're welcome! ~ar add gm Good morning everyone! ☀️ ``` ```bash theme={null} # Emoji reactions ~ar add brb 👋 ~ar add thanks ❤️ ~ar add nice 👍 😄 ✨ ~ar add rip 😔 🙏 ``` ```bash theme={null} # Common questions ~ar add !help Check out our commands in #bot-commands flags=exact ~ar add !rules Read the rules in #rules flags=exact,delete ~ar add !support Open a ticket in #support for help flags=exact ``` ```bash theme={null} # Using placeholders ~ar add welcome Welcome {user.mention} to {guild.name}! ~ar add joined You joined on {user.joined_at} ~ar add members We have {guild.count} members! ``` ```bash theme={null} # Case-sensitive ~ar add GM Good morning! flags=case # Start trigger ~ar add !warn Warning: flags=start # Includes keyword ~ar add discord Join our Discord! flags=includes # Delete + Exact ~ar add secret 🤫 flags=delete,exact ``` ```bash theme={null} # View all responders ~ar list # View detailed ~ar listall # Edit responder ~ar edit hello response Hi! How are you? # Remove responder ~ar remove hello # Clear all ~ar clear ``` *** ## Common Use Cases ```bash theme={null} ~ar add !invite https://discord.gg/... flags=exact ~ar add !website https://example.com flags=exact ~ar add !support Open a ticket in #support flags=exact ``` Automate answers to frequently asked questions. ```bash theme={null} ~ar add hello Hi {user.mention}! Welcome! ~ar add gm Good morning! ☀️ ~ar add gn Goodnight! 🌙 ``` Friendly automatic greetings. ```bash theme={null} ~ar add f 😔 🙏 ~ar add bruh 💀 ~ar add based 😎 ``` Fun emoji reactions to common phrases. ```bash theme={null} ~ar add !help Check DMs for help flags=exact,delete ~ar add !ping Pong! flags=exact,delete ``` Clean channels by deleting trigger messages. ```bash theme={null} ~ar add banned word Please watch your language flags=includes,delete ~ar add help Need help? Ask in #support! flags=includes ``` Detect keywords anywhere in messages. *** ## Tips & Best Practices **Design Tips** * Use `exact` flag for command-style triggers * Use `includes` for keyword detection * Combine `delete` flag for cleaner channels * Keep responses concise and helpful * Test responders before deploying **Flag Strategy** * `exact` — Best for commands (!help, !rules) * `start` — Good for prefix triggers * `includes` — Great for keyword detection * `delete` — Useful for hiding trigger messages * `case` — When case matters (names, acronyms) **Avoid** * Too many generic triggers (hello, hi, hey) * Responders that conflict with each other * Overly long responses * Triggers that are too common * Using `bot` flag unless needed *** ## Troubleshooting ### Responder Not Triggering 1. Check trigger spelling matches exactly 2. Verify flags - `exact` requires perfect match 3. Ensure bot has Send Messages permission 4. Check if `case` flag is causing issues 5. Try `~ar list` to verify it exists ### Response Not Showing 1. Verify bot has Embed Links permission (for embeds) 2. Check bot has Add Reactions permission (for reactions) 3. Ensure response text is valid 4. Test with a simple text response first ### "Trigger Already Exists" You're trying to add a trigger that already exists. **Solutions:** * Use `~ar remove ` first * Or use `~ar edit response ` * Check `~ar list` to see existing triggers *** ## Related Features Use dynamic placeholders in responses Create custom embed responses Automated welcome system Customize command responses