> For the complete documentation index, see [llms.txt](https://archivedocs.stackstate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://archivedocs.stackstate.com/monitors-and-alerts/notifications/channels/slack.md).

# Slack

## Configure Slack notifications

To send notifications to Slack follow these steps:

1. [Connect StackState to your Slack workspace](#connect-slack-workspace)
2. [Select a Slack channel to sent the notifications to](#select-a-slack-channel)
3. [Add and test the channel](#add-and-test-the-channel)

### Connect Slack workspace

Click on the "Choose workspace" button. This will open a Slack webpage where StackState asks for permission to list channels and send messages to Slack channels. Make sure that in the top-right corner you have the desired Slack workspace selected.

Click "Allow" to continue.

### Select a Slack channel

![Select the Slack channel](/files/jCFY8jUT9m6GgH2hPY44)

Back in StackState you can now select a Slack channel from the list. Select the channel where the notification messages need to be sent.

{% hint style="info" %}
Private channels won't be listed automatically. To select a private channel first invite the StackState bot into the private channel by sending a Slack message in the channel that mentions the bot `@StackState` and selecting "Invite them." Now the channel will become available in the list.
{% endhint %}

## Add and test the channel

Finally click the "Add channel" button. This adds the channel to the list of channels on the right. It will show a "Test" button. Press it to verify that the test message appears in the selected Slack channel.

## Slack messages for notifications

When a notification is opened a new Slack message is created. This message will be updated for changes, usually only when the health state changes. In the thread for the message every change will show up as a message as well. Finally, when the notification is closed the Slack message is updated again (now the bar that shows the health state is grey) and a final message is added to the Slack thread that describes why the notification was closed.

<figure><img src="/files/sLKUrQ8XNm1r55ISAHN1" alt="Slack thread example" width="75%"><figcaption><p>A Slack message with its thread for a closed notification</p></figcaption></figure>

## Related

* [Troubleshooting](/monitors-and-alerts/notifications/troubleshooting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://archivedocs.stackstate.com/monitors-and-alerts/notifications/channels/slack.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
