Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mistle.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
  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.
Mistle Slack App setup page with Create from manifest selected, token input, and editable Slack app manifest
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 automations 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:
ScopeEnables
app_mentions:readReceive app_mention events for Slack-triggered automations
channels:readSync public channels as selectable automation resources
files:readRead and download files shared with the app
files:writeUpload files as the app
groups:readSync private channels as selectable automation resources

​
Configure Event Subscriptions

Enable the Slack Events API and subscribe the bot to these events:
EventEnables
app_mentionSlack automation trigger
channel_createdRefresh synced public channels when created
channel_archiveRefresh synced public channels when archived
channel_unarchiveRefresh synced public channels when restored
channel_renameRefresh synced public channels when renamed
group_archiveRefresh synced private channels when archived
group_unarchiveRefresh synced private channels when restored
group_renameRefresh synced private channels when renamed

​
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:
FieldValue
Bot tokenSlack bot token
Signing secretSlack signing secret
Client ID (Linked User Auth)Slack app client ID
Client secret (Linked User Auth)Slack app client secret
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-triggered automations:
  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.
Slack app connection detail page showing authentication, synced channel resources, and webhook callback URL

​
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