观察 WhatsApp

使用时机

将本技能用于运维诊断：消息投递调查、Webhook 投递调试、错误分类，以及 WhatsApp 健康检查。

环境准备

环境变量：

• KAPSO_API_BASE_URL（仅主机地址，不含 /platform/v1）
• KAPSO_API_KEY

操作方式

调查消息投递

1. 列出消息：node scripts/messages.js --phone-number-id
2. 查看消息：node scripts/message-details.js --message-id
3. 查找会话：node scripts/lookup-conversation.js --phone-number

错误分类

1. 消息错误：node scripts/errors.js
2. API 日志：node scripts/api-logs.js
3. Webhook 投递：node scripts/webhook-deliveries.js

运行健康检查

1. 项目概览：node scripts/overview.js
2. 号码健康：node scripts/whatsapp-health.js --phone-number-id

脚本

消息

错误与日志

健康

OpenAPI

安装依赖（一次）：

npm i

示例：

node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery

备注

• 关于 Webhook 配置（创建/更新/删除、签名校验、事件类型），请使用 integrate-whatsapp。

参考

• references/message-debugging-reference.md - 消息调试指南
• references/triage-reference.md - 错误分类指南
• references/health-reference.md - 健康检查指南

相关技能

• integrate-whatsapp - 接入、Webhook、消息、模板、流程
• automate-whatsapp - 工作流、智能体与自动化

[observe-whatsapp file map]|root: .
|.:{package.json,SKILL.md}
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|scripts:{api-logs.js,errors.js,lookup-conversation.js,message-details.js,messages.js,openapi-explore.mjs,overview.js,webhook-deliveries.js,whatsapp-health.js}
|scripts/lib/messages:{args.js,kapso-api.js}
|scripts/lib/status:{args.js,kapso-api.js}
|scripts/lib/triage:{args.js,kapso-api.js}