integrate-whatsapp

integrate-whatsapp の概要

integrate-whatsapp でできること

integrate-whatsapp スキルは、Kapso を使って WhatsApp をプロダクトに接続するためのスキルです。顧客のオンボーディングからメッセージ配信まで、一連の流れをまとめて扱えます。セットアップリンク、接続検出、webhook、テンプレート送信、メディア、WhatsApp Flows までを 1 つのワークフローでカバーする integrate-whatsapp ガイドが必要なときに、特に役立ちます。

向いているユースケース

この integrate-whatsapp skill は、次の要件を持つバックエンドシステムに適しています。

• 顧客をそれぞれの WhatsApp Business アカウントにオンボーディングする
• 番号が接続済みになったタイミングを検出する
• webhook 経由でメッセージイベントや会話イベントを受け取る
• 送信メッセージ、テンプレート、メディアを配信する
• Flows のエンドポイント、暗号化、公開手順を管理する

インストールする価値がある理由

最大の利点は、ワークフローが一通り揃っていることです。このリポジトリには、CLI 優先でも API 優先でも実装できる実践的な道筋があり、環境がまだ固まりきっていない場合や、複数テナントを支える必要がある場合に重要です。integrate-whatsapp install を検討しているなら、このスキルは汎用的なプロンプトよりも強力です。なぜなら、実運用で詰まりやすい移動要素――ID、webhook のルーティング、セットアップリンクのライフサイクル、プロジェクト単位と電話番号単位の操作の違い――まで含まれているからです。

integrate-whatsapp の使い方

インストールして前提コンテキストを確認する

npx skills add gokapso/agent-skills --skill integrate-whatsapp でインストールします。実装の相談を始める前に、プロジェクト内のリポジトリコンテキストを確認し、まず SKILL.md を読みます。そのうえで、references/getting-started.md、references/platform-api-reference.md、references/webhooks-overview.md、references/setup-links.md を確認してください。実際の統合手順は、assets をざっと見るよりもこれらのファイルのほうがずっと正確に説明しています。

ざっくりした要望を実装可能なプロンプトに変える

integrate-whatsapp usage を最大限に活かすには、次の点を具体的に書いてください。

• Kapso CLI を使うのか、直接 API を叩くのか
• アプリがマルチテナントか、単一番号か
• どの段階で止まっているのか: オンボーディング、接続検出、webhook 処理、送信、Flows
• すでに持っているオブジェクト: customer_id、phone_number_id、business_account_id、webhook secret など

たとえば、良いプロンプトは次のようになります。

マルチテナント SaaS 向けに WhatsApp のオンボーディングを実装したいです。customer_id はすでにあります。セットアップリンクのフロー、whatsapp.phone_number.created の webhook 確認、phone_number_id を使ったメッセージ送信パスが必要です。

まず読むべきファイルとワークフロー

実装方針を決めるうえで重要なファイルから読み始めてください。

• references/getting-started.md : エンドツーエンドの流れ
• references/detecting-whatsapp-connection.md : 接続イベントとリダイレクト処理
• references/webhooks-reference.md と references/webhooks-overview.md : イベント配信ルールと署名検証
• references/templates-reference.md : テンプレートやメディアを送る場合
• references/whatsapp-flows-spec.md と assets/sample-flow.json : Flows が必要な場合

早めに確認しておくと便利な assets は次のとおりです。

• assets/webhooks-example.json
• assets/dynamic-flow.json
• assets/send-template-order-status-update.json
• assets/send-interactive-buttons.json

実務で役立つ使い方のコツ

プロジェクトの状態、顧客、番号を探る段階では CLI を使うのが向いています。自分のバックエンドに統合するなら、raw な API 呼び出しのほうが扱いやすいです。セットアップリンクによるオンボーディングとメッセージ送信は混同しないでください。オンボーディングは接続済みの番号を作成または解決する工程であり、送信には正しい phone_number_id が必要です。この違いは integrate-whatsapp usage の成功の中心であり、実装エラーの大半を避けるのに役立ちます。

integrate-whatsapp skill の FAQ

これは Backend Development 向けだけですか？

はい、この integrate-whatsapp for Backend Development スキルは、主にバックエンド作業向けです。サーバー側のオンボーディング、webhook 処理、API 認証、メッセージのオーケストレーションに向いています。UI コピーやマーケティング文面のためのスキルではありません。

普通のプロンプトと何が違いますか？

通常のプロンプトは WhatsApp 統合を曖昧に説明しがちです。integrate-whatsapp skill は、セットアップリンク、webhook イベント、番号解決、WhatsApp Flows という実際の統合面を反映しているため、より実用的です。説明用ではなく、そのままデプロイできるものが必要なときの、推測の余地を減らしてくれます。

使うのに Kapso CLI は必要ですか？

必須ではありません。ただし、このスキルでは CLI が推奨ルートです。プロジェクト選択、セットアップ、番号の発見に役立つからです。チームで CLI ツールを使えない場合でも、リファレンスを使えば X-API-Key 経由の直接 API 呼び出しで進められます。

どんなときに integrate-whatsapp を使わないほうがいいですか？

WhatsApp の製品概要だけが欲しい場合や、Kapso のプラットフォーム API を使わない別プロバイダを統合している場合は、このスキルは避けてください。また、オンボーディングや webhooks を伴わない、一度きりのメッセージ例だけが欲しい場合にも向きません。

integrate-whatsapp skill を改善するには

スキルに正しい開始状態を渡す

最も効果的な改善は、実際の統合状態を渡すことです。たとえば、現在のプロジェクト ID、すでに顧客が存在するかどうか、自分が管理している webhook エンドポイント、送信したいメッセージ種別などです。これにより、integrate-whatsapp install の結果がより実用的になります。スキルがゼロからセットアップを繰り返すのではなく、どこからフローが始まるのかを判断できるようになるからです。

失敗している箇所を明確にする

より良い結果を得たいなら、何が詰まっているのかを具体的に書いてください。

• “setup link は開くが phone number が作成されない”
• “webhook は届くが署名検証に失敗する”
• “template send は test では動くが production では動かない”
• “phone_number_id が間違っている”

こうした情報は、一般的な統合計画を求めるよりも、ずっと有用な integrate-whatsapp usage の案内につながります。

反復には適切な成果物を使う

最初の出力が不十分なら、次のいずれかを使って詰めていってください。

• 受け取った webhook payload
• 送信したい template JSON
• 公開したい Flow JSON
• kapso status、kapso whatsapp numbers list のコマンド出力、または API レスポンス

integrate-whatsapp guide の作業では、こうした成果物のほうが大まかな要件より重要です。ID、イベント名、リダイレクト処理、payload の形を素早く直せるからです。

本番で起きやすいミスに注意する

よくある失敗は、誤った識別子を使う、間違った webhook 種別を購読する、セットアップ完了をそのまま送信可能状態だとみなす、の 3 つです。出力の質を上げるには、project webhooks が必要なのか phone-number webhooks が必要なのか、Kapso を使うのか Meta proxy endpoints を使うのか、アプリが coexistence モードをサポートする必要があるのか、それとも dedicated モードなのかを明示してください。