> For the complete documentation index, see [llms.txt](https://docs.ilert.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ilert.com/chatops/slack.md).

# Integration for Slack

With the integration for Slack you can receive alerts in Slack channels and act on them there, raise new alerts from a channel, and check who is on-call — without opening ilert.

Connecting a workspace is a one-time step by an admin. After that, each capability below is configured on its own.

## Select your use case <a href="#in_slack" id="in_slack"></a>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Receive and respond to alerts in Slack</strong></td><td>Receive and acknowledge alerts in a Slack channel of your choice.</td><td><a href="/pages/uB4kPFIoptdeIjkgMiOe">/pages/uB4kPFIoptdeIjkgMiOe</a></td></tr><tr><td><strong>Create alerts within a Slack channel</strong></td><td>Use Slack as an alert source and let Slack users create alerts from Slack.</td><td><a href="/pages/wBdvJFr9SPOZhq87VfiS">/pages/wBdvJFr9SPOZhq87VfiS</a></td></tr><tr><td><strong>Lookup who is on-call in Slack</strong></td><td>Lookup who is on-call right from Slack using our <code>/il-oncall</code> Slash command.</td><td><a href="/pages/F8E09mYZf5Q0pgtSoD82">/pages/F8E09mYZf5Q0pgtSoD82</a></td></tr></tbody></table>

## Authorize your Slack workspace <a href="#in_ilert" id="in_ilert"></a>

{% hint style="info" %}
**Admin permission required**

You need to have global **Admin** privileges to set up the integration in ilert.
{% endhint %}

{% stepper %}
{% step %}

## Open the Slack connector

In the sidebar, go to **Settings** → **Connectors**, then click **Slack Workspace Integration**.
{% endstep %}

{% step %}

## Authorize

Click **Authorize**. You are forwarded to Slack — log in if you are not already — and asked to allow ilert to access your workspace.
{% endstep %}

{% step %}

## Confirm

Slack returns you to ilert. A success message confirms the workspace is connected.
{% endstep %}
{% endstepper %}

Add the **ilert** bot to any channel where you want to receive alerts.

<details>

<summary>Re-authorizing your Slack Workspace</summary>

You **may** need to re-authorize the bot for your Slack workspace in case new features of the bot require additional permissions e.g. alert actions or automatic user mapping.

In the sidebar, go to **Settings** → **Connectors**, click **Slack Workspace Integration**, then click **Re-authorize Slack**.

</details>

## FAQ <a href="#faq" id="faq"></a>

**Can I link multiple Slack Workspaces to one ilert account?**

No, only one Slack Workspace can be linked to an ilert account.

**Can multiple ilert accounts be linked to the same Slack workspace?**

No, a Slack workspace can only be linked to one ilert account at a time.


---

# 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://docs.ilert.com/chatops/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.