WhatsApp Coexistence 用語集
WhatsApp Coexistenceに関する用語は混同しやすく、実際には同じ言葉を別の意味で使うことが混乱の原因です。このサイトで使う定義を、詳しく説明するページへのリンクとともにまとめています。
EasyCoexistenceはMeta独自のフローで番号を接続し、接続状態を監視します。
- Coexistence
WhatsApp Business アプリと Cloud API を 1 つの番号で同時に使うための Meta の公式モードです。別の API ではなく、アプリが引き続き動作するようにオンボーディングされた同じ Cloud API です。
WhatsApp Coexistence- Cloud API
Meta がホストする WhatsApp Business Platform の API です。このサイトでの送信、メッセージテンプレート、Webhook はすべてこれを経由します。
Cloud API と Coexistence の比較- WhatsApp Business アプリWhatsApp Business app
企業がスマートフォンで使うアプリです。一般ユーザー向けの WhatsApp アプリとは別物で、Coexistence で接続するには、番号がこのアプリで使われている必要があります。
- WhatsApp Business アカウントWABA
電話番号とメッセージテンプレートを保持する Meta のオブジェクトです。Business Portfolio の中にあります。Webhook の上書き設定は番号ごとではなく、この単位で適用されます。
- Business Portfolio
Meta Business Manager における企業単位のコンテナです。1 つ以上の WhatsApp Business アカウントを保持します。クライアントの番号はプロバイダーではなく、クライアント自身のポートフォリオに残ります。
Meta Tech Provider- 電話番号 IDPhone number id
接続済みの 1 つの番号に対する Meta の識別子です。送信先には番号そのものではなくこの ID を指定し、受信するすべての Webhook ペイロードにも含まれます。
- Embedded Signup
Meta 独自のオンボーディング用ポップアップです。ポートフォリオ、アカウント、番号を選択し、Coexistence の場合は WhatsApp Business アプリで読み取るコードも含まれます。
番号の接続方法- Tech Provider
企業が自社の承認済みアプリを通じて他社の番号を接続できる Meta 上のステータスです。取得は無料ですが、ビジネス認証と App Review が必要です。Meta による推奨を意味するものではありません。
その意味- BSPBusiness Solution Provider
メッセージングプラットフォーム(多くの場合は共有受信箱)を販売する企業です。Tech Provider と重なる部分はありますが、Meta 上のステータスではなく製品を指します。
Coexistence と BSP の比較- Webhook の送信先webhook destination, webhook override
Meta が WhatsApp Business アカウントのイベントを配信する先です。アプリのサブスクリプションに対する上書き設定として指定されるため、接続を削除すると一緒に解除されます。
WhatsApp の Webhook- hub.challenge
Meta が検証用の GET リクエストで送る値です。エンドポイントはこれをそのままレスポンスの本文として返す必要があります。代わりに JSON を返してしまうことが、Webhook が何も受信しない最も一般的な原因です。
Webhook の検証- messages
顧客が送信した内容を運ぶ Webhook フィールドです。メッセージ経路の一部で、Webhook の上書き設定によってプロバイダーから振り向けられるのはこの経路です。
- smb_message_echoes
チームが WhatsApp Business アプリから送信した内容を運ぶ Webhook フィールドです。Coexistence の番号にのみ存在し、ソフトウェアが人間の返信を把握する手段になります。
- 顧客対応ウィンドウcustomer service window, 24 時間ウィンドウ
顧客の最後のメッセージから 24 時間の期間で、この間は自由入力のテキストが配信されます。期間外に配信されるのは承認済みのメッセージテンプレートだけです。
エラー 131047- メッセージテンプレートtemplate
事前に Meta の審査を受けるメッセージです。顧客対応ウィンドウの外で配信できる唯一の手段で、Coexistence の番号では API からしか送信できません。
エラー 132001- 品質評価quality rating
受信者の反応をもとに Meta が付ける緑、黄、赤の評価です。費用が発生する前に下がり、下がったことは誰にも通知されません。
エラー 131048- メッセージング上限messaging tier
1 つの番号が 1 日に会話を開始できるユニークな顧客の数です。上がることも下がることもあります。速度であるスループットとは別物です。
- スループットthroughput
1 つの番号が 1 秒間に送信できるメッセージの数です。Coexistence の番号では Meta によって固定されており、品質や上限に応じて増えることはありません。
エラー 130429- 接続済みデバイスlinked device
WhatsApp Web のように、別の場所でログインしている一般ユーザー向けの WhatsApp クライアントです。非公式ツールが自動化しているのはこれで、WhatsApp の規約で禁止されており、番号が利用停止になる原因です。
非公式 API のリスク- MCPModel Context Protocol
AI アシスタントが自分のものではないツールにアクセスする仕組みです。リクエストとレスポンスのみで、受信したメッセージによって MCP サーバーを起動することはできません。
WhatsApp MCP サーバー
なぜ用語がこれほど混乱を招くのですか?
これらの用語のいくつかは、同じ階層に見えても、実際には異なる階層のものを指すからです。
Business PortfolioにはWhatsApp Business Accountが含まれ、その中に電話番号があり、それぞれに電話番号 IDがあります。会話ではこの4つすべてがアカウントと呼ばれるため、「アカウントが動作しているか確認してください」という文が、4種類の異なる確認を意味することがあります。このプラットフォームにある2つの24時間ウィンドウでも同じことが起こります。両者は無関係なものを測定しますが、常に取り違えられています。
もう一つの理由は、Metaとプロバイダーが同じものに異なる言葉を使い、プロバイダー同士でも用語が一致していないことです。このページでは、存在する場合はMeta独自の用語を使い、当社独自の用語である場合はそのことを明確にします。
実際の運用で重要な違いは何ですか?
3つあります。どれも誰かの1日を費やす原因になっています。
顧客対応ウィンドウと同期ウィンドウはどちらも24時間ですが、互いに関係ありません。一方は自由入力メッセージを配信できるかどうかを決めるもので、顧客の最後のメッセージから数えます。もう一方はチャット履歴を引き続き取得できるかどうかを決めるもので、オンボーディングから数えます。
接続済みデバイスはAPIではありません。別の場所でWhatsAppの一般ユーザー向けクライアントにログインした状態です。非公式ツールはこれを自動化するため、電話番号が利用停止になる原因になります。
また、Webhookの送信先は番号の設定ではありません。アカウントに対するアプリのサブスクリプションを上書きする設定です。そのため、接続を削除すると消え、再接続時に設定し直す必要があります。
よくある質問
CoexistenceはCloud APIとは別のAPIですか?
いいえ。Coexistenceは、WhatsApp Business アプリをその番号で引き続き使えるようにしながら、Cloud APIに番号をオンボーディングする方法です。エンドポイント、メッセージ形式、ルールは同一です。
Business PortfolioとWABAの違いは何ですか?
Business PortfolioはMeta Business Managerにおける企業レベルのコンテナです。その中にWhatsApp Business Accountがあり、電話番号を保持します。1つのポートフォリオに複数のWABAを含めることができます。
BSPはTech Providerと同じですか?
重なる部分はありますが、異なるものを指します。Tech Providerは、自社のアプリを通じて他社の番号を接続できるMeta上のステータスです。BSPは通常、メッセージングプラットフォームを販売する企業を指し、その企業自身がこのステータスを持つとは限りません。
MCPはWhatsAppとどう関係しますか?
本質的な関係はありません。MCPはAIアシスタントにツールへのアクセスを提供するプロトコルで、WhatsApp MCPサーバーは番号をそのツールの一つとして公開します。メッセージを受信することはできず、依頼されたときだけ動作します。
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める3 日間は料金なし。いつでもキャンセルできます。