Slack Setup

Connect Slack to chat with the AI agent in direct messages and receive reports in any channel.

Create a Slack App

1. Go to api.slack.com/apps and click "Create New App"
2. Choose "From scratch" and name your app (e.g. "SEO Dash")
3. Under OAuth & Permissions, add these bot token scopes:

- chat:write - Send messages

- app_mentions:read - Detect when the bot is mentioned

- im:history - Read DM history

- im:read - Access DM channels

1. Install the app to your workspace
2. Copy the Bot Token (starts with xoxb-)
3. Under Basic Information, copy the Signing Secret

Configuration

1. Go to Settings > Messaging Platforms
2. Expand Slack and enter the Bot Token and Signing Secret
3. Save

Event Subscriptions

1. In your Slack App settings, go to Event Subscriptions and toggle it on
2. Set the Request URL to: https://your-domain.com/api/slack
3. Slack will send a verification challenge. SEO Dash handles this automatically.
4. Under "Subscribe to bot events", add: message.im
5. Save

Message Formatting

Messages are converted to Slack mrkdwn format with bold text, links, and code blocks.

Security

Slack messages are verified using HMAC-SHA256 signature verification. The signing secret ensures that only messages from Slack's servers are processed. Replay attacks are prevented by checking the request timestamp (must be within 5 minutes).