observe-whatsapp
WhatsApp メッセージ配信とウェブフックの問題をデバッグする
WhatsApp の本番環境問題を効率的にトラブルシューティングします。このスキルは、メッセージ配信の検査、ウェブフック障害のデバッグ、Kapso プラットフォームでのヘルスチェック実行のためのコマンドを提供します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「observe-whatsapp」を使用しています。 電話番号 +1234567890 のメッセージ配信を確認する
期待される結果:
+1234567890 に対して 3 件のメッセージが見つかりました。メッセージ ID msg_abc123: 2024-01-15 10:30:00 に配信済み。メッセージ ID msg_def456: 保留中（ウェブフックが確認されていない）。メッセージ ID msg_ghi789: 失敗 - 受信者がオプトアウト。
「observe-whatsapp」を使用しています。 過去 1 時間のウェブフック配信ステータスを表示する
期待される結果:
ウェブフック配信の概要：45 件成功、3 件失敗。失敗した配信：10:15、10:22、10:45 にウェブフックエンドポイントから 503 Service Unavailable。再試行回数：3/3。ウェブフックサーバーのヘルスチェックを推奨します。
セキュリティ監査
安全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 メッセージが配信されない理由を迅速に調査します。
ウェブフックデバッグ
ウェブフック配信の試行を検査して、受信メッセージやステータス更新がなぜ受信されないかを理解します。
ヘルスモニタリング
電話番号とプロジェクトで定期的にヘルスチェックを実行し、ユーザーに影響が出る前に問題を事前に検出します。
これらのプロンプトを試す
WhatsApp メッセージが配信されたか確認したいです。電話番号は +1234567890 です。会話を見つけて配信ステータスを確認するのを手伝ってください。
ウェブフックエンドポイントが WhatsApp からのイベント受信を停止しました。webhook-deliveries スクリプトを使用して最近の配信試行を確認し、エラーパターンを特定してください。
本番環境でメッセージエラーが増加しています。完全なエラー分類を実行してください：メッセージエラーを確認し、API ログをレビューし、ウェブフック配信障害を特定します。根本原因を要約してください。
電話番号 ID <id> のヘルスチェックを実行し、ステータスレポートを生成してください。失敗したヘルスインジケーターと推奨される修復手順を含めてください。
ベストプラクティス
- 常にメッセージエラーと API ログを一緒に確認して、障害と根本原因を関連付ける
- WhatsApp 統合への変更をデプロイする前に、事前にヘルスチェックを実行する
- 個々のメッセージの問題を調査する際は、lookup-conversation スクリプトを使用して完全なコンテキストを取得する
回避
- 診断スクリプトを短時間に繰り返し実行しない（API アクセスがレート制限される可能性があります）
- ウェブフックのセットアップや設定変更にこのスキルを使用しない
- API 認証情報が有効で有効期限が切れていないことをまず確認せずに問題を調査しない