Agent Skills
返回列表
🔒

WhatsApp 运维观测

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-02qudk26/observe-whatsapp。

技能介绍

要解决什么问题

WhatsApp Business 经 Kapso 等平台接入后，线上问题往往落在三类：消息是否真的发出/送达、Webhook 回调是否成功、平台侧 API 与号码状态是否正常。单靠控制台截图很难串起 message id、会话、投递尝试与 API 日志之间的关联，排障容易变成反复猜。

本技能把常见观测动作收成一组 Node 脚本，在配置 KAPSO_API_BASE_URL（仅主机，不含 /platform/v1）与 KAPSO_API_KEY 后，可直接对 Kapso 侧数据做查询与分类。

技能如何工作

消息与投递调查

  • messages.js：按 --phone-number-id 列出消息
  • message-details.js：用 --message-id 看单条详情
  • lookup-conversation.js：按 --phone-number 或 ID 定位会话

错误与日志

  • errors.js：汇总消息错误
  • api-logs.js：查外部 API 调用日志
  • webhook-deliveries.js：列出 Webhook 投递尝试，便于对照回调失败

健康检查

  • overview.js：项目概览
  • whatsapp-health.js：对指定 --phone-number-id 做号码健康检查

另有 openapi-explore.mjs 可浏览 OpenAPI（search / op / schema / where）。技能内 references/ 下有消息调试、错误分类、健康检查等参考文档，可按场景对照执行。

适用边界

  • 定位是 observe（观测/诊断），不负责创建 Webhook、签名校验或事件订阅；这类 integrate-whatsapp 更合适。
  • 自动化工作流与智能体编排见 automate-whatsapp。
  • 脚本依赖 Kapso API 与上述环境变量；权限或 key 不足时，列表/详情可能为空或报错，需先确认集成侧配置。

使用场景

  • 用户反馈某条 WhatsApp 未收到，需按 phone-number-id 拉消息列表并用 message-id 核对投递状态
  • 线上回调异常，需对照 webhook-deliveries 与 api-logs 判断是平台未投递还是业务端处理失败
  • 批量发送后出现失败码，需跑 errors.js 做错误分类并关联 message-details 定位会话
  • 发版或故障复盘前，对指定号码执行 whatsapp-health 与 overview 确认 Kapso 侧健康状态

适合人员

  • 负责 Kapso/WhatsApp 集成的后端，需在告警后快速查消息与 Webhook 投递记录
  • 值班 SRE 或平台运维，处理「消息发不出/回调不到」类工单并需要可脚本化的查询步骤
  • 接入 WhatsApp 的业务团队在上线前要做号码与项目健康检查，避免带着配置问题放量
  • 客服或技术支持升级来的投递投诉，需用 lookup-conversation 按手机号还原会话上下文