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

# Introduction to Discord Notification

Discord Notification lets you send automated messages to your Discord channels when events happen in your organization. When a task is created, a route is optimized, or a data source is updated, a formatted message is delivered to the Discord channel of your choice.

<div align="center">
  <img src="https://mintcdn.com/mile-app/Jxh3hvdoSQI4O3RP/images/add-on/discord-notification/manager-overview.png?fit=max&auto=format&n=Jxh3hvdoSQI4O3RP&q=85&s=d957df04cba8dc187cb464df1b65feba" alt="Discord Notification Manager page" width="600" data-path="images/add-on/discord-notification/manager-overview.png" />
</div>

<p><em>The Discord Notification Manager lists all configured automations with their event type, webhook, and status.</em></p>

## Key Concepts

* **Automation**: A rule that listens for an event and sends a Discord message when it fires. Each automation is linked to one event and one webhook.
* **Webhook**: A Discord Webhook URL that points to a specific channel on your Discord server. You generate it inside Discord's channel settings.
* **Event**: The trigger that fires the automation. Supported events include task creation, task assignment, task completion, data source creation, routing results, and trip start/finish.
* **Message Builder**: The editor where you compose the Discord message, insert dynamic variables (task data, flow fields, mentions), apply markdown formatting, and preview the result in real time.
* **Mention**: A pre-configured Discord user or role that can be tagged inside a message so they receive a notification on Discord.

## Who Uses Discord Notification

1. **Administrators and Managers**: Set up the add-on, configure webhooks and mentions, create automations, and monitor delivery through Discord.
2. **Team Members on Discord**: Receive notifications in their channels without needing to log in to the platform.

## What You Can Do

* [Set up the add-on](/pages/add-on/discord-notification/setting-up) with a guided wizard that verifies permissions and configures your webhooks
* [Create automations](/pages/add-on/discord-notification/creating-automations) that send rich messages with dynamic data to Discord channels
* [Manage automations](/pages/add-on/discord-notification/managing-automations) from a central table: search, filter, activate, deactivate, edit, or delete
* [Configure settings](/pages/add-on/discord-notification/settings) to add or remove webhooks, mentions, and default bot identity

## Supported Events

| Event | Description |
| - | - |
| Task Created | Fires when a new task is created |
| Task Assigned | Fires when a task is assigned to a user |
| Task Finished | Fires when a task is marked as complete |
| Data Source Created | Fires when a new data source record is created |
| Routing Finished | Fires when a route optimization completes |
| Routing Dispatched | Fires when an optimized route is dispatched |
| Start Trip | Fires when a user starts a trip |
| Finish Trip | Fires when a user finishes a trip |

## Getting Started

To start using Discord Notification, an administrator must first complete the one-time setup wizard. Head over to [Setting Up](/pages/add-on/discord-notification/setting-up) to begin.
