Skip to main content

​
Overview

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.

​
Create The Slack App

Create a Slack app for the workspace you want Mistle to access.

​
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
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 In Mistle

Open Integrations in the dashboard, choose Slack, then select Bot token. Enter:
FieldValue
botTokenSlack bot token
signingSecretSlack signing secret

​
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.

​
Private Channels

If you want Mistle to sync or trigger from private channels, invite the app to those channels in Slack. Private-channel sync and app_mention behavior only work where the app is actually a member.

​
Slack App Manifest

Use this manifest as a starting point for the setup above: 
display_information:
  name: Mistle Slack App
  description: Slack integration for Mistle automations and channel sync
  background_color: "#611f69"

features:
  bot_user:
    display_name: Mistle
    always_online: false

oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - channels:read
      - groups:read

settings:
  event_subscriptions:
    request_url: https://YOUR-MISTLE-CALLBACK-URL
    bot_events:
      - app_mention
      - channel_created
      - channel_archive
      - channel_unarchive
      - channel_rename
      - group_archive
      - group_unarchive
      - group_rename
  interactivity:
    is_enabled: false
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
Replace request_url with the webhook callback URL shown in the Slack connection’s Webhooks section in Mistle. If you do not have that URL yet, create the app first and update the Events API request URL after creating the connection.

​
Official References