- Setup
- Reference
What You'll Need
| Credential | Description |
|---|---|
| Bot Token | xoxb- prefixed token |
| Workspace ID | Your Slack workspace identifier |
Overview
Connect Parable to Slack using a custom Slack App with bot permissions for secure workspace data access.Users & Teams
User profiles, team membership, presence
Conversations
Channels, messages, threads
Prerequisites
Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:
- Create the API credentials on your behalf, OR
- Grant you temporary admin access to complete the setup
- Workspace Admin or Owner role
- Permission to install apps to the workspace
Setup Guide
1
Create Slack App
- Go to Slack API Apps
- Click Create New App → From scratch
- Name:
Parable Integration - Select your workspace
- Click Create App
2
Configure Bot Scopes
- Go to OAuth & Permissions in the sidebar
- Scroll to Bot Token Scopes
- Add these scopes:
| Scope | Purpose |
|---|---|
channels:history | Read public channel messages |
channels:read | List public channels |
groups:history | Read private channel messages |
groups:read | List private channels |
im:history | Read DM messages |
im:read | List DMs |
mpim:history | Read group DM messages |
mpim:read | List group DMs |
users:read | Read user profiles |
users:read.email | Read user email addresses |
team:read | Read workspace info |
3
Install to Workspace
- Scroll up to OAuth Tokens for Your Workspace
- Click Install to Workspace
- Review permissions and click Allow
4
Copy Bot Token
After installation, copy the Bot User OAuth TokenIt starts with
xoxb-