Glossário de WhatsApp Coexistence
Os termos de WhatsApp Coexistence confundem-se facilmente, e grande parte da confusão surge quando duas pessoas usam a mesma palavra para coisas diferentes. Estas são as definições usadas neste site, cada uma ligada à página que a explica em detalhe.
- 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
Porque é que o vocabulário causa tantos problemas?
Porque vários destes termos designam coisas situadas em níveis diferentes, mas que parecem estar todas no mesmo nível.
Um Business Portfolio contém uma WhatsApp Business Account, que contém números de telefone, cada um com um phone number id. Numa conversa, os quatro acabam por ser chamados de conta, e uma frase como verificar se a conta está a funcionar pode significar quatro verificações diferentes. O mesmo acontece com as duas janelas de 24 horas desta plataforma, que medem coisas sem relação entre si e são constantemente trocadas.
A outra metade do problema é que a Meta e os fornecedores usam palavras diferentes para a mesma coisa, e os próprios fornecedores também não estão de acordo. Esta página usa o vocabulário da Meta quando ele existe e indica claramente quando um termo é nosso.
Que distinções são realmente importantes na prática?
Três, e cada uma já custou um dia de trabalho a alguém.
A janela de atendimento ao cliente e a janela de sincronização duram ambas 24 horas, mas não têm qualquer relação. Uma determina se o texto livre é entregue, contando desde a última mensagem do cliente. A outra determina se o histórico de conversas ainda pode ser obtido, contando desde a integração.
Um dispositivo ligado não é uma API. É o cliente WhatsApp de consumidor com sessão iniciada noutro local, que é aquilo que as ferramentas não oficiais automatizam e que leva ao bloqueio de números.
E um destino de webhook não é uma definição de um número. É uma substituição na subscrição de uma aplicação a uma conta, razão pela qual desaparece quando uma ligação é removida e tem de ser reposta ao ligar novamente.
Perguntas frequentes
Coexistence é uma API diferente da Cloud API?
Não. Coexistence é uma forma de integrar um número na Cloud API, mantendo a aplicação WhatsApp Business a funcionar nesse número. Os endpoints, o formato das mensagens e as regras são idênticos.
Qual é a diferença entre um Business Portfolio e uma WABA?
O Business Portfolio é o contentor da empresa no Meta Business Manager. Uma WhatsApp Business Account fica dentro dele e contém os números de telefone. Um portefólio pode conter várias WABAs.
Um BSP é o mesmo que um Tech Provider?
Sobrepõem-se, mas descrevem coisas diferentes. Tech Provider é um estado atribuído pela Meta que permite a uma empresa ligar números de outras empresas através da sua própria aplicação. BSP costuma designar uma empresa que vende uma plataforma de mensagens, podendo ou não ter esse estado.
O que é que o MCP tem a ver com o WhatsApp?
Nada por si só. MCP é um protocolo que dá a um assistente de IA acesso a uma ferramenta, e um servidor MCP do WhatsApp expõe um número como uma dessas ferramentas. Não pode receber mensagens, apenas agir quando lhe é pedido.
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoNada é cobrado durante 7 dias. Cancele quando quiser.