observe-whatsapp
除錯 WhatsApp 訊息傳送與 Webhook 問題
有效排除 WhatsApp 生產環境問題。此技能提供用於檢查訊息傳送、除錯 Webhook 失敗，以及在 Kapso 平台上執行健康檢查的命令。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「observe-whatsapp」。 檢查電話號碼 +1234567890 的訊息傳送狀態
預期結果:
找到 3 則 +1234567890 的訊息。訊息 ID msg_abc123：已於 2024-01-15 10:30:00 傳送。訊息 ID msg_def456：待處理（Webhook 未確認）。訊息 ID msg_ghi789：失敗 - 收件人已選擇退出。
正在使用「observe-whatsapp」。 顯示過去一小時的 Webhook 傳送狀態
預期結果:
Webhook 傳送摘要：45 次成功，3 次失敗。失敗傳送：10:15、10:22、10:45 從 Webhook 端點收到 503 Service Unavailable。重試次數：3/3。建議檢查 Webhook 伺服器健康狀態。
安全審計
安全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 憑證是否有效且未過期之前調查問題