Skip to content
Sonora Docs Sonora Docs

Slack

Sonora connects to Slack to sync messages from your workspace channels, providing insights from team and customer conversations.

Prerequisites

Section titled “Prerequisites”
  • Slack workspace admin access
  • Ability to install apps to your workspace

Setup Steps

Section titled “Setup Steps”

1. Create a Slack App

Section titled “1. Create a Slack App”
  1. Go to api.slack.com/apps
  2. Click Create New App
  3. Choose From scratch
  4. Enter app name (e.g., “Sonora Integration”)
  5. Select your workspace
  6. Click Create App

2. Configure Bot Token Scopes

Section titled “2. Configure Bot Token Scopes”
  1. In your app settings, go to OAuth & Permissions
  2. Under Bot Token Scopes, add these scopes:
    • channels:history - View messages in public channels
    • channels:read - View basic channel info
    • groups:history - View messages in private channels (optional)
    • groups:read - View basic private channel info (optional)
    • users:read - View users in the workspace
    • users:read.email - View user email addresses

3. Install App to Workspace

Section titled “3. Install App to Workspace”
  1. Go to OAuth & Permissions
  2. Click Install to Workspace
  3. Review the permissions and click Allow
  4. Copy the Bot User OAuth Token (starts with xoxb-)

4. Invite Bot to Channels

Section titled “4. Invite Bot to Channels”

For each channel you want Sonora to read:

  1. Open the channel in Slack
  2. Type /invite @YourAppName
  3. Or click the channel name → Integrations → Add apps

5. Connect in Sonora

Section titled “5. Connect in Sonora”
  1. Go to Settings → Integrations in Sonora
  2. Click Add Integration → Slack
  3. Enter your credentials:
    • Bot User OAuth Token
  4. Click Connect

Data Synced

Section titled “Data Synced”

Sonora syncs the following from Slack:

  • Messages from invited channels
  • Thread replies
  • User information
  • Channel metadata

Required Scopes Reference

Section titled “Required Scopes Reference”
ScopePurpose
channels:historyRead messages from public channels
channels:readList public channels
groups:historyRead messages from private channels
groups:readList private channels
users:readGet user information
users:read.emailGet user email addresses

Troubleshooting

Section titled “Troubleshooting”

Bot Not Seeing Messages

Section titled “Bot Not Seeing Messages”
  • Ensure the bot has been invited to the channel
  • Verify the bot token has the required scopes
  • Check that the channel isn’t archived

Authentication Errors

Section titled “Authentication Errors”
  • Verify the Bot User OAuth Token is correct
  • Ensure the app is still installed to your workspace
  • Check that required scopes haven’t been removed

Missing Users

Section titled “Missing Users”
  • Ensure users:read scope is added
  • For email addresses, verify users:read.email scope is added