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

# Slack

> Send real-time notifications to your Slack channels

The Slack integration allows you to receive rich, real-time updates about your agents directly in your Slack workspace. You can configure notifications for specific events, such as when an execution completes, fails, or requires your attention.

## Prerequisites

* A Slack Workspace where you have permissions to install apps.
* Access to the Asteroid Platform.

## Setup

### 1. Install the Integration

1. Log in to the [Asteroid Platform](https://platform.asteroid.ai).
2. Navigate to **Integrations** in the main menu.
3. Click the **Add Integration** button and select **Slack**.
4. You will be redirected to Slack's authorization page.
   * Review the requested permissions (e.g., `chat:write`, `channels:read`).
   * Select the Slack Workspace you want to connect.
   * Click **Allow** to grant access.

### 2. Configure the Default Channel

Once the integration is installed, you need to tell Asteroid where to send messages by default.

1. In the **Integrations** list, find your new Slack integration.
2. Click the **Edit** button (pencil icon) on the integration card.
3. In the configuration modal, select a **Default Channel** from the dropdown list.
4. Click **Save**.

<Note>
  **Private Channels**: The dropdown lists all public channels. If you want to send notifications to a private channel, you must manually invite the Asteroid bot (usually named `@Asteroid`) to that private channel inside Slack first. Once invited, the channel will appear in the dropdown list (you may need to refresh the page).
</Note>

The Asteroid bot will automatically attempt to join the channel you select.

## Usage

### Binding to Agents

To start receiving notifications, you must attach the Slack integration to your agents.

1. Navigate to the **Agents** page and select an agent.
2. Go to the **Notifications** tab.
3. Click **Add Notification**.
4. Select your Slack integration from the list.
5. Configure your **Event Rules** (see [Overview](/fundamentals/integrations/overview#filtering--rules) for details on filtering).
6. Click **Add**.

### Notification Format

Asteroid sends rich, structured messages to Slack designed to give you immediate context:

* **Status**: Visual indicators (Green for success, Red for failure, etc.) showing the event type.
* **Agent Context**: The name of the agent and a link to the specific execution in the platform.
* **Details**:
  * For `EXECUTION_COMPLETED`: A snippet of the result and the agent's reasoning.
  * For `EXECUTION_FAILED`: The error message and reason for failure.
  * For `EXECUTION_PAUSED`: The reason for the pause (e.g., the question the agent is asking).

### Interactive Elements

Some notifications, such as "Human in the Loop" requests, may include interactive buttons allowing you to View Execution directly from Slack.