SuperAPI AI 工具集

observe-whatsapp

编程与开发

查看项目

更新于 10-15 21:53

技能介绍

用途:面向 Kapso 平台上的 WhatsApp 运维诊断,覆盖日志搜索、消息投递排查、webhook 投递调试、错误分诊、工作流事件关联与健康检查。

主要能力:按标识符或文本搜索日志,日志来源包括 external_api_log、whatsapp_webhook_event、flow_event、webhook_delivery;支持时间范围、来源、结果数量与过滤器(如 flow_execution_id、endpoint_contains、response_status、whatsapp_message_id、webhook_id);可解析号码、列出/查看消息与对话、查看号码健康、查看消息错误、外部 API 日志、webhook 投递尝试,以及探索 OpenAPI。

使用方式:优先使用已安装并认证的 Kapso CLI(kapso login),先执行 kapso status 确认项目访问与可用 WhatsApp 号码。搜索日志示例:kapso logs search --query "<id-or-text>" --period 24h --source all --limit 20 --output json;精确搜索为空时可改用 --period 7d;错误扫描加 --problems-only。消息排查:kapso whatsapp numbers resolve、messages list/get、conversations list。错误分诊与健康检查:kapso whatsapp numbers health --phone-number "<display-number>" --output human。备选路径为环境变量 KAPSO_API_BASE_URL(仅主机,不含 /platform/v1)与 KAPSO_API_KEY,通过 scripts/ 下脚本运行,例如 node scripts/log-search.js,并可用 --catalog true 查看来源与过滤选项;首次需 npm i。

适用场景:需要跨消息、工作流、API 调用与 webhook 投递关联时间线时。

限制:备选路径依赖 Logs 与 Elasticsearch 启用,且仅返回该 API-key 项目已索引日志;webhook 的创建/更新/删除、签名校验与事件类型应使用 integrate-whatsapp,项目事件定义与工作流设置应使用 automate-whatsapp;深度调试前建议先把展示号码解析为规范 phone_number_id。