ProductReadyProductReady
Chat Channels

Slack

Connect a Slack bot to create Agent Tasks from workspace messages.

Slack

Create a Slack App, install it to your workspace, and app mentions become Agent Tasks.

📖 Official docs: Slack API Quickstart

Create a Slack App

  1. Go to api.slack.com/appsCreate New AppFrom scratch
  2. Name your app and select a workspace

Configure Permissions

Navigate to OAuth & PermissionsBot Token Scopes, add:

  • chat:write — send messages
  • app_mentions:read — receive mentions

Then enable Event Subscriptions and subscribe to app_mention events.

Install & Get Token

Click Install to Workspace → authorize. Copy the Bot User OAuth Token (xoxb-...).

Connect in ProductReady

Go to User Settings → Chat Channels → [+ Add] → Slack, paste the token, and select a default space.

await trpc.channels.connect.mutate({
  provider: "slack",
  credentials: { botToken: "xoxb-..." },
  defaultSpaceId: "space_abc123",
});

Notes

  • The bot responds to @YourApp mentions in channels and DMs
  • Invite the bot to channels where you want it to listen (/invite @YourApp)
  • Slack uses signing secrets for webhook verification

On this page