Agent Skills
返回列表
🤖

Slack Web API curl 实操

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 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 流程的值班负责人,需要搜历史消息并在对应线程里续写记录