Skip to main content
The Slack integration gives your bot a voice in your team’s workspace. The obvious use is handover — a customer asks for a person, and someone actually finds out. But it’s equally good for a heads-up when a big order lands, or when your bot hits something it can’t handle. Connect it from Tools → Connectors.

​
What it does

Your bot can post a message to a channel. That’s the whole surface — posting. Your bot can’t read Slack messages, reply in threads on its own, or react to what your team says there. Slack is where your bot tells you things, not a second place it holds conversations.

​
How to authenticate

1

Sign in with Slack

Click Connect with Slack. A popup asks you to pick your workspace and approve. Alternatively, Or enter an access token manually takes a Bot User OAuth Token (xoxb-...) from your own Slack app.
2

Pick a default channel

After signing in, choose a channel from the Default channel dropdown on the card. Your bot posts here unless its code names a different channel.This step is easy to skip and the integration doesn’t work without it — signing in doesn’t pick a channel for you.
3

Invite the bot to the channel

In Slack, run /invite @paige in the channel you chose. Slack won’t let a bot post somewhere it hasn’t been invited.
The dropdown lists your public channels. If you need your bot to post in a private channel, connect with a token instead — a Slack app token carrying the groups:read permission can see private channels the bot has been invited to.

​
How to prompt the coding agent to use it

Ask for what you want and the agent writes it:
“When someone asks to speak to a person, post their name and question to Slack.”
“Post to Slack whenever a booking over R5000 comes in.”
Pair this with handover. Have your bot post to Slack and flag the conversation for handover in the same breath — your team gets the ping and the conversation is already waiting for them in Paige.

​
When it breaks

Slack errors show up in your logs:
  • not_in_channel — the bot hasn’t been invited. Run /invite @paige in that channel.
  • channel_not_found — the channel was renamed, archived, or is private and the bot can’t see it.
  • No default channel set — you connected but never picked one from the dropdown.
  • It’s running on a schedule — integrations don’t work in scheduled tasks, so a daily Slack summary won’t work today.