observe-whatsapp

Observe WhatsApp - WhatsApp 监控与调试工具

技能概述

Observe WhatsApp 是 Kapso 平台提供的 WhatsApp 专用诊断工具，帮助开发者快速定位消息投递问题、检查 webhook 状态、分析 API 错误并执行系统健康检查。

适用场景

生产问题紧急排查：当 WhatsApp 消息发送失败或投递延迟时，快速追踪消息链路、定位故障点，减少业务影响时间。

Webhook 集成调试：在配置或修改 webhook 后，验证投递状态、检查重试记录、排查签名验证失败等问题。

日常运维监控：定期执行健康检查，监控 WhatsApp API 调用状态、错误趋势和系统运行指标，提前发现潜在问题。

核心功能

消息投递追踪

- 列出指定手机号 ID 的所有消息记录
- 查看单条消息的详细状态和传递链路
- 通过手机号或会话 ID 快速定位相关对话

错误诊断与分析

- 统计和分析消息发送错误
- 查看 WhatsApp API 的外部调用日志
- 检查 webhook 投递记录和重试历史

系统健康检查

- 获取项目整体运行概览
- 检查特定手机号的健康状态
- 通过 OpenAPI 接口深度探索平台能力

常见问题

WhatsApp 消息发送失败怎么排查原因？

使用 Observe WhatsApp 可以快速定位问题。首先运行 errors.js 查看消息错误列表，然后使用 message-details.js 获取失败消息的详细信息，包括错误码、错误描述和失败时间点。如果需要进一步分析，可以执行 api-logs.js 查看 API 调用日志，定位是否是网络问题、API 限流或参数错误。

如何检查 WhatsApp webhook 是否正常投递？

使用 webhook-deliveries.js 脚本可以查看所有 webhook 投递记录，包括投递状态、响应码、重试次数和投递时间。如果发现投递失败，可以结合 api-logs.js 分析具体原因。注意：webhook 的创建、更新和签名验证配置需要使用 integrate-whatsapp 技能。

Observe WhatsApp 和其他 WhatsApp 监控工具有什么区别？

Observe WhatsApp 专为 Kapso 平台设计，深度集成了平台的消息追踪、错误分类和健康检查能力。与 WhatsApp Business API 官方后台相比，它提供了更细粒度的诊断信息和脚本化操作，适合开发者集成到自动化运维流程中。同时，它与 Kapso 的 integrate-whatsapp（集成）和 automate-whatsapp（自动化）技能形成完整的 WhatsApp 工具链。