> ## Documentation Index
> Fetch the complete documentation index at: https://kb.mspprocess.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack Notifications

> Install a Slack app in your workspace with Authorize, so Triggr workflows can post messages to your team's channels.

Triggr posts messages to your own workspace's channels and lists its public channels. To manage user accounts in your own and your clients' Slack, use [Slack](https://kb.mspprocess.com/integrations/slack/slack.md) instead.

## Connect it in Triggr

You need a Slack account that can install apps in your workspace; if your workspace requires app approval, a Workspace Owner or app manager may need to approve it.

**1. Open the configuration**

Go to **Integrations > Slack Notifications** and click **Configure** on the Base Configuration card.

![The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button.](https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max\&auto=format\&n=nyuVXZ1rouDTTEvu\&q=85\&s=bb81acb082055015f91beda7b4876f35)

**2. Save the app details**

AppID, ClientID and ClientSecret are already filled in with Triggr's Slack app. Leave them, or enter [your own app's](#use-your-own-slack-app), and click Save Configuration.

![The Slack Notifications configuration window with AppID, ClientID and ClientSecret already filled in (blurred), an Allow insecure TLS switch under Advanced, and a Save Configuration button.](https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/slack-notifications/configure.png?fit=max\&auto=format\&n=nyuVXZ1rouDTTEvu\&q=85\&s=f85f08cc2fe6f7d2648a7a52e05d6be4)

**3. Authorize**

Click **Authorize**. In Slack, check the workspace in the top right, then click Allow.

**4. Add the app to your channels**

The app can only post in channels it's a member of. Mention it in each channel and accept Slack's offer to add it, or add it from the channel's settings.

Triggr asks for the `chat:write` and `channels:read` bot scopes. Click Authorize again if you switch apps or the app is removed from your workspace.

## Use your own Slack app

Use your own app to post with your own name and icon.

**1. Create the app**

At [api.slack.com/apps](https://api.slack.com/apps), click **Create New App > From scratch**, name it and pick the workspace it will post to.

**2. Add the redirect URL and scopes**

On OAuth & Permissions, add `https://app.triggr-app.com/oauth/callback` under Redirect URLs, and `chat:write` and `channels:read` under Bot Token Scopes.

**3. Enter it in Triggr**

From **Basic Information > App Credentials**, copy the App ID, Client ID and Client Secret into AppID, ClientID and ClientSecret. Save, click Authorize and add the app to your channels.

## Send messages

Send Message takes a JSON body in Slack's [chat.postMessage](https://docs.slack.dev/reference/methods/chat.postMessage) format: `channel` is the channel's ID, such as `C0123456789` (List Conversations returns them), and `text` is the message. Slack reports failures with `ok` set to `false` and a code in `error`.

## Troubleshooting

> [accordion] Slack doesn't show the consent screen
>
> With your own app, add the redirect URL on OAuth & Permissions. If Slack asks you to request the app, ask a Workspace Owner or app manager to approve it. Then click Authorize again.

> [accordion] not\_in\_channel or channel\_not\_found
>
> Add the app to the channel, and check the `channel` ID.

> [accordion] not\_authed, invalid\_auth, token\_revoked or account\_inactive
>
> With your own app, check ClientID and ClientSecret match its App Credentials. Then click Authorize and Allow again.

> [accordion] missing\_scope
>
> With your own app, check `chat:write` and `channels:read` are under Bot Token Scopes, then click Authorize again.

> [accordion] ratelimited
>
> Slack allows about one message per second per channel. Spread the messages out.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.