> For the complete documentation index, see [llms.txt](https://docs.asagi.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.asagi.xyz/server-control/interactive-messages/getting-started.md).

# Getting Started

Interactive Messages combines a Discord message with interactive components such as buttons and select menus.

Everything on this page is configured from **Dashboard → Server Control → Interactive Messages**.

### Create an Interactive Message

1. Open **Interactive Messages**.
2. Select **New message**.
3. Enter a title for the dashboard entry.
4. Choose the Discord **Channel** where the message should be published.
5. Create the message content or select one of **My Templates**.
6. Add at least one button or select menu.
7. Review the preview.
8. Save the message.

A valid Interactive Message needs both message content and at least one interactive component.

> 🎬 **Create an Interactive Message**
>
> See how to build a message, add a component, and publish it to Discord.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FGWTZmfYvhZ7mDyZqksbC%2Finteractive%20messages%20creation.mp4?alt=media&token=3b7d45db-9e0b-40a1-a8f8-21808de7f742>" %}

> 🖼️ **Published Interactive Message**
>
> The finished message appears in the selected channel with its configured components ready to use.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FhosI1fkEyKJAvqKvQ5Wg%2Finteractive_label_message_padded_lossless.webp?alt=media&amp;token=f479d533-d15d-4e19-b04c-352e45b36540" alt=""><figcaption></figcaption></figure>

### Custom Messages and Templates

For the message content, choose between:

* **Custom** — build the message directly inside the Interactive Message editor;
* **My Templates** — use a saved Embed Message template.

When an Interactive Message is linked to a saved template, changes to that template are synchronized to the published Interactive Message.

### Quick Start

Quick Start provides ready-made setups for common server features.

| Quick Start | What it creates                                                           |
| ----------- | ------------------------------------------------------------------------- |
| **Verify**  | A verification channel, a Verified role, and a button that gives the role |
| **Colors**  | A color-role panel with eight color roles                                 |
| **Region**  | A region-role panel with six regional roles                               |

Asagi reuses matching Quick Start roles or channels when possible and creates the missing ones.

> 🖼️ **Quick Start**
>
> Ready-made setups give you a complete starting point that can still be customized before saving.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FIVEl1vvomuV9or6lWnAs%2Freaction%20roles%20quick%20sets.webp?alt=media&amp;token=0d2aa5ba-929f-4326-a25e-9928d4591f96" alt=""><figcaption></figcaption></figure>

> **Important:** the **Verify** Quick Start also configures channel visibility across the server. The verification channel remains visible before verification, while other manageable channels are gated behind the **Verified** role. Review this setup carefully before saving it on an existing server with a complex permission structure.

### Manage Published Messages

The **Your Messages** list lets you search for an Interactive Message and open it for editing.

Changes to the message or its components are synchronized to the existing Discord message.

The destination channel is locked after the message has been published. If you need the panel in another channel, create a new Interactive Message there.

Deleting an Interactive Message also removes its published Discord message when Asagi can still access it.

### Troubleshooting

If a message cannot be published or updated, check that:

* the selected channel still exists;
* Asagi can view and send messages in that channel;
* the message contains at least one interactive component;
* any configured actions still point to valid channels, roles, or templates.

Asagi can surface action and delivery failures through dashboard notifications.

### Where to Go Next

Continue with [**Buttons & Select Menus**](https://docs.asagi.xyz/server-control/interactive-messages/buttons-and-select-menus.md) to customize how members interact with your message.
