> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Auto Responder

> Create custom automated text and embed replies for specific keywords.

The Auto Responder module allows ZEON to instantly reply with a custom message whenever a member sends a specific phrase. These automated replies fully support dynamic variables and rich embeds, making them perfect for answering FAQs or welcoming users.

<Note>
  **Required Permission:** [Admin Access](/permissions/admin-access) or higher — Server Owner, Extra Owner, Trusted User, or Administrator with a role above the bot can use these commands.
</Note>

***

## Setting Up

Follow these steps to create your first auto-responder.

<Steps>
  <Step title="Add a Trigger">
    Provide the exact trigger phrase and the response you want the bot to send.

    ```bash theme={null}
    .autoresponder add !ping Pong! {user} your latency is low.
    ```
  </Step>

  <Step title="Test It">
    Send the exact trigger phrase in chat to see the bot's response.
  </Step>
</Steps>

<Note>
  Unlike Auto React, Auto Responder triggers require an **exact match**. If the trigger is `how to join`, the bot will only reply to messages that contain *exactly* "how to join" (though it is case-insensitive). It will not reply to "tell me how to join".
</Note>

***

## Commands

You can use `.autoresponder` or the shorter `.ar` alias for all commands.

| Command                                         | Description                                               |
| :---------------------------------------------- | :-------------------------------------------------------- |
| `.autoresponder add <trigger> <response>`       | Creates a new auto-responder                              |
| `.autoresponder remove <trigger>`               | Deletes an existing auto-responder                        |
| `.autoresponder editreply <trigger> <response>` | Changes the response text for an existing trigger         |
| `.autoresponder rename <trigger> <new>`         | Changes the trigger phrase for an existing auto-responder |
| `.autoresponder show`                           | Lists all active auto-responders in the server            |
| `.autoresponder reset`                          | Deletes all auto-responders (requires confirmation)       |

***

## Customizing Responses

Auto-responder replies are fully customizable and support both **dynamic variables** and **custom embeds**.

### Using Variables

You can dynamically insert information like the user's name or server details. Refer to the [Variables](/resources/variables) reference for the full list.

**Available contexts:** Server, Channel, User, Author, Target

<CodeGroup>
  ```bash Input theme={null}
  .autoresponder add rule 1 Be respectful to everyone, {user}!
  ```

  ```text Output theme={null}
  Be respectful to everyone, @john_doe!
  ```
</CodeGroup>

### Using Custom Embeds

Design a rich embed using the interactive embed builder, then attach it to your response with the `{embed:name}` syntax.

<Steps>
  <Step title="Create the Embed">
    ```bash theme={null}
    .embed create faq_rules
    ```

    Use the dropdown menu to customize the title, description, color, and images.
  </Step>

  <Step title="Attach to Response">
    ```bash theme={null}
    .autoresponder add !rules Here are the rules: {embed:faq_rules}
    ```
  </Step>
</Steps>

<Note>
  The `{embed:name}` placeholder is invisible in the final output. The bot strips it from the text and attaches the rich embed below the message.
</Note>

***

## Limitations

<Warning>
  * You can create a maximum of **20 auto-responder triggers** per server.
  * To prevent spam, there is a built-in **3-second cooldown** per user for each specific trigger.
  * The bot ignores messages sent by other bots or by blacklisted users.
</Warning>
