Prerequisite: Ensure you have an existing Slack account. Slack integration

​
Before You Begin

Before proceeding with the Slack integration, you need to configure your Slack App. Follow the steps below to set up your Slack App with the required permissions and features.

​
Slack App Configuration

​
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 Siren Integration)
    • Development Slack Workspace (where the app will be installed)
  5. Click Create App.

​
Step 2: Configure App Features

​
2.1 OAuth & Permissions

  1. Navigate to OAuth & Permissions.
  2. Under Scopes, add the following Bot Token Scopes:
    OAuth ScopeDescription
    app_mentions:readView messages that directly mention your app in conversations that the app is in
    channels:historyView messages and other content in public channels that your app has been added to
    chat:writeSend messages as your app
    files:readView files shared in channels and conversations that your app has been added to
    im:historyView messages and other content in direct messages that your app 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 your app is in
    users:readView people in a workspace
    users:read.emailView email addresses of people in a workspace
  3. Click Save Changes.

​
2.2 Install App to Workspace

  1. In the left sidebar, click OAuth & Permissions
  2. Click Install to Workspace
  3. Authorize the app
  4. Copy the Bot User OAuth Token (starts with xoxb-)

​
2.3 Event Subscriptions (Optional)

To enable real-time updates:
  1. Navigate to Event Subscriptions and enable it
  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)

​
Integration with Siren

​
Step 1: Add Slack Account in Siren

  1. Navigate to Providers: Access the Providers section in your Siren dashboard.
  2. Select Chat Channel: Choose the Chat channel.
  3. Choose Slack: Locate Slack in the list of providers and click on “Add Account”.
  4. Fill in Account Details: A pop-up window will appear. Enter the following:
    • Custom Name: Provide a name for easy identification within Siren’s interface.
    • Slack Bot Token: Enter the Bot User OAuth Token (starts with xoxb-) obtained from your Slack App configuration.
  5. Save Configuration: Click “Save” to save your Slack account configuration.