Slack Web API curl 实操
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-slack。
技能介绍
背景:为什么没有「日常可用的 Slack CLI」
许多团队希望用脚本或 AI Agent 直接操作 Slack,但官方并没有面向日常集成的 CLI。本技能的做法很直接:用 curl 发 HTTP 请求、jq 解析 JSON,全部走 Slack Web API。鉴权依赖环境变量 $SLACK_TOKEN(OAuth Bearer),每次请求都要带 Authorization: Bearer $SLACK_TOKEN。
一个重要细节:Slack 总是返回 HTTP 200,成败要看响应体里的 ok 字段。失败时是 {"ok": false, "error": "..."},应把 error 原样反馈给用户,而不是只看状态码。
核心流程与能力
每次动手前先跑 auth.test:既验证连接,又能拿到当前 bot 的 user_id 和 team 信息,后续不少接口都依赖它。
技能把常见操作整理成可复用「配方」:
- 频道名 → 频道 ID:公开频道、私信、私密群 ID 分别以
C/D/G开头,不要臆造 ID,用conversations.list或users.lookupByEmail查询。 - 发消息 / 线程回复:
chat.postMessage;线程回复需带上thread_ts。 - 搜消息:按关键词检索历史消息。
- 按邮箱发 DM:先解析用户再发私信。
- 上传文件:两步——先申请 upload URL,再完成上传。
向公开频道发帖时,bot 必须是该频道成员;若返回 not_in_channel,先用 conversations.join(同样需要 channel id)再加入并重试。私密频道和 DM 通常需要人工邀请 bot,应明确让用户处理。
边界与运维注意
not_authed/invalid_auth:引导用户在auth.acedata.cloud/user/connections重新授权。- Slack 限流很猛:遇到
429时读响应头里的Retry-After,休眠后重试,不要无脑并发。
本技能描述的是 API 调用契约与排错路径,不是 Slack App 后台配置教程;OAuth scope、Event Subscriptions 等仍需在 Slack 侧按业务自行开通。
使用场景
- CI 跑完后要把构建号与日志链接发到 `#release` 频道,需要先查 channel id 再 `chat.postMessage`
- 值班 Agent 在告警线程里追加处理进展,需用 `thread_ts` 对原消息做线程回复
- 按 on-call 工程师的工作邮箱解析用户 ID,向其 Slack 私信发送割接通知
- 排障结束后把压缩日志上传到指定频道,走创建 upload URL 再完成上传的两步流程
适合人员
- 负责把发布状态写入团队 Slack 频道的 SRE,需要 bot 能加入公开频道并可靠发帖
- 维护 AceData OAuth 连接的集成工程师,要在 Agent 里统一处理 `auth.test` 与 `invalid_auth` 重授权
- 编写内部 Support Bot 的后端开发,要在线程中回复用户并偶尔上传附件到工单频道
- 用 AI 编排 Incident 流程的值班负责人,需要搜历史消息并在对应线程里续写记录