Slack

​

Overview

Slack can be connected in two ways:

1. Slack app
   • Create from manifest (recommended): Mistle creates and configures the Slack app via a manifest
   • Use an existing app: connect a Slack app you already created in Slack
2. Bot token
   • Use this when the connection only needs Slack app credentials and you do not want Mistle to create the app from a manifest

​

Option 1: Connect With A Slack App

Set up a Slack app, configure the required bot scopes and event subscriptions, install it to your workspace, then connect it to Mistle with the bot token and signing secret. Choose one of these setup paths:

1. Create from manifest (recommended): Mistle creates and configures the Slack app via a manifest.
2. Use an existing app: connect a Slack app you already created in Slack.

​

Option 1A: Create From Manifest (Recommended)

1. Open Integrations in the dashboard and choose Slack.
2. Select Slack app.
3. Choose Create from manifest.
4. Generate a Slack app configuration token in Slack and paste it into Mistle.
5. Review and edit the manifest before creating the app.
6. Submit the manifest to Slack.
7. Approve the Slack app installation in your workspace.
8. Return to Mistle to complete the connection.

You can edit the manifest before creating the app. Mistle will use your manifest values for app settings such as the app name, description, and other Slack app configuration that does not need to be managed by Mistle. To keep the integration working, Mistle always overrides the Slack app webhook and callback settings before submitting the manifest. Mistle sets the Events API request URL to the Mistle callback URL for that connection, adds the required redirect URLs for Slack app installation and Slack identity linking, and adds the required bot scopes and bot events needed for supported Slack triggers and resource sync.

​

Option 1B: Use An Existing Slack App

If you already created a Slack app, you can connect it directly in Mistle.

​

Configure Bot Scopes

Add these bot scopes before installing the app:

​

Configure Event Subscriptions

Enable the Slack Events API and subscribe the bot to these events:

​

Install The App And Collect Credentials

Install the Slack app to the workspace, then collect:

1. The bot token (xoxb-...)
2. The signing secret from the app’s Basic Information page

​

Connect The Existing App In Mistle

Open Integrations in the dashboard, choose Slack, then select Slack app. Enter: The linked-user auth fields are required when this connection will be used for Identity Linking. Standard Slack bot usage does not require them.

​

Webhooks

If you use Slack triggers:

1. Open the connection’s Webhooks section in Mistle.
2. Copy the displayed callback URL.
3. Paste it into the Slack app’s Events API Request URL field.
4. Save and verify the request URL in Slack.

​

Private Channels

If you want Mistle to sync or trigger from private channels, invite the Slack app to each private channel you want to use. Slack only delivers private-channel messages and events to apps that are members of that channel. If the app is not a member, Mistle cannot see activity in the channel, sync it as a selectable resource, or respond to app_mention events there.

​

Official References

• Slack app manifest
• Creating an app from app settings
• Using HTTP Request URLs
• app_mention event
• team_join event
• user_change event
• subteam_created event
• subteam_updated event
• conversations.list
• users.list
• usergroups.list