

























@@ -514,7 +514,7 @@ Current Slack message actions include `send`, `upload-file`, `download-file`, `r
514514- `allowlist`
515515- `disabled`
516516517-Channel allowlist lives under `channels.slack.channels` and should use stable channel IDs.
517+Channel allowlist lives under `channels.slack.channels` and **must use stable Slack channel IDs** (for example `C12345678`) as config keys.
518518519519Runtime note: if `channels.slack` is completely missing (env-only setup), runtime falls back to `groupPolicy="allowlist"` and logs a warning (even if `channels.defaults.groupPolicy` is set).
520520@@ -524,6 +524,42 @@ Current Slack message actions include `send`, `upload-file`, `download-file`, `r
524524- unresolved channel-name entries are kept as configured but ignored for routing by default
525525- inbound authorization and channel routing are ID-first by default; direct username/slug matching requires `channels.slack.dangerouslyAllowNameMatching: true`
526526527+<Warning>
528+Name-based keys (`#channel-name` or `channel-name`) do **not** match under `groupPolicy: "allowlist"`. The channel lookup is ID-first by default, so a name-based key will never route successfully and all messages in that channel will be silently blocked. This differs from `groupPolicy: "open"`, where the channel key is not required for routing and a name-based key appears to work.
529+530+Always use the Slack channel ID as the key. To find it: right-click the channel in Slack → **Copy link** — the ID (`C...`) appears at the end of the URL.
531+532+Correct:
533+534+```json5
535+{
536+ channels: {
537+ slack: {
538+ groupPolicy: "allowlist",
539+ channels: {
540+ C12345678: { allow: true, requireMention: true },
541+ },
542+ },
543+ },
544+}
545+```
546+547+Incorrect (silently blocked under `groupPolicy: "allowlist"`):
548+549+```json5
550+{
551+ channels: {
552+ slack: {
553+ groupPolicy: "allowlist",
554+ channels: {
555+ "#eng-my-channel": { allow: true, requireMention: true },
556+ },
557+ },
558+ },
559+}
560+```
561+</Warning>
562+527563</Tab>
528564529565<Tab title="Mentions and channel users">
@@ -852,7 +888,7 @@ Primary reference: [Configuration reference - Slack](/gateway/config-channels#sl
852888Check, in order:
853889854890- `groupPolicy`
855-- channel allowlist (`channels.slack.channels`)
891+- channel allowlist (`channels.slack.channels`) — **keys must be channel IDs** (`C12345678`), not names (`#channel-name`). Name-based keys silently fail under `groupPolicy: "allowlist"` because channel routing is ID-first by default. To find an ID: right-click the channel in Slack → **Copy link** — the `C...` value at the end of the URL is the channel ID.
856892- `requireMention`
857893- per-channel `users` allowlist
858894此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。