MCP ツールリファレンス
このコネクタは、アカウント内のすべての接続を対象に 30 個以上のツールを提供します。WhatsApp では list_numbers が最初で、WhatsApp のツールはそこで得た connection_id を受け取ります。ほかのチャネルでは list_social_accounts が最初で、そのツールは account_id を受け取ります。料金の支払いが滞ると 6 個が制限されます。外部に作用する WhatsApp の 4 個、アクセストークンを返す get_api_credentials、create_connect_link です。残りのツールは引き続き利用できます。
コネクタが提供するツール
料金の支払いが滞ると制限されるツール。アクセストークンを返す get_api_credentials も含みます。
OAuth でサインインし、アカウント内のすべての番号を対象にします。
各ツールは何をしますか?
読み取り:list_numbers は、接続済みの電話番号、ステータス、品質評価、メッセージング階層を返します。ほかのすべての呼び出しはここから始まります。get_number_health は、Meta の最新スナップショットに加え、最近の監視タイムライン、Webhook イベント、ポーラーのチェック結果をまとめて返します。get_api_credentials は、Graph API のベース URL、WABA id、phone number id、利用可能な場合はアカウント独自のアクセストークンを返します。
送信:send_message は 24 時間のウィンドウ内で自由文を送信します。この間の返信は無料です。send_template は承認済みのテンプレートを送信します。まだメッセージを送っていない相手との会話を始める方法です。list_templates、create_template、get_template_status は、テンプレートのライフサイクルを扱います。
接続設定:set_webhook_destination は受信メッセージとアプリからのエコーをシステムへ転送します。null を渡すと設定がリセットされます。get_connect_link は、新しい番号を接続するためのダッシュボードリンクと手順を返します。get_docs は、製品ドキュメントを Markdown として返します。
Partner API は、自社の顧客が番号を接続するソフトウェアや代理店向けです。get_partner_setup は、料金の状態、API キー、イベント URL、次の手順を返します。create_api_key は Partner API キーを発行して一度だけ表示し、明示的な確認がない限り既存のキーを置き換えません。revoke_api_key はキーを無効にします。これも確認後のみです。set_partner_events_url はステータスイベントの送信先を設定し、署名シークレットを一度だけ返します。create_connect_link は、顧客 1 人向けに 1 時間有効なホスト型の接続リンクを作成します。POST /api/v1/connect-sessions と同じ処理です。
connection_id が重要なのはなぜですか?
特定の番号に指示を結び付ける値であり、アシスタントが推測できないためです。
番号に作用するすべてのツールは connection_id を受け取ります。その値を取得できる場所は list_numbers だけです。実際には、メッセージの送信を頼まれたアシスタントは最初に list_numbers を呼び出します。そのため、セッションの最初のリクエストは通常、それ以降より時間がかかります。
また、複数の番号を持つアカウントでも、仕組み上あいまいさがありません。デフォルトの番号も暗黙の選択もないため、番号を特定しない指示は推測されず、どの番号についての指示か確認されます。
料金の支払いが滞るとどうなりますか?
制限されるのは 6 個のツールです。外部に作用する send_message、send_template、create_template、set_webhook_destination、アカウントのアクセストークンを返す get_api_credentials (ブロックされたアカウントが Graph API から直接送信できてしまうため)、そして新しい番号を接続する create_connect_link です。ほかの読み取りはすべて引き続き利用でき、Partner API の設定用ツール get_partner_setup、create_api_key、revoke_api_key、set_partner_events_url も同様です。
これは見落としではなく、意図した仕様です。ブロックされた理由を確認できない、または番号の接続状態を確認できないアカウントは、サポートへの問い合わせ以外に復旧の道がありません。接続状態の監視も同じ読み取り機能に依存しているため、最も必要なときに監視を止めることになります。
その結果、料金の支払いが滞ったアカウントでも、自分の状態について質問でき、監視も継続されます。停止するのは、顧客に届く処理だけです。
よくある間違い
- コネクタがメッセージを受信すると考える。MCP はリクエストとレスポンスで動作し、受信トラフィックには Webhook が必要です。
- connection_id をハードコードする。list_numbers から取得する値であり、書き留めておくものではありません。
- 料金の支払いが滞ったアカウントは完全にオフラインだと考える。読み取りと監視は意図的に継続されます。ただし、送信に使うアクセストークンを含む認証情報は除きます。
1 つのコネクタでアカウント内のすべての番号を扱えます。OAuth で認証するため、キーの貼り付けは不要です。接続済みの番号 1 件あたり月額 US$ 9 から、番号を追加するほど US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
どのツールを呼び出すか選ぶ必要がありますか?
いいえ。自然な言葉で依頼すれば、アシスタントが選びます。ツールの説明はそのために書かれています。
会話を読み取れますか?
いいえ。受信メッセージは指定した Webhook の送信先へ転送されます。コネクタが読み取るのはアカウントと番号の状態です。
get_docs は役に立ちますか?
思った以上に役立ちます。アシスタントに当社のドキュメントを Markdown で渡すため、Coexistence のルールに関する回答は記憶ではなく当社のドキュメントに基づきます。
1 つのコネクタで複数の顧客を扱えますか?
はい。1 つのアカウントに必要な数の番号を登録でき、list_numbers がすべて返します。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日