# Slack

Firefly integrates with Slack to provide rich notifications for various events and alerts. This integration enables teams to receive real-time updates about infrastructure changes, policy violations, drift detection, and other important events directly in their Slack channels.

When integrating an Slack, you have two primary methods:

* [Slack App](#slack-app).
* [Slack Webhook](#slack-webhook).

## Prerequisites

* A Slack workspace with administrative access.
* Appropriate permissions to install apps or create webhooks.
* Channels where you want to receive Firefly notifications.

## Setup Procedure

### Slack App (Recommended Method)

1. In Firefly, click **Settings > Integrations**.
2. Click **Add New > Slack** (under messaging integrations).
3. Select **Slack App** from the Integration type field.
4. Click to install the Firefly Slack application.
5. Authorize the app in your workspace.
6. Select the desired channel for notifications.
7. Click **Next**.
8. Click **Done**.

### Slack Webhook (Legacy Method)

> **Note**: This integration is deprecated. We recommend using the Slack App integration.

1. Generate a webhook URL for your Slack channel:
   * Visit the [Incoming Webhooks](https://gofireflyio.slack.com/apps/A0F7XDUAZ-incoming-webhooks?tab=more_info) page.
   * Click **Add to Slack**.
   * Choose a channel.
   * Click **Add Incoming Webhooks integration**.
   * Copy the Webhook URL.
2. In Firefly, click **Settings > Integrations**.
3. Click **Add New > Slack**.
4. Select **Slack Webhook** from the Integration type field.
5. Enter a descriptive name in the **Nickname** field.
6. Paste the webhook URL.
7. Click **Next**.
8. Click **Done**.

## Features Enabled

* **Real-time Notifications**: Receive immediate alerts for important events.
* **Rich Message Formatting**: Detailed, formatted messages with direct links to Firefly.
* **Customizable Alerts**: Configure which events trigger notifications.
* **Channel-specific Routing**: Send different types of alerts to different channels.
* **Interactive Messages**: Click through to Firefly directly from Slack notifications.

> **Note:** In the integration settings page, use the notifcation test button to test the integration.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.firefly.ai/integrations/notifications/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.