EntrarComeçar teste grátis
Meta Tech Provider

Glossário da Coexistência do WhatsApp

Os termos em volta da Coexistência do WhatsApp são fáceis de confundir, e a maior parte da confusão na prática vem de duas pessoas usando uma palavra para coisas diferentes. Estas são as definições que este site usa, cada uma ligada à página que a cobre direito.

A EasyCoexistence conecta um número pelo fluxo da própria Meta e depois vigia a conexão.

Não guardamos mensagens por padrãoBusiness App + Cloud APIMCP para Claude e ChatGPTNo ar em 2 minutos
CoexistênciaCoexistence

O modo oficial da Meta para usar o app do WhatsApp Business e a Cloud API no mesmo número ao mesmo tempo. Não é uma API separada: é a mesma Cloud API, conectada de um jeito que mantém o app funcionando.

Coexistência do WhatsApp
Cloud API

A API da WhatsApp Business Platform hospedada pela Meta. Todo envio, template e webhook deste site passa por ela.

Cloud API ou Coexistência
App do WhatsApp BusinessWhatsApp Business app

O app que uma empresa usa no celular. É diferente do WhatsApp comum, e o número precisa estar nele antes que a Coexistência possa conectá-lo.

Conta do WhatsApp BusinessWABA

O objeto da Meta que guarda os números de telefone e os templates. Fica dentro de um Portfólio de Negócios. Os overrides de webhook são aplicados neste nível, não por número.

Portfólio de NegóciosBusiness Portfolio

O contêiner de nível de empresa no Meta Business Manager. Guarda uma ou mais contas do WhatsApp Business. O número de um cliente fica no portfólio dele, não no de um provedor.

Meta Tech Provider
Phone number id

O identificador da Meta para um número conectado. O envio aponta para ele, e não para o número em si, e ele aparece em todo payload de webhook recebido.

Embedded Signup

O popup de onboarding da própria Meta. Escolhe o portfólio, a conta e o número, e na Coexistência inclui um código escaneado no app do WhatsApp Business.

Como um número se conecta
Tech Provider

Um status da Meta que permite a uma empresa conectar números de outros negócios pelo próprio app aprovado. É gratuito, condicionado à verificação da empresa e ao App Review. Não é um endosso.

O que significa
BSPBusiness Solution Provider

Uma empresa que vende uma plataforma de mensageria, geralmente uma caixa de entrada compartilhada. Se sobrepõe a Tech Provider, mas descreve o produto, e não o status na Meta.

Coexistência ou um BSP
Destino de webhookwebhook override

Para onde a Meta entrega os eventos de uma conta do WhatsApp Business. É definido como um override na assinatura de um app, e é por isso que remover uma conexão o desinstala.

Webhooks do WhatsApp
hub.challenge

Um valor que a Meta envia no GET de verificação. O endpoint precisa devolvê-lo como corpo bruto. Devolver JSON no lugar é o motivo mais comum de um webhook nunca receber nada.

Verificação do webhook
messages

O campo de webhook que traz o que os clientes enviam. Faz parte do caminho das mensagens, que é o que um override de webhook desvia de um provedor.

smb_message_echoes

O campo de webhook que traz o que uma equipe envia pelo app do WhatsApp Business. Só existe em números com Coexistência, e é assim que um software enxerga as respostas de uma pessoa.

Janela de atendimentoa janela de 24 horas

Vinte e quatro horas a partir da última mensagem do cliente, durante as quais texto livre é entregue. Fora dela, só um template aprovado é entregue.

Erro 131047
Template

Uma mensagem enviada à Meta para revisão com antecedência. A única coisa que é entregue fora da janela de atendimento, e num número com Coexistência só pode ser enviada pela API.

Erro 132001
Classificação de qualidadeQuality rating

Verde, amarela ou vermelha, atribuída pela Meta a partir de como os destinatários reagem. Cai antes de custar qualquer coisa, e nada avisa a queda.

Erro 131048
Nível de mensagensMessaging tier

Com quantos clientes únicos um número pode iniciar conversas por dia. Muda nas duas direções. É diferente de throughput, que é uma taxa.

Throughput

Mensagens por segundo que um número pode enviar. Fixado pela Meta num número com Coexistência, em vez de crescer com a qualidade e o nível.

Erro 130429
Dispositivo vinculadoLinked device

O cliente comum do WhatsApp logado em outro lugar, como faz o WhatsApp Web. É o que ferramentas não oficiais automatizam, o que os termos do WhatsApp proíbem e o que faz números serem banidos.

Riscos da API não oficial
MCPModel Context Protocol

Como um assistente de IA alcança uma ferramenta que não é dele. Só requisição e resposta: um servidor MCP não pode ser acordado por uma mensagem recebida.

Servidor MCP de WhatsApp

Por que o vocabulário dá tanto problema?

Porque vários destes termos nomeiam coisas em níveis diferentes que parecem todas do mesmo nível.

Um Portfólio de Negócios contém uma conta do WhatsApp Business, que contém números de telefone, cada um com um phone number id. Na conversa os quatro viram a conta, e uma frase como confere se a conta está funcionando pode significar quatro verificações diferentes. O mesmo acontece com as duas janelas de vinte e quatro horas desta plataforma, que medem coisas sem relação e são trocadas uma pela outra o tempo todo.

A outra metade é que a Meta e os provedores usam palavras diferentes para a mesma coisa, e os provedores também não concordam entre si. Esta página usa o vocabulário da própria Meta onde ele existe, e diz claramente quando um termo é nosso.

Quais distinções importam de fato na prática?

Três, e cada uma já custou um dia de alguém.

A janela de atendimento e a janela de sincronização têm ambas vinte e quatro horas e nada a ver uma com a outra. Uma governa se o texto livre entrega, contada a partir da última mensagem do cliente. A outra governa se o histórico ainda pode ser puxado, contada a partir do onboarding.

Um dispositivo vinculado não é uma API. É o cliente comum do WhatsApp logado em outro lugar, que é o que ferramentas não oficiais automatizam e o que derruba números.

E destino de webhook não é uma configuração do número. É um override na assinatura de um app a uma conta, e é por isso que ele some quando uma conexão é removida e precisa ser reposto na reconexão.

Perguntas frequentes

Coexistência é uma API diferente da Cloud API?

Não. Coexistência é um jeito de conectar um número à Cloud API que deixa o app do WhatsApp Business funcionando nele. Os endpoints, o formato de mensagem e as regras são idênticos.

Qual a diferença entre Portfólio de Negócios e WABA?

O Portfólio de Negócios é o contêiner de nível de empresa no Meta Business Manager. Uma conta do WhatsApp Business fica dentro dele e guarda os números. Um portfólio pode conter várias WABAs.

BSP é a mesma coisa que Tech Provider?

Se sobrepõem, mas descrevem coisas diferentes. Tech Provider é um status da Meta que permite a uma empresa conectar números de outros negócios pelo próprio app. BSP costuma descrever uma empresa que vende uma plataforma de mensageria, que pode ou não ter esse status.

O que MCP tem a ver com WhatsApp?

Nada por natureza. MCP é um protocolo para dar a um assistente de IA acesso a uma ferramenta, e um servidor MCP de WhatsApp expõe um número como uma dessas ferramentas. Ele não recebe mensagens, só age quando solicitado.

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátisNada é cobrado por 3 dias. Cancele quando quiser.

Continue lendo