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.
A EasyCoexistence liga um número através do fluxo da Meta e acompanha a ligação.
- Coexistence
O modo oficial da Meta para usar a app do WhatsApp Business e a Cloud API no mesmo número em simultâneo. Não é uma API à parte: é a mesma Cloud API, integrada de forma a que a aplicação continue a funcionar.
WhatsApp Coexistence- Cloud API
A API da WhatsApp Business Platform alojada pela Meta. Todos os envios, templates e webhooks deste site passam por ela.
Cloud API ou Coexistence- Aplicação WhatsApp BusinessWhatsApp Business app
A aplicação que uma empresa usa no telemóvel. É diferente da aplicação WhatsApp de consumidor, e o número tem de estar nela antes de o Coexistence o poder ligar.
- WhatsApp Business AccountWABA
O objeto da Meta que contém os números de telefone e os templates. Fica dentro de um Portefólio empresarial. As substituições de webhook são aplicadas a este nível e não por número.
- Portefólio empresarialBusiness Portfolio
O contentor da empresa no Meta Business Manager. Contém uma ou mais WhatsApp Business Accounts. O número de um cliente fica no portefólio dele, não no de um fornecedor.
Meta Tech Provider- Phone number id
O identificador da Meta para um número ligado. Os envios apontam para ele e não para o número em si, e aparece em todos os payloads de webhook recebidos.
- Embedded Signup
A janela de integração da própria Meta. Escolhe o portefólio, a conta e o número e, no Coexistence, inclui um código lido na app do WhatsApp Business.
Como um número é ligado- 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 aprovada. É gratuito e depende da verificação da empresa e do App Review. Não é um aval da Meta.
O que significa- BSPBusiness Solution Provider
Uma empresa que vende uma plataforma de mensagens, normalmente uma caixa de entrada partilhada. Sobrepõe-se ao Tech Provider, mas descreve o produto e não o estado atribuído pela Meta.
Coexistence ou um BSP- Destino de webhookwebhook override
O local para onde a Meta entrega os eventos de uma WhatsApp Business Account. É definido como uma substituição na subscrição de uma aplicação, e é por isso que remover uma ligação o desinstala.
Webhooks do WhatsApp- hub.challenge
Um valor que a Meta envia no seu GET de verificação. O endpoint tem de o devolver como corpo em bruto. Devolver JSON em vez disso é o motivo mais comum para um webhook nunca receber nada.
Verificação do webhook- messages
O campo de webhook que transporta o que os clientes enviam. Faz parte do percurso das mensagens, que é o que uma substituição de webhook desvia de um fornecedor.
- smb_message_echoes
O campo de webhook que transporta o que uma equipa envia a partir da app do WhatsApp Business. Só existe em números com Coexistence, e é assim que o software vê as respostas de uma pessoa.
- Janela de atendimento ao clientea janela de 24 horas
Vinte e quatro horas a partir da última mensagem do cliente, durante as quais o texto livre é entregue. Fora dela, só um template aprovado é entregue.
Erro 131047- Template
Uma mensagem submetida previamente à Meta para revisão. É a única coisa entregue fora da janela de atendimento ao cliente e, num número com Coexistence, só pode ser enviada através da API.
Erro 132001- Classificação de qualidadeQuality rating
Verde, amarela ou vermelha, atribuída pela Meta com base na reação dos destinatários. Desce antes de custar alguma coisa, e nada anuncia a descida.
Erro 131048- Nível de mensagensMessaging tier
Com quantos clientes únicos um número pode iniciar conversas por dia. Muda nos dois sentidos. É diferente do throughput, que é uma taxa.
- Throughput
Mensagens por segundo que um número pode enviar. Num número com Coexistence é fixado pela Meta, em vez de aumentar com a qualidade e o nível.
Erro 130429- Dispositivo ligadoLinked device
O cliente WhatsApp de consumidor com sessão iniciada noutro local, como faz o WhatsApp Web. É o que as ferramentas não oficiais automatizam, o que os termos do WhatsApp proíbem e o que leva ao bloqueio de números.
Riscos da API não oficial- MCPModel Context Protocol
A forma como um assistente de IA chega a uma ferramenta que não é sua. Apenas pedido e resposta: um servidor MCP não pode ser despertado por uma mensagem recebida.
Servidor MCP do WhatsApp
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 3 dias. Cancele quando quiser.