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

# Slack

Connect Slack to Heeler over OAuth so workflows can post notifications to your channels.

Heeler integrates with Slack to post workflow notifications and enable collaboration. It connects over **OAuth** — install the Heeler Slack app and grant access.

{% hint style="info" %}
This is the **setup** page. Once the app is connected, the same integration also powers **interactive querying** from Slack — slash commands and the `@Heeler` assistant. See [Heeler in Slack](/mrecEO40m5D6bt7Pq5pE/operate/heeler-in-slack.md).
{% endhint %}

## What Heeler needs

* View basic information about public channels and people in your workspace.
* View profile details about people.
* Send messages as `@heeler`.
* Upload, edit, and delete files as the Heeler Security App.

## Connect Slack

{% stepper %}
{% step %}

### Add the integration

Go to **Administration → Integrations → Add Integration → Slack**.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-13dc23ca4e72d50103f5e068c0c923e00367c543%2Fam-integrations-picker.png?alt=media" alt="The Add Integration menu open on the Integrations page, with Slack at the top of the provider list."><figcaption><p>Add Integration → Slack.</p></figcaption></figure>
{% endstep %}

{% step %}

### Authorize

Select the correct Slack workspace to connect.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-d494463833b74a09c00790df0817ce08264d99e5%2Fcc-int-slack-02.png?alt=media" alt="Slack&#x27;s workspace picker: choosing which Slack workspace to grant the Heeler Security App access to."><figcaption><p>Select the Slack workspace to connect.</p></figcaption></figure>

Then review the permissions and click **Allow**.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-160e93d211101d1fd1befd5c9c72192cc57b4780%2Fcc-int-slack-03.png?alt=media" alt="Slack&#x27;s permission screen: Heeler Security App is requesting permission to access the workspace, with view/do sections and an Allow button."><figcaption><p>Review the permissions and click <strong>Allow</strong>.</p></figcaption></figure>
{% endstep %}

{% step %}

### Verify

The integration shows **Healthy**. Slack is now available in [Workflows](/mrecEO40m5D6bt7Pq5pE/operate/workflows.md) and [team routing](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/team-ticket-settings.md).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Private channels.** By default Heeler can't see private channels. To use one, **invite `@heeler` to it in Slack** — it then becomes selectable as a messaging target in Heeler. Heeler re-reads the workspace's channel list every 12 hours; to pick the channel up straight away, open the **⋯** menu on the Slack row and choose **Sync Channels**.
{% endhint %}

## Refreshing credentials

Heeler uses short-lived credentials refreshed automatically. If the connection breaks, open the **⋯** menu on the Slack row and choose **Refresh Token**.

<figure><img src="https://414480750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXP3dp2kecwKA2KvYkntz%2Fuploads%2Fgit-blob-d1d4a9558e308fcd63138c06dea3df3c8954bc29%2Fcc-int-slack-04.png?alt=media" alt="The row action menu on the Slack integration with the Refresh Token option."><figcaption><p>Refresh Token restores the connection if it breaks.</p></figcaption></figure>

## Related

* [Heeler in Slack](/mrecEO40m5D6bt7Pq5pE/operate/heeler-in-slack.md) — query findings, SLO status, and vulnerabilities with slash commands and the `@Heeler` assistant once the app is connected.
* [Team Ticket Settings](/mrecEO40m5D6bt7Pq5pE/get-started/map-your-organization/team-ticket-settings.md) — set each team's Slack channel for team-routed notifications.


---

# 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.heeler.com/mrecEO40m5D6bt7Pq5pE/get-started/messaging/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.