observe-whatsapp
调试 WhatsApp 消息投递和 webhook 问题
高效排查 WhatsApp 生产环境问题。此技能提供用于检查消息投递、调试 webhook 故障以及对 Kapso 平台运行健康检查的命令。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“observe-whatsapp”。 检查电话号码 +1234567890 的消息投递
预期结果:
Found 3 messages for +1234567890. Message ID msg_abc123: delivered at 2024-01-15 10:30:00. Message ID msg_def456: pending (webhook not acknowledged). Message ID msg_ghi789: failed - recipient opted out.
正在使用“observe-whatsapp”。 显示过去一小时的 webhook 投递状态
预期结果:
Webhook deliveries summary: 45 successful, 3 failed. Failed deliveries: 503 Service Unavailable from webhook endpoint at 10:15, 10:22, 10:45. Retry count: 3/3. Recommend checking webhook server health.
安全审计
安全This skill is documentation-only (SKILL.md). Static analyzer flagged markdown code blocks as shell commands, but all 28 external_commands findings are false positives from code formatting. Network and env_access findings reference YAML frontmatter URLs and documented environment variable requirements, not actual code execution. No executable code exists in this skill.
质量评分
你能构建什么
生产事件响应
快速调查在活动事件期间 WhatsApp 消息未被投递到客户的原因。
Webhook 调试
检查 webhook 投递尝试，以了解为何收不到传入消息或状态更新。
健康监控
定期对电话号码和项目运行健康检查，以在问题影响用户之前主动发现问题。
试试这些提示
我需要检查 WhatsApp 消息是否已投递。电话号码是 +1234567890。帮我查找对话并检查其投递状态。
我们的 webhook 端点停止接收来自 WhatsApp 的事件。使用 webhook-deliveries 脚本检查最近的投递尝试并识别任何错误模式。
我们在生产环境中发现消息错误增加。运行完整的错误分类：检查消息错误、审查 API 日志，并识别任何 webhook 投递失败。总结根本原因。
对电话号码 ID <id> 运行健康检查并生成状态报告。包括任何失败的健康指标和推荐的修复步骤。
最佳实践
- 始终同时检查消息错误和 API 日志，以将故障与根本原因关联起来
- 在部署 WhatsApp 集成更改之前主动运行健康检查
- 调查单个消息问题时，使用 lookup-conversation 脚本获取完整上下文
避免
- 不要快速连续重复运行诊断脚本，因为这可能会导致 API 访问被限速
- 不要使用此技能进行 webhook 设置或配置更改
- 避免在首先验证 API 凭据有效且未过期之前调查问题