​
Slack App Configuration

Before integrating Slack with Siren, you’ll need to set up your Slack App correctly. Follow the steps below to configure the necessary settings.

​
Step 1: Create the Slack App

  1. Go to the Slack API: Your Apps Dashboard.
  2. Click “Create New App”.
  3. Choose “From scratch”.
  4. Enter:
    • App Name (e.g., My Slack Bot)
    • Development Slack Workspace (where the app will be installed)
  5. Click Create App.

​
Step 2: Configure App Features

Depending on your use case, you may enable one or more of the following features:

​
2.1 OAuth & Permissions

  1. Navigate to OAuth & Permissions.

  2. Under Scopes, add the relevant permissions:

    • Bot Token Scopes; See the table below.
    OAuth ScopeDescription
    app_mentions:readView messages that directly mention @siren-test in conversations that the app is in
    channels:historyView messages and other content in public channels that siren-test has been added to
    chat:writeSend messages as @siren-test
    files:readView files shared in channels and conversations that siren-test has been added to
    im:historyView messages and other content in direct messages that siren-test has been added to
    im:writeStart direct messages with people
    incoming-webhookPost messages to specific channels in Slack
    mpim:writeStart group direct messages with people
    reactions:readView emoji reactions and their associated content in channels and conversations siren-test is in
    users:readView people in a workspace
    users:read.emailView email addresses of people in a workspace
    • User Token Scopes (if needed)

  3. Save your changes.

​
2.2 Event Subscriptions (Optional)

  1. Navigate to Event Subscriptions and enable itto receive real-time updates.
  2. Add your Request URL (this should point to your server endpoint that handles Slack events).
  3. Subscribe to relevant Bot Events, such as:
    • message.channels
    • message.groups
    • reaction_added
    • (Add others as needed for your app functionality)

​
2.3 Interactivity & Shortcuts (Optional)

  1. Enable Interactivity.
  2. Set your Request URL for handling interactive components like button clicks, menus, etc.

Once your Slack App is set up and configured, head over to the Slack Integration section to complete the integration within Siren.