Glossaire WhatsApp Coexistence
Les termes liés à WhatsApp Coexistence sont faciles à confondre. En pratique, la plupart des confusions viennent de deux personnes qui utilisent un même mot pour désigner des choses différentes. Voici les définitions utilisées sur ce site, chacune renvoyant vers la page qui la détaille.
- 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
Pourquoi ce vocabulaire pose-t-il autant de problèmes ?
Parce que plusieurs de ces termes désignent des éléments situés à des niveaux différents, qui donnent pourtant tous l'impression d'être au même niveau.
Un Business Portfolio contient un WhatsApp Business Account, qui contient des numéros de téléphone, chacun avec un phone number id. Dans une conversation, les quatre sont appelés le compte, et une phrase comme vérifiez que le compte fonctionne peut désigner quatre vérifications différentes. Il en va de même pour les deux fenêtres de vingt-quatre heures sur cette plateforme : elles mesurent des choses sans rapport et sont constamment confondues.
L'autre moitié du problème vient du fait que Meta et les fournisseurs utilisent des mots différents pour désigner la même chose, et que les fournisseurs ne sont pas non plus d'accord entre eux. Cette page utilise le vocabulaire de Meta lorsqu'il existe et indique clairement lorsqu'un terme vient de nous.
Quelles distinctions comptent réellement en pratique ?
Trois, et chacune a déjà fait perdre une journée à quelqu'un.
La fenêtre de service client et la fenêtre de synchronisation durent toutes deux vingt-quatre heures, mais n'ont rien à voir l'une avec l'autre. La première détermine si un texte libre peut être remis, à partir du dernier message du client. La seconde détermine si l'historique des discussions peut encore être récupéré, à partir de l'intégration.
Un appareil lié n'est pas une API. Il s'agit du client WhatsApp grand public connecté ailleurs, ce qu'automatisent les outils non officiels et ce qui entraîne le bannissement de numéros.
Et une destination webhook n'est pas un paramètre d'un numéro. Il s'agit d'une surcharge de l'abonnement d'une application à un compte. C'est pourquoi elle disparaît lorsqu'une connexion est supprimée et doit être rétablie lors de la reconnexion.
Questions fréquemment posées
Coexistence est-elle une API différente de Cloud API ?
Non. Coexistence est une méthode d'intégration d'un numéro à Cloud API qui laisse l'application WhatsApp Business fonctionner sur celui-ci. Les endpoints, le format des messages et les règles sont identiques.
Quelle est la différence entre un Business Portfolio et un WABA ?
Le Business Portfolio est le conteneur de l'entreprise dans Meta Business Manager. Un WhatsApp Business Account se trouve à l'intérieur et contient les numéros de téléphone. Un portfolio peut contenir plusieurs WABA.
Un BSP est-il la même chose qu'un Tech Provider ?
Ces notions se recoupent, mais désignent des choses différentes. Tech Provider est un statut Meta qui permet à une entreprise de connecter les numéros d'autres entreprises via sa propre application. BSP désigne généralement une entreprise qui vend une plateforme de messagerie, qu'elle possède ou non ce statut elle-même.
Quel est le rapport entre MCP et WhatsApp ?
Aucun en soi. MCP est un protocole qui donne à un assistant IA l'accès à un outil, et un serveur WhatsApp MCP expose un numéro comme l'un de ces outils. Il ne peut pas recevoir de messages, mais seulement agir lorsqu'on le lui demande.
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitAucun frais pendant 7 jours. Annulez à tout moment.