observe-whatsapp
WhatsApp メッセージ配信とウェブフックの問題をデバッグする
WhatsApp の本番環境問題を効率的にトラブルシューティングします。このスキルは、メッセージ配信の検査、ウェブフック障害のデバッグ、Kapso プラットフォームでのヘルスチェック実行のためのコマンドを提供します。
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "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 認証情報が有効で有効期限が切れていないことをまず確認せずに問題を調査しない