Slack setup

Create a Slack App, install it into your workspace, and connect it to PR Tracker.

1. Create the app

Go to https://api.slack.com/apps and click "Create New App" → "From scratch".
Pick a name like PR Tracker and the workspace you want.

2. Configure Event Subscriptions

Toggle Enable Events ON.
Request URL: https://<your-domain>/api/slack/events

Under Subscribe to bot events, add:

message.channels message.groups message.im message.mpim

3. OAuth & Permissions — Bot Token Scopes

Read-only. PR Tracker never posts, replies, reacts, or modifies anything in Slack. Do not add chat:write.

channels:history channels:read groups:history groups:read im:history im:read mpim:history mpim:read users:read team:read

The *:read scopes let the bot list channels it has been invited to — needed for the "Sync now" backfill feature. They're still read-only.

4. Install to workspace

Click Install to Workspace, approve the scopes. Copy the Bot User OAuth Token (starts with xoxb-) from the OAuth & Permissions page.

5. Copy the Signing Secret

From Basic Information → App Credentials, copy Signing Secret.

6. Connect in PR Tracker

Open your workspace → Settings → Slack integration and paste both values. The form runs auth.test to verify, then saves them encrypted with AES-256-GCM.

7. Invite the bot

In each channel you want monitored, run /invite @PR Tracker (or whatever you named the bot). The bot doesn't need to post — it just listens.

OAuth (alternative)

If you set SLACK_CLIENT_ID, SLACK_CLIENT_SECRET, and SLACK_GLOBAL_SIGNING_SECRET on the server, the Settings page shows an "Install via Slack" button that handles all of the above automatically.