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 with the required permissions and features.

​
Slack App Configuration

​
Create and Configure Your Slack App

1

Create a New Slack App

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

Configure OAuth & Permissions

  1. In the left sidebar, click 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.
3

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-)
4

Configure 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

​
Add Slack Account to Siren

1

Navigate to Providers

Go to the Providers section in your Siren dashboard.
2

Select Chat Channel

Choose the Chat channel from the available options.
3

Choose Slack

Locate Slack in the list of providers and click on Add Account.
4

Fill in Account Details

In the pop-up window, enter the following details:
  • 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 complete the Slack account configuration in Siren.