Skip to content
Ptah Documentation

Slack Setup

Slack Setup

Section titled “Slack Setup”

The Slack adapter (BoltSlackAdapter) uses @slack/bolt in Socket Mode — no public webhook URL required.

1. Create a Slack app

Section titled “1. Create a Slack app”
  1. Go to api.slack.com/apps → Create New App → From scratch
  2. Name it and pick the workspace

2. Add bot scopes

Section titled “2. Add bot scopes”

Under OAuth & Permissions → Bot Token Scopes, add:

  • chat:write
  • app_mentions:read
  • channels:history
  • im:history
  • files:read

3. Enable Socket Mode

Section titled “3. Enable Socket Mode”
  1. Sidebar → Socket Mode → toggle Enable
  2. When prompted, generate an App-Level Token with the connections:write scope. Save the xapp-… token

4. Install to workspace

Section titled “4. Install to workspace”

OAuth & Permissions → Install to Workspace. After install, copy the Bot User OAuth Token (xoxb-…).

5. Find your team ID

Section titled “5. Find your team ID”

The workspace ID looks like T0XXXXXXX. You can grab it from slack.com/account/team in the URL.

6. Configure Ptah

Section titled “6. Configure Ptah”

Open Settings → Messaging → Slack:

  1. Paste both tokens (xoxb-… and xapp-…) — the UI encrypts before persisting
  2. Add the team ID to Allowed team IDs (gateway.slack.allowedTeamIds)
  3. Enable Slack (gateway.slack.enabled = true)
  4. Enable the global Messaging Gateway (gateway.enabled = true)

7. Pair the binding

Section titled “7. Pair the binding”
  1. In any allowed workspace, DM the app or @-mention it in a channel
  2. It replies with a 6-digit pairing code
  3. Approve the binding in Settings → Messaging → Bindings