Overview

Connect Projan to your Slack workspace to enable PRD creation directly in Slack channels. Mention @Projan to start conversations, collaborate with your team in real-time, and export documents to Slack canvases - all without leaving your workflow.

Prerequisites

• Slack workspace (Free, Pro, Business+, or Enterprise Grid)
• Team admin account in Projan
• Permission to install apps in your Slack workspace

Setup Steps

1. Go to Settings > Integrations > Slack
2. Click “Connect Slack”
3. Select your workspace from the dropdown
4. Review and approve the requested permissions
5. Choose a default channel for Projan notifications (optional)

Permissions Requested

Scope	Purpose	Access Level
channels:read	List available channels	Read
channels:manage	Create channels for PRD discussions	Write
channels:history	Read conversation context	Read
chat:write	Send messages and responses	Write
canvases:read	Read existing canvases	Read
canvases:write	Create and update PRD canvases	Write
users:read	Identify team members	Read
users:read.email	Match Slack users to Projan accounts	Read
team:read	Detect workspace plan tier	Read
app_mentions:read	Respond when mentioned	Read
commands	Handle slash commands	Read
files:read	Access shared files for context	Read
files:write	Upload generated documents	Write
reactions:read	Track engagement with responses	Read

What Data is Accessed

• Channel names and IDs
• Message content in threads where Projan is mentioned
• User display names and emails
• Workspace name and plan tier

Data Storage

• Encrypted bot token
• Workspace ID and name
• Installer user ID

Message content is processed in real-time and stored as Projan conversations - not separately cached.

Disconnecting

Go to Settings > Integrations > Slack > Disconnect.

This immediately revokes the bot token and removes all stored credentials. Existing Projan conversations created via Slack are retained but will no longer sync with Slack.

Troubleshooting

Bot not responding

• Ensure Projan has been invited to the channel (/invite @Projan)
• Check that the channel is not archived or restricted

Messages not appearing

• Verify the app_mentions:read scope was granted
• Confirm the bot is not muted in the channel

Canvas errors

• Canvas features require Slack Business+ or Enterprise Grid
• Free and Pro plans do not support the Canvases API

“Missing scope” error

• Disconnect and reconnect to re-authorize with updated permissions