Skip to main content
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.
  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.
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).
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 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.