Skip to main content
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.

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-)
  5. Copy App ID from Basic Information tab in left sidebar

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.
  • App ID: Enter the App ID obtained from your Slack App configuration.
5

Save Configuration

Click Save to complete the Slack account configuration in Siren.
Chat Node is a Beta feature
1

  • Navigate to Providers section in your Siren dashboard.
  • Select Chat channel.
  • Select Slack provider.
  • Open edit modal of the added provider, copy Inbound Webhook Path.
2

Slack App configuration

  • Navigate to Event Subscriptions and enable it.
  • Add the copied Inbound Webhook Path as Request URL.
  • Subscribe to relevant Bot Events, such as:
    • message.channels
    • message.groups
    • message.im
    • message.added
  • Navigate to Interactivity and Shortcuts tab from left sidebar.
  • Add the copied inbound webhook path as Request URL