Connecting
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 connector 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.What your bot can do
Your bot can post a message to a channel. Ask for what you want:“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.”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.
When it breaks
Slack errors show up in your logs:not_in_channel— the bot hasn’t been invited. Run/invite @paigein 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 — connectors don’t work in scheduled tasks, so a daily Slack summary won’t work today.
