jpskill.com
🛠️ 開発・MCP コミュニティ

observe-whatsapp

Observe and troubleshoot WhatsApp in Kapso: debug message delivery, inspect webhook deliveries/retries, triage API errors, and run health checks. Use when investigating production issues, message failures, or webhook delivery problems.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o observe-whatsapp.zip https://jpskill.com/download/20502.zip && unzip -o observe-whatsapp.zip && rm observe-whatsapp.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/20502.zip -OutFile "$d\observe-whatsapp.zip"; Expand-Archive "$d\observe-whatsapp.zip" -DestinationPath $d -Force; ri "$d\observe-whatsapp.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して observe-whatsapp.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → observe-whatsapp フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[Skill 名] observe-whatsapp

WhatsApp の監視

使用場面

このスキルは、メッセージ配信の調査、Webhook 配信のデバッグ、エラーのトリアージ、WhatsApp のヘルスチェックといった運用診断にご利用ください。

セットアップ

環境変数:

  • KAPSO_API_BASE_URL (ホストのみ、/platform/v1 は含めない)
  • KAPSO_API_KEY

使用方法

メッセージ配信の調査

  1. メッセージの一覧表示: node scripts/messages.js --phone-number-id <id>
  2. メッセージの検査: node scripts/message-details.js --message-id <id>
  3. 会話の検索: node scripts/lookup-conversation.js --phone-number <e164>

エラーのトリアージ

  1. メッセージエラー: node scripts/errors.js
  2. API ログ: node scripts/api-logs.js
  3. Webhook 配信: node scripts/webhook-deliveries.js

ヘルスチェックの実行

  1. プロジェクトの概要: node scripts/overview.js
  2. 電話番号の健全性: node scripts/whatsapp-health.js --phone-number-id <id>

スクリプト

メッセージ

スクリプト 目的
messages.js メッセージの一覧表示
message-details.js メッセージの詳細取得
lookup-conversation.js 電話番号または ID で会話を検索

エラーとログ

スクリプト 目的
errors.js メッセージエラーの一覧表示
api-logs.js 外部 API ログの一覧表示
webhook-deliveries.js Webhook 配信試行の一覧表示

ヘルス

スクリプト 目的
overview.js プロジェクトの概要
whatsapp-health.js 電話番号のヘルスチェック

OpenAPI

スクリプト 目的
openapi-explore.mjs OpenAPI の探索 (検索/操作/スキーマ/場所)

依存関係のインストール (一度だけ):

npm i

例:

node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery

注意事項

  • Webhook の設定 (作成/更新/削除、署名検証、イベントタイプ) には integrate-whatsapp を使用してください。

参照

関連スキル

  • integrate-whatsapp - オンボーディング、Webhook、メッセージング、テンプレート、フロー
  • automate-whatsapp - ワークフロー、エージェント、自動化

<!-- FILEMAP:BEGIN -->

[observe-whatsapp file map]|root: .
|.:{package.json,SKILL.md}
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|scripts:{api-logs.js,errors.js,lookup-conversation.js,message-details.js,messages.js,openapi-explore.mjs,overview.js,webhook-deliveries.js,whatsapp-health.js}
|scripts/lib/messages:{args.js,kapso-api.js}
|scripts/lib/status:{args.js,kapso-api.js}
|scripts/lib/triage:{args.js,kapso-api.js}

<!-- FILEMAP:END -->

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Observe WhatsApp

When to use

Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.

Setup

Env vars:

  • KAPSO_API_BASE_URL (host only, no /platform/v1)
  • KAPSO_API_KEY

How to

Investigate message delivery

  1. List messages: node scripts/messages.js --phone-number-id <id>
  2. Inspect message: node scripts/message-details.js --message-id <id>
  3. Find conversation: node scripts/lookup-conversation.js --phone-number <e164>

Triage errors

  1. Message errors: node scripts/errors.js
  2. API logs: node scripts/api-logs.js
  3. Webhook deliveries: node scripts/webhook-deliveries.js

Run health checks

  1. Project overview: node scripts/overview.js
  2. Phone number health: node scripts/whatsapp-health.js --phone-number-id <id>

Scripts

Messages

Script Purpose
messages.js List messages
message-details.js Get message details
lookup-conversation.js Find conversation by phone or ID

Errors and logs

Script Purpose
errors.js List message errors
api-logs.js List external API logs
webhook-deliveries.js List webhook delivery attempts

Health

Script Purpose
overview.js Project overview
whatsapp-health.js Phone number health check

OpenAPI

Script Purpose
openapi-explore.mjs Explore OpenAPI (search/op/schema/where)

Install deps (once):

npm i

Examples:

node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery

Notes

  • For webhook setup (create/update/delete, signature verification, event types), use integrate-whatsapp.

References

Related skills

  • integrate-whatsapp - Onboarding, webhooks, messaging, templates, flows
  • automate-whatsapp - Workflows, agents, and automations

<!-- FILEMAP:BEGIN -->

[observe-whatsapp file map]|root: .
|.:{package.json,SKILL.md}
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|scripts:{api-logs.js,errors.js,lookup-conversation.js,message-details.js,messages.js,openapi-explore.mjs,overview.js,webhook-deliveries.js,whatsapp-health.js}
|scripts/lib/messages:{args.js,kapso-api.js}
|scripts/lib/status:{args.js,kapso-api.js}
|scripts/lib/triage:{args.js,kapso-api.js}

<!-- FILEMAP:END -->