跳到主要内容

Slack

Slack 接入采用 Socket Mode，需要两种凭据：bot_token（通常以 xoxb- 开头）用于 Web API 和发消息，app_token（xapp-）用于建立 Socket Mode 连接。不要只填写其中一种。

在 Slack 控制台完成准备​

为目标 Workspace 创建 App，启用 Socket Mode，签发有相应权限的 App-level Token，再设置 Bot 的消息事件订阅和读取/发送/文件权限。权限变更后按 Slack 要求重新安装 App；仅改控制台选项不一定更新现有 Token 授权。

在 Anyy 保存账号​

打开 Dashboard 渠道 → 添加 → Slack，默认采用 Socket Mode，填写账号 ID 和两个 Token。默认账号 ID 为 work。也可运行 anyy setup channel 在向导中选择 Slack。

Socket Mode 不要求公网入站 Webhook，但常驻 Gateway 必须能够主动连接 Slack。Token 按当前 Profile 管理。

放行发送者​

私聊默认 pairing，群聊默认 mention。策略通过 CLI 向导修改，当前可选值为：

  • 私聊：pairing、open、allowlist、disabled；
  • 群聊：mention、open、allowlist、disabled。

Dashboard 凭据表单不提供这些策略输入；现有公开设置也没有 Slack 名单条目编辑器。已有名单使用 Slack User/Channel ID，不能靠昵称猜测。首次使用优先完成配对：

anyy channel pairing list --channel slack
anyy channel pairing approve --request REQUEST_ID

批准后发送一条新私聊。访问范围与列表限制见消息平台。

检查 Thread 和文件​

anyy channel reload
anyy channel doctor slack

先测试私聊，再在已安装 Bot 的频道提及它。Slack Thread Timestamp 会保留在路由中，回复进入原 Thread；受支持的入站文件使用 Bot 凭据下载，通过大小限制后暂存。

无法连接时检查 Socket Mode、App Token Scope 和出站网络；有连接但没消息时检查事件订阅与成员关系；不能发消息或取文件时分别检查 Bot 写权限和文件权限。