AI エージェント向け WhatsApp API: Tech Provider にならず、数分で公式アクセス
AI エージェントは Meta の Cloud API を通じて公式の WhatsApp アクセスを得ます。WhatsApp Business アプリに残ったままの番号は、Tech Provider または Solution Partner を通じて参加します。自ら Tech Provider になる場合は、ビジネス認証、App Review 用の動画、Embedded Signup の構築が必要です。すでに認定を受けているプロバイダー経由で接続すれば、番号は数分で参加し、エージェントは MCP ツールまたは API 認証情報を使えます。
easyCoexistence は独立した Meta Tech Provider です。
Meta が、WhatsApp Business アプリに残る番号を接続する事業者に求めるもの:Tech Provider または Solution Partner の資格。
App Review は、アプリからのメッセージ送信を示す動画 1 本と、アプリでメッセージテンプレートを作成する動画 1 本を求めます。
App Review が付与する権限は whatsapp_business_messaging と whatsapp_business_management の 2 つで、どちらも Tech Provider になるために必要です。
Meta が Embedded Signup の v2 と v3 を非推奨とし、連携先に v4 への移行を求めたこと。
WhatsApp Business アプリと Cloud API の両方で使用されている番号の、固定のスループット。
プラットフォームが Partner API で顧客の番号を登録する際、ホスト型の接続リンクが有効な期間。
AI エージェントが WhatsApp を公式に使うには何が必要ですか?
Meta の Cloud API から必要なものは 4 つです。まず、messages エンドポイントを呼び出すための whatsapp_business_messaging 権限を持つアクセストークンと、電話番号 ID。次に、受信メッセージを Meta が届ける Webhook エンドポイント。アプリと共有している番号では、スマホで相手が入力した返信を受け取るため smb_message_echoes も必要です。さらに、承認済みのメッセージテンプレート。入力されたメッセージが届くのは、直近 24 時間以内にやり取りした相手だけだからです。最後に、スマホのアプリは動き続けても API 側の接続が切れたときに気づく仕組み。
最初に見つけがちな近道は WhatsApp Web の自動化で、リンクされたデバイスとしてサインインします。これは WhatsApp の規約に違反し、その上でエージェントが何をしても、番号が停止されるおそれがあります。
Tech Provider の方法には何が含まれますか?
Meta が定めた手順で、この順番で進みます。各ステップは無料ですが、お金で早めることはできません。審査は Meta のスケジュールで行われ、Meta は所要期間を公開していないため、最初のお客様の番号が接続されるまでは数日ではなく数週間を見込んでください。その後もバックエンドを動かし続ける必要があります。サインアップのたびにトークン交換を行い、Webhook の受信処理を用意し、番号ごとのルーティングを行い、Meta の 14 日間の非アクティブ化ルールのような切断を監視します。
より短い方法は何ですか?
すでに同じ手続きを終えているプロバイダー経由で番号を接続することです。easyCoexistence では、企業は Meta の Embedded Signup を実行し、WhatsApp Business アプリでコードをスキャンします。これには約 2 分しかかからず、番号は企業自身の Business Portfolio で Cloud API に参加し、アプリは引き続き動きます。エージェントは話したい形でアクセスできます。ChatGPT、Claude、Claude Code、Codex などのアシスタントには MCP ツール、コードを実行する場合は番号の認証情報と Webhook を使います。
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
エージェントはどうやって番号の認証情報を取得しますか?
get_api_credentials から、またはダッシュボードの番号のページから取得します。ツールは、Graph API のベース URL、WhatsApp Business Account ID、電話番号 ID、送信エンドポイント、そして(存在する場合)企業自身のアクセストークンを返します。トークンはその WhatsApp の資産に限定されています。クライアントトークンが発行されていない場合、トークンは null で返され、ダッシュボードから番号を再接続すると発行されるという注記が付きます。ただし、動作しているトークンは置き換えられません。取得すべきアプリシークレットはありません。Meta は Webhook の署名に easyCoexistence のアプリシークレットを使い、これは共有されることはないからです。トークンは送信に使えるため、このツールには有効なプランが必要です。
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'受信メッセージはどうやってエージェントに届きますか?
番号ごとに 2 つのモードがあり、set_inbound_mode またはその番号のページで切り替えます。
サーバーへ直接送信:set_webhook_destination で Meta を HTTPS エンドポイントに直接向けます。このエンドポイントは Meta の GET ハンドシェイクに応答する必要があります。easyCoexistence はメッセージを一切見ないため、オートメーションは無効になります。Meta はこの配信に当社のアプリシークレットで署名するため、URL のパスに長くランダムなシークレットを入れ、それがないリクエストは拒否してください。
オートメーション有効:Meta は easyCoexistence に配信し、オートメーションが返信できます。任意の Forward URL は、Meta の元のペイロードを "value" の下で受け取り、X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> で署名されます。シークレットは一度だけ表示されます。オートメーションの「Call my webhook」ステップは、メッセージとチャットの直近 10 件のメッセージもエージェントに渡し、回答が 20 秒以内に {"reply": "..."} であれば、その返信を送信します。
エージェントが守るべき制限は何ですか?
Meta の制限で、どのプロバイダー経由でも同じです。事前に把握しているエージェントは、バグのように見える失敗を避けられます:
- 番号 1 件あたり毎秒 20 メッセージ。Meta が WhatsApp Business アプリと共有する番号に対して固定されています。
- 入力されたメッセージを送れるのは、顧客の最後のメッセージから 24 時間以内だけです。それ以降は承認済みのメッセージテンプレートを使います。
- テンプレートは API からのみ送信されます。Coexistence の番号ではアプリからテンプレートを送れないためです。
- アプリで相手が入力した返信は
smb_message_echoesとして届きます。そのチャットではエージェントを一時停止してください。そうしないと、顧客は 2 件の返信を受け取ってしまいます。 - グループチャットは API と同期されないため、エージェントは 1 対 1 のチャットで動作します。
- 連絡先と、最大 6 か月分の 1 対 1 のチャットは、一度だけインポートされます。ただし、接続から 24 時間以内に直接の Webhook 送信先が保存されている場合に限ります。オートメーションが有効な番号はインポートされません。
- 音声通話とビデオ通話はアプリで引き続き使えますが、Cloud API は Coexistence の番号の通話を扱えないため、エージェントはテキストで対応します。
プラットフォームは自社の顧客の番号をこの方法で接続できますか?
はい。Partner API を通じて可能です。SaaS やエージェンシーは、自社で Tech Provider の資格を持たなくても顧客を登録できます。create_api_key で API キーを作成します(ec_live_ で始まり、一度だけ表示されます)。その後、バックエンドから POST /api/v1/connect-sessions を呼び出すか、アシスタントから create_connect_link を実行して、1 時間有効なホスト型リンクを取得します。顧客は Meta のポップアップと QR スキャンをそこで行い、connection_id を付けて redirect_url に戻ります。GET /api/v1/connections/:id?credentials=1 は顧客自身のトークンを返します。connection.disconnected などのステータスイベントは、X-EC-Signature で署名されて届きます。各番号は、同じ番号単位の料金帯で、お使いのアカウントに請求されます。
よくある間違い
- 直接の送信先で X-Hub-Signature-256 を検証すること。Meta は easyCoexistence のアプリシークレットで署名しており、これは共有されないため、正当な配信も検証に失敗します。URL 内の長くランダムなシークレットを信頼するか、X-EC-Signature で転送を使ってください。
- n8n の WhatsApp Trigger ノードで受信すること。このノードは自分の Meta アプリを前提としています。代わりに、URL にシークレットを含めた汎用の Webhook ノードを使ってください。
- smb_message_echoes を無視すること。すると、エージェントはスマホからすでに返信している相手に対して返答してしまい、顧客は 2 件の返信を読むことになります。
- 直接の Webhook 送信先の保存を接続から数日たってから行うこと、またはオートメーションを有効のままにすること。Meta による連絡先と最大 6 か月分のチャットの一度きりのインポートには、接続から 24 時間以内に直接の送信先が保存されている必要があります。
WhatsApp Business の番号を Coexistence を通じて数分で Cloud API に接続するため、エージェントは公式アクセスを得る一方で、企業はアプリを使い続けられます。エージェントは 30 を超える MCP ツール、または各番号の認証情報と Webhook を通じて動作し、すべての番号は 24 時間 365 日監視され、アラートが届きます。料金は番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
独自の Meta アプリは必要ですか?
いいえ。番号は easyCoexistence の Meta アプリを通じて登録され、企業自身の Business Portfolio と WhatsApp Business Account に残ります。コードは get_api_credentials で取得した企業自身のトークンで送信するため、独自のアプリは必要ありません。
エージェントとチームは同じ番号を同時に使えますか?
はい。Meta は Cloud API と WhatsApp Business アプリの間でメッセージを同期します。そのため、エージェントの送信内容はスマホのアプリのチャットスレッドに表示され、チームがアプリで入力した内容は smb_message_echoes としてシステムに届きます。
どのエージェントフレームワークと連携しますか?
OAuth を使う HTTP 上の MCP に対応するクライアント(ChatGPT、Claude、Claude Code、Codex、Cursor など)と、Meta の Graph API を呼び出すコード(Node.js、Python、n8n、LangChain、OpenAI Agents SDK、Vercel AI SDK など)が対象です。API の土台は Meta 自身のものなので、エージェントの中に独自の仕組みはありません。
汎用の AI アシスタントは WhatsApp で許可されていますか?
Meta の Business Solution Terms の第 4.7 条は、AI が主要な機能である場合に、汎用の AI アシスタントを提供する事業者が WhatsApp Business Platform 上でそれを提供することを、Meta の判断により禁じています。この規定は 2026 年 1 月 15 日から施行されています。自社の顧客のために、サポート、営業、予約の目的で AI を使う企業は対象ではありません。また、EU とブラジルの規制当局は、競合するアシスタントに対する規定の停止または撤回を Meta に命じています。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日