WhatsApp Coexistence 用語集
WhatsApp Coexistenceに関する用語は混同しやすく、実際には同じ言葉を別の意味で使うことが混乱の原因です。このサイトで使う定義を、詳しく説明するページへのリンクとともにまとめています。
- Coexistence
Meta's official mode for running the WhatsApp Business app and the Cloud API on one number at the same time. Not a separate API: the same Cloud API, onboarded so the app keeps working.
WhatsApp Coexistence- Cloud API
Meta's hosted WhatsApp Business Platform API. Every send, template and webhook on this site runs through it.
Cloud API or Coexistence- WhatsApp Business app
The app a business uses on a phone. Distinct from the consumer WhatsApp app, and a number must be on it before Coexistence can connect it.
- WhatsApp Business AccountWABA
The Meta object that holds phone numbers and templates. Sits inside a Business Portfolio. Webhook overrides are applied at this level rather than per number.
- Business Portfolio
The company level container in Meta Business Manager. Holds one or more WhatsApp Business Accounts. A client's number stays in their portfolio, not a provider's.
Meta Tech Provider- Phone number id
Meta's identifier for one connected number. Sending targets this rather than the number itself, and it appears in every inbound webhook payload.
- Embedded Signup
Meta's own onboarding popup. Picks the portfolio, the account and the number, and for Coexistence includes a code scanned in the WhatsApp Business app.
How a number connects- Tech Provider
A Meta status permitting a company to connect other businesses' numbers through its own approved app. Free to obtain, gated on business verification and App Review. Not an endorsement.
What it means- BSPBusiness Solution Provider
A company selling a messaging platform, usually a shared inbox. Overlaps with Tech Provider but describes the product rather than the Meta status.
Coexistence or a BSP- Webhook destinationwebhook override
Where Meta delivers a WhatsApp Business Account's events. Set as an override on an app's subscription, which is why removing a connection uninstalls it.
WhatsApp webhooks- hub.challenge
A value Meta sends in its verification GET. The endpoint must return it as the raw body. Returning JSON instead is the most common reason a webhook never receives anything.
Webhook verification- messages
The webhook field carrying what customers send. Part of the message path, which is what a webhook override routes away from a provider.
- smb_message_echoes
The webhook field carrying what a team sends from the WhatsApp Business app. Only exists on Coexistence numbers, and is how software sees a human's replies.
- Customer service windowthe 24 hour window
Twenty four hours from the customer's last message, during which free text delivers. Outside it, only an approved template does.
Error 131047- Template
A message submitted to Meta for review in advance. The only thing that delivers outside the customer service window, and on a Coexistence number it can only be sent through the API.
Error 132001- Quality rating
Green, yellow or red, assigned by Meta from how recipients react. Falls before it costs anything, and nothing announces the fall.
Error 131048- Messaging tier
How many unique customers a number may start conversations with per day. Moves in both directions. Distinct from throughput, which is a rate.
- Throughput
Messages per second a number may send. Fixed by Meta on a Coexistence number rather than scaling with quality and tier.
Error 130429- Linked device
The consumer WhatsApp client signed in elsewhere, as WhatsApp Web does. What unofficial tools automate, what WhatsApp's terms prohibit, and what gets numbers banned.
Unofficial API risks- MCPModel Context Protocol
How an AI assistant reaches a tool it does not own. Request and response only: an MCP server cannot be woken by an incoming message.
WhatsApp MCP server
なぜ用語がこれほど混乱を招くのですか?
これらの用語のいくつかは、同じ階層に見えても、実際には異なる階層のものを指すからです。
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 の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める7 日間は料金なし。いつでもキャンセルできます。