Slack

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

Prerequisites

• Slack workspace admin access
• Ability to install apps to your workspace

Setup Steps

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

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

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

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

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

Sonora syncs the following from Slack:

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

Required Scopes Reference

Scope	Purpose
channels:history	Read messages from public channels
channels:read	List public channels
groups:history	Read messages from private channels
groups:read	List private channels
users:read	Get user information
users:read.email	Get user email addresses

Troubleshooting

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

• 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

• Ensure users:read scope is added
• For email addresses, verify users:read.email scope is added