mcpField
K
kapso-ops

kapso-ops

github.com/gokapsoクラウド・DevOps19287 回インストール3 週間前に更新
リポジトリ

kapso-ops について

Kapso の運用上の問題を調査するスキルです。Webhook、WhatsApp メッセージの配信、API の診断に対応し、設定やエラー確認、電話番号の状態確認を行えます。

主な機能

  1. 01Webhook の設定とテスト
  2. 02メッセージと会話の検索
  3. 03エラーと API ログの確認
  4. 04Webhook 配信履歴の追跡
  5. 05プロジェクトと番号の状態確認

活用シーン

  1. 01Webhook の設定とテスト
  2. 02未配信メッセージの調査
  3. 03API エラーと Webhook 配信試行の確認
  4. 04WhatsApp 電話番号の状態確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gokapso/agent-skills --skill kapso-ops

インストール後、Claude Code で/kapso-opsを入力して読み込まれたか確認します。

詳細

Kapso Ops

使用する場面

Webhook の設定、メッセージ配信の調査、エラーのトリアージ、WhatsApp のヘルスチェックなど、運用上の診断にこのスキルを使用します。

セットアップ

環境変数：

  • KAPSO_API_BASE_URL（ホストのみ。/platform/v1 は含めません）
  • KAPSO_API_KEY

使用方法

Webhook を設定する
  1. 作成します：node scripts/create.js --phone-number-id <id> --url <https://...> --events <csv>
  2. 署名の処理を確認します（references/webhooks-overview.md を参照）
  3. テストします：node scripts/test.js --webhook-id <id>
メッセージ配信を調査する
  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>

スクリプト

Webhook
スクリプト目的
list.js電話番号の Webhook を一覧表示
get.jsWebhook の詳細を取得
create.jsWebhook を作成
update.jsWebhook を更新
delete.jsWebhook を削除
test.jsWebhook にテストイベントを送信

create/update で使用する一般的なフラグ：

  • --url <https://...> - Webhook URL
  • --events <csv> - イベントタイプ（カンマ区切り）
  • --kind <kapso|meta> - Webhook の種類
  • --payload-version <v1|v2> - ペイロード形式（v2 を推奨）
  • --buffer-enabled <true|false> - バッファリングの有効化
  • --active <true|false> - 有効化／無効化
メッセージ
スクリプト目的
messages.jsメッセージを一覧表示
message-details.jsメッセージの詳細を取得
lookup-conversation.js電話番号または ID で会話を検索
エラーとログ
スクリプト目的
errors.jsメッセージエラーを一覧表示
api-logs.js外部 API のログを一覧表示
webhook-deliveries.jsWebhook の配信試行を一覧表示
ヘルスチェック
スクリプト目的
overview.jsプロジェクトの概要
whatsapp-health.js電話番号のヘルスチェック

注意事項

  • whatsapp.message.* イベントには、設定レベルの Webhook を使用してください
  • 新しいインテグレーションには、ペイロードバージョン v2 を推奨します
  • Meta の Webhook は生のペイロードを提供し、Kapso の Webhook はバッファリングに対応しています

参考資料

関連スキル

  • kapso-automation - 自動化と関数
  • whatsapp-messaging - WhatsApp メッセージング
  • kapso-api - プラットフォーム API と顧客

コメント

Markdown 対応