Skip to content

Commit cc8f9d3

Browse files
committed
docs(webhooks): require channels:history for Slack message events
The channels setup listed only chat:write, which posts replies but does not grant read access to message.channels events. Add channels:history to the app scopes and note that adding scopes after install requires a reinstall.
1 parent a259068 commit cc8f9d3

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

docs/webhooks/channels.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ The `run()` loop is unchanged: the agent does not know or care that it is talkin
2727

2828
<Steps>
2929
<Step title="Create a Slack app">
30-
Create an app at [api.slack.com/apps](https://api.slack.com/apps). Add the `chat:write` bot scope and install it to your workspace to get a bot token (`xoxb-...`).
30+
Create an app at [api.slack.com/apps](https://api.slack.com/apps). Add the `chat:write` and `channels:history` bot scopes (`chat:write` posts replies; `channels:history` receives the `message.channels` events), then install it to your workspace to get a bot token (`xoxb-...`). If you add scopes after installing, reinstall the app to apply them.
3131
</Step>
3232
<Step title="Deploy the agent + connect the endpoint">
3333
Deploying registers a hosted [endpoint](/webhooks/connect) for the channel. Set its signing secret to your Slack app's **Signing Secret**, and pass the bot token as `token`.

0 commit comments

Comments
 (0)