Slack
本文介绍如何创建 Slack 应用，通过 Events API 将频道中 @Bot 的消息或私信发送到腾讯云 EdgeOne Makers，由 Agent 处理后返回原频道或私信会话。
前提条件和适用范围
1. 已有 Slack 账号和测试工作区，并有创建、安装应用的权限。组织限制应用安装时，需由管理员批准。
2. 已开通 Makers。
3. Makers 部署域名可被 Slack 公网访问，服务可访问 Slack API 和模型服务。
4. 本文验证工作区内的文本私信和频道提及；每轮频道提问都需 @Bot。
创建应用
1. 登录 Slack 应用管理页面，单击 Create New App。
2. 选择 Blank app，单击 Continue，在 App Name 中输入应用名称，例如
Makers Assistant。3. 在 Workspace 中选择测试工作区，单击 Create。
4. 进入 Basic Information > App Credentials，显示并复制 Signing Secret。
配置最小权限并安装应用
1. 进入 OAuth & Permissions > Scopes > Bot Token Scopes。
2. 单击 Add an OAuth Scope，按下表添加权限。
Scope | 用途 | 配置要求 |
chat:write | 发送占位消息并更新为 Agent 回复。 | 必需。 |
app_mentions:read | 接收频道中 @Bot 的事件。 | 测试频道提及时必需。 |
im:history | 接收用户与 Bot 的私信事件。 | 测试私信时必需。 |
users:read | Adapter 获取用户显示名称等资料。 | 可选；不需要用户资料时可不添加。 |
3. 在 OAuth & Permissions 中单击 Install to Workspace，核对工作区和权限，完成授权。
4. 复制 Bot User OAuth Token，其前缀为
xoxb-。5. 如需测试私信，进入 App Home，在 Show Tabs 中启用 Messages Tab，允许用户从该页签向应用发送消息。参见 App Home。
部署 Makers 模板
1. 打开 Makers Agent for IM 模板。
2. 在项目环境变量设置中填写以下变量（负责一份.env.example 为.env）。
环境变量 | 是否必填 | 填写说明 |
SLACK_BOT_TOKEN | 是 | Bot User OAuth Token |
SLACK_SIGNING_SECRET | 是 | Signing Secret |
3. 保存配置并部署
4. 复制生产环境 HTTPS 域名，在末尾添加 /slack
5. 注意服务应该部署在全球可用区，slack 服务才能正确访问。
配置事件订阅
1. 返回 Slack 应用管理页面，进入 Event Subscriptions，打开 Enable Events。
2. 在 Request URL 中输入步骤3的地址。
3. 等待地址旁显示 Verified。模板会返回 Slack 发来的
challenge。4. 在 Subscribe to bot events 中单击 Add Bot User Event，添加下表事件。
事件 | 接收内容 | 对应 Scope |
app_mention | 频道内用户 @Bot 的消息。 | app_mentions:read |
message.im | 用户向 Bot 发送的私信。 | im:history |
5. 单击 Save Changes。若提示权限变更，返回 OAuth & Permissions 重新安装授权。
6. 在 Slack 客户端打开测试频道，输入
/invite 并选择应用，将 Bot 邀请入频道。私有频道必须由有权限的成员邀请。
发送消息并验证
1. 在 Bot 已加入的频道中输入
@，从候选列表选择 Bot，发送 请用一句话介绍腾讯云 EdgeOne Makers。。2. 确认频道出现
Thinking…，随后同一条消息更新为 Agent 的最终回复。3. 再次 @Bot，发送
请把上一条回答缩短为十个字以内。，确认收到第二轮回复。
