Slack
把 Memoh Bot 接到 Slack:收 DM、进频道、跟 thread、读附件、发文件、流式回复。
前提条件
- 一个可以安装 app 的 Slack workspace,并能访问 Slack API 控制台。
- 一个 Memoh Bot;渠道在它的 平台 标签页里配置。
步骤
1. 在 Slack API 控制台创建 app
- 打开 Slack API 控制台,点 Create New App。
- 选择要安装 Bot 的 workspace。
TIP
保持 app 设置页开着,第 2 到 5 步都在这里完成。
2. 在 Slack API 控制台开启 Socket Mode
Memoh 的 Slack 适配走 Socket Mode,所以除 Bot token 外还需要一个 app-level token。
- 在 Basic Information 里开启 Socket Mode。
- 创建 App-Level Token,scope 勾
connections:write。 - 复制生成的 token,以
xapp-开头。
3. 在 Slack API 控制台加 Bot Token Scopes
在 OAuth & Permissions 里加上 Slack 适配需要的 scope:
app_mentions:read:接收频道里对 Bot 的 @channels:history:读公开频道消息groups:history:读私有频道消息im:history:读 DMmpim:history:读多人 DMchat:write:发送回复和 thread 消息files:read:读上传的文件和图片files:write:发出文件reactions:write:添加/移除 reaction
想让会话名称、元数据在 Memoh 里显示得更全,建议再加:
channels:readgroups:readim:readmpim:read
4. 在 Slack API 控制台订阅事件
在 Event Subscriptions 里开启 bot events,加上 Slack 适配处理的入站事件:
app_mentionmessage.channelsmessage.groupsmessage.immessage.mpim
5. 在 Slack API 控制台把 app 装进 workspace
- 在 OAuth & Permissions 点 Install to Workspace。
- 确认权限页并授权。
- 复制 Bot User OAuth Token,以
xoxb-开头。
6. 在 Memoh 添加 Slack 渠道
- 打开 Bot 详情页,进入 平台 标签页。
- 点 Add Channel,选 Slack。
- 填写:
- Bot Token:
xoxb-开头的 token - App-Level Token:
xapp-开头的 token
- Bot Token:
- 点 Save and Enable。
7. 在 Slack 把 Bot 加进对话
渠道启用后,还要让这个 Slack app 出现在你想用它的对话里:
- DM:和该 app 开对话并发一条消息。
- 公开频道:把 Bot 邀请进频道。
- 私有频道:装好后显式邀请进频道。
凭据
| 字段 | 说明 |
|---|---|
| Bot Token | 装进 workspace 后复制的 Bot User OAuth Token(xoxb- 开头)。 |
| App-Level Token | 为 Socket Mode 创建、带 connections:write scope 的 token(xapp- 开头)。 |
两个 token 必须来自同一个 Slack app、同一个 workspace。
验证
把 Bot 邀请进一个频道并 @它发送 /help,或在 DM 里发 /help。Bot 回复命令列表即说明渠道已生效。
群聊
Slack 频道即群聊场景。把 Bot 邀请进公开或私有频道,@它即可对话;回复可以在 thread 里继续,Slack 也是唯一支持 thread 的渠道。
停用与更换凭据
在 Bot 的 平台 标签页可以随时停用或移除该渠道。更换凭据时,更新 Bot Token 与 App-Level Token 字段并保存即可。
常见问题
为什么要填两个 token?
Memoh 的 Slack 适配走 Socket Mode:除 xoxb- 开头的 Bot token 外,还需要 xapp- 开头的 app-level token,且两者必须来自同一个 Slack app 和 workspace。
Bot 能发消息,但读不到上传的图片或文件
检查 files:read scope 是否已开启。
连上了,但收不到任何入站消息
重新核对 Event Subscriptions 里的 bot events,以及配套的 history 类 scope。