kapso-api について
顧客のオンボーディング、セットアップリンクの生成、電話番号のプロビジョニング、WhatsApp 接続の検出など、Kapso Platform API の操作を支援するスキルです。顧客設定や番号のプロビジョニングをワークフローに組み込む開発者向けです。
主な機能
- 01顧客とセットアップリンクの作成
- 02電話番号プロビジョニングの設定
- 03Webhook またはリダイレクトによる WhatsApp 接続の検出
- 04phone_number_id を WhatsApp 識別子として使用
活用シーン
- 01顧客の WhatsApp オンボーディング
- 02顧客用セットアップリンクの生成
- 03登録時の電話番号プロビジョニング
- 04WhatsApp 接続の確立検出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gokapso/ agent-skills --skill kapso-apiインストール後、Claude Code で/kapso-apiを入力して読み込まれたか確認します。
詳細
Kapso Platform API
使用する場面
顧客の作成、セットアップリンクの生成、電話番号のプロビジョニング、WhatsApp 接続の検出など、Platform API の操作にこのスキルを使用します。
セットアップ
ベースホスト:https://api.kapso.ai(スクリプトで /platform/v1 を追加します)
認証ヘッダー:
X-API-Key: <api_key>
使用方法
顧客をオンボーディングする
- 顧客を作成します:
POST /customers - セットアップリンクを生成します:
POST /customers/:id/setup_links - 顧客が埋め込みサインアップを完了します
- メッセージの送信には
phone_number_idを使用します
接続を検出する
オプション A:プロジェクトの Webhook whatsapp.phone_number.created
オプション B:成功時のリダイレクト URL クエリパラメーター
最適なユーザー体験とバックエンドの信頼性を実現するには、両方を使用してください。
電話番号をプロビジョニングする
セットアップリンクの作成時に、次の項目を設定します:
{
"setup_link": {
"provision_phone_number": true,
"phone_number_country_isos": ["US"]
}
}
注意事項
- Platform API のベースパス:
/platform/v1 - Meta プロキシのベースパス:
/meta/whatsapp/v24.0(メッセージングとテンプレートに使用します) - WhatsApp の主要な識別子として
phone_number_idを使用します
参考資料
- references/platform-api-reference.md - エンドポイントの全リファレンス
- references/getting-started.md - 初期セットアップガイド
- references/setup-links.md - セットアップリンクの設定
- references/detecting-whatsapp-connection.md - 接続の検出方法
関連スキル
kapso-automation- ワークフローの自動化whatsapp-messaging- WhatsApp のメッセージングとテンプレートwhatsapp-flows- WhatsApp Flowskapso-ops- 運用と Webhook
コメント
Markdown 対応