InícioBlogConta e API

Conta e API

Coexistência no WhatsApp: app e API no mesmo número, e o que ninguém te conta

A Meta permite usar o aplicativo e a Cloud API no mesmo número. O que sincroniza, o que é desligado de verdade e o erro de ativação que faz você perder o que queria preservar.

Durante anos a resposta foi “não dá”. Você escolhia: ou o número ficava no aplicativo do WhatsApp Business, no celular, ou ia para a API Oficial e sumia do aparelho. Não existia meio-termo.

Existe agora. A Meta documenta um caminho em que o mesmo número opera no aplicativo e na Cloud API ao mesmo tempo, com as conversas espelhadas entre os dois. O mercado batizou de coexistência.

Começo pela parte constrangedora: três artigos deste blog afirmavam que isso era impossível — na comparação entre aplicativo e API, no guia de migração e no artigo sobre o selo. Já corrigimos os três, com nota. Se a promessa aqui é precisão, ela vale contra nós também.

E vale dizer o que este artigo é. A coexistência já foi coberta por meia dúzia de blogs do setor, alguns com bastante cuidado. O problema é que, na hora de listar o que muda, boa parte erra — inclusive de um jeito que faz a pessoa destruir exatamente aquilo que queria preservar. É disso que trata o texto.

O erro que custa o número

Vi mais de uma vez, em português, alguma variação desta instrução:

“Para ativar a coexistência, primeiro migre seu número para a Cloud API e depois habilite o recurso.”

Não faça isso. É o inverso do caminho documentado, e a ordem aqui não é detalhe: se você registra o número na API pelo processo comum, ele sai do aplicativo. Feito isso, não há coexistência para ativar — você acabou de causar a perda que a coexistência serve para evitar.

O caminho documentado parte do outro lado. O número já está no aplicativo, em uso, e é dali que ele é conectado à Cloud API pelo Embedded Signup, o fluxo de onboarding conduzido por um parceiro. A Meta é explícita quanto a quem opera esse fluxo: é preciso ser Solution Partner ou Tech Provider, usar Embedded Signup com registro de sessão e ter um webhook capaz de receber e processar os eventos.

Ou seja: coexistência não é um botão no Gerenciador de Negócios. É um fluxo que passa pelo seu parceiro. Se alguém te mandou habilitar sozinho no Business Manager, essa pessoa não leu a documentação.

Vale dizer também que nem todo parceiro suporta esse caminho — muitos só fazem a migração comum, aquela que tira o número do celular. O AtendeChat suporta coexistência, então os dois caminhos estão na mesa quando você conversa com a gente: dá para decidir pelo que serve à sua operação, e não pelo que o fornecedor consegue fazer.

Do seu lado, o requisito é o aplicativo do WhatsApp Business na versão 2.24.17 ou superior.

O que atravessa para o outro lado

Conectado o número, a documentação prevê a sincronização de:

  • Conversas individuais dos últimos 6 meses (180 dias), entregues em fases: dia 0 ao 1, dia 1 ao 90 e dia 90 ao 180. Elas podem chegar em blocos, ordenáveis por um campo chunk_order.
  • Contatos — todos os que têm número de WhatsApp.

Depois disso, o espelhamento é contínuo e nos dois sentidos: mensagens enviadas e recebidas aparecem tanto na Cloud API quanto no aplicativo.

Dois recortes que costumam passar batido:

Mídia só dos últimos 14 dias. O histórico sincronizado traz as mensagens de 6 meses, mas os arquivos acompanham apenas as mensagens enviadas nos 14 dias anteriores ao onboarding. Conversa antiga chega como texto, sem o anexo.

Grupos não vão. Conversas em grupo não são sincronizadas — seguem existindo no aplicativo, invisíveis para a API.

E há um prazo que é do seu parceiro, não seu, mas que pode te afetar: depois que o cliente conclui o fluxo, existem 24 horas para sincronizar o histórico. Se não acontecer nesse prazo, a documentação diz que o cliente precisa ser desconectado e refazer o processo inteiro. Vale perguntar como o seu parceiro trata isso antes de começar.

Diagrama da coexistência no WhatsApp: o mesmo número no aplicativo WhatsApp Business e na Cloud API ao mesmo tempo. No aplicativo seguem funcionando o catálogo, os grupos, as etiquetas e o perfil comercial, sem alcance da API. Na API ficam os vários atendentes e a automação, com teto de 20 mensagens por segundo. Entre os dois, conversas individuais e contatos são espelhados, com 6 meses de histórico. Listas de transmissão, mensagens temporárias, ver uma vez, localização em tempo real e dispositivos conectados são desligados
O que é espelhado, o que fica só no app e o que é desligado quando o número entra em coexistência

O engano das duas colunas

Aqui está a imprecisão mais difundida, e ela é honesta: nasce de uma leitura razoável de uma tabela mal sinalizada.

A documentação lista os recursos do aplicativo em duas colunas. Uma diz o que muda no aplicativo. A outra diz se o recurso é suportado pela Cloud API. São perguntas diferentes, e quase todo mundo lê só a segunda.

Para etiquetas, respostas rápidas, mensagem de saudação, mensagem de ausência, catálogo, pedidos, status, perfil comercial, grupos e chamadas de voz e vídeo, a tabela diz:

Coluna O que está escrito
Mudanças no app “No change.”
Suporte na Cloud API “Not supported.”

Traduzindo com precisão: esses recursos continuam funcionando normalmente no aplicativo. O que não acontece é a API enxergá-los ou controlá-los. Suas etiquetas não somem — elas simplesmente não chegam à plataforma. Seu catálogo continua lá, atendendo o cliente que abre o perfil — só não dá para gerenciá-lo pela API.

Circula em português a afirmação de que essas ferramentas “deixam de operar”. Não é o que está escrito. E a diferença é enorme para quem decide: perder as etiquetas seria um motivo legítimo para não ativar; não ter as etiquetas replicadas na plataforma é um inconveniente de organização.

O que é desligado de verdade

A mesma tabela tem uma lista bem menor de perdas reais, essas sim no aplicativo:

  • Listas de transmissão são desabilitadas. Não dá para criar novas, e as existentes viram somente leitura.
  • Mensagens temporárias são desligadas nas conversas individuais.
  • Ver uma vez é desabilitado nas conversas individuais.
  • Localização em tempo real é desabilitada nas conversas individuais.
  • Dispositivos conectados são todos desvinculados no momento do onboarding. Você reconecta depois — até quatro —, mas WhatsApp para Windows e para WearOS não são suportados. Mensagem visualizada num dispositivo não suportado aparece como texto de espera, mandando o usuário abrir no aparelho principal.

Repare que a lista de perdas é curta e específica. Para a maioria das operações, a única que dói é a das listas de transmissão — e ela tem substituto melhor do outro lado, porque disparo em escala com template é justamente o que a API faz, com as regras que já tratamos em disparo em massa no WhatsApp.

Um ganho que anda listado como perda

Encontrei conteúdo colocando “editar e apagar mensagem” entre os recursos desativados pela coexistência. A documentação diz o contrário, na linha das conversas individuais: “Message Edit/Revoke is now supported.” É melhoria, não perda.

O teto de 20 mensagens por segundo

Este é o número mais importante do artigo para quem envia volume, e é o que quase nunca aparece nas listas de benefícios.

Enquanto o número estiver nos dois lados, ele tem throughput fixo de 20 mensagens por segundo. A documentação explica o porquê sem rodeio: é para continuar compatível com o aplicativo.

Cuidado para não confundir dois limites diferentes:

  • Throughput é velocidade — quantas mensagens por segundo saem. Aqui, travadas em 20.
  • Limite de envio é volume — quantos clientes você inicia conversa a cada 24 horas. Esse continua seguindo a escada normal da plataforma, que explicamos em quantas mensagens posso enviar por dia.

Na prática, 20 mps dão 72 mil mensagens por hora. Para a esmagadora maioria das operações brasileiras isso é folga, não teto. Mas se o seu caso é campanha de centenas de milhares de disparos em janela curta, a coexistência cobra esse preço — e aí a pergunta é se manter o número no celular vale o limite de velocidade.

Quem paga o quê

A regra é direta e vale a pena entender antes da primeira fatura: mensagens enviadas pelo aplicativo continuam gratuitas; mensagens enviadas pela Cloud API entram na tarifação da API.

Isso cria uma situação nova. O mesmo cliente, na mesma conversa, pode custar ou não custar dependendo de onde o atendente respondeu. Vale combinar isso com o time — não para empurrar todo mundo para o celular, mas para ninguém se surpreender quando o relatório de custo não bater com a intuição. A lógica de cobrança em si é a mesma da janela de 24 horas.

Como sair

Se não der certo, a saída é do lado do cliente e não depende de abrir chamado: no aplicativo, em Configurações → Conta → Plataforma de negócios, existe o botão de desconectar a conta. O parceiro é avisado por um webhook account_update com o evento PARTNER_REMOVED, que traz quem iniciou a desconexão e o motivo.

Uma ressalva honesta: li em mais de um lugar que, ao desconectar, o número volta ao aplicativo “com todos os recursos restaurados”. Isso não consta na documentação que consultamos. É plausível — os recursos foram desligados por causa da integração — mas plausível não é documentado, e se as suas listas de transmissão são críticas, essa é uma pergunta para o parceiro antes de entrar, não depois.

O que a documentação não responde

Três perguntas que aparecem muito e que eu não consigo responder com fonte primária. Prefiro dizer isso a inventar:

Desde quando existe. Encontrei “beta em fevereiro de 2025”, “desde 2024” e “lançado oficialmente em 2026” — em blogs diferentes, todos afirmando com segurança. As páginas de documentação que consultamos não datam o recurso, e o changelog da Meta não respondeu durante a apuração. Como a data não muda nenhuma decisão sua, deixo sem.

Se conta nova é elegível. Circula a recomendação de usar o aplicativo por um tempo antes de ativar. Não consta nas páginas que lemos nenhum requisito de idade da conta — o único requisito de app documentado é a versão 2.24.17.

Se dá para ter a conta oficial em coexistência. Essa é interessante. A documentação da conta oficial diz, literalmente, que o selo não é concedido a “WhatsApp Business app phone numbers”. Um número em coexistência é, ao mesmo tempo, número do aplicativo e número da API — e a documentação não trata desse caso. Quem afirmar que dá, ou que não dá, está preenchendo lacuna com opinião. Considerando o que escrevemos sobre o selo de verificado, o ponto é secundário: a conta oficial já é inalcançável para quase todo mundo por causa do critério de notabilidade.

Para quem isso faz sentido

A coexistência resolve um medo específico, e é bom saber se ele é o seu.

Faz sentido quando o número já tem anos de histórico e relacionamento no celular, quando o dono ou o vendedor não abre mão de responder pelo aparelho, e quando a resistência à API sempre foi “não quero perder o que está no telefone”. Ela remove o custo emocional da migração, que costuma ser maior que o técnico.

Faz menos sentido quando a operação já é toda por plataforma e ninguém atende pelo celular. Aí a coexistência só adiciona o teto de 20 mps e a superfície de confusão de ter dois lugares para responder — sem entregar nada que você use. Nesse caso, a API pura é mais limpa.

E ela não muda a decisão de fundo entre aplicativo e API Oficial: continua valendo escolher pela operação. O que a coexistência muda é que essa escolha deixou de custar o seu histórico.

Antes de mexer no seu número

Repare no ponto que atravessa o artigo inteiro: os dois caminhos partem do mesmo número, mas são irreversíveis em sentidos diferentes. Migrar pelo processo comum tira o número do celular e fecha a porta da coexistência. Escolher errado aqui custa histórico, tempo de operação parada e, às vezes, o número.

É por isso que essa decisão não deveria ser tomada lendo blog — nem este. Ela depende de como a sua equipe atende hoje, de quantos atendentes vão operar o número e de quanto do seu processo vive fora do WhatsApp.

O AtendeChat suporta coexistência. Na prática, isso significa que você não precisa escolher entre manter o número no celular e ter uma operação de verdade na API: o número que seus clientes já conhecem continua no aparelho, com o histórico, enquanto a sua equipe passa a atender pela plataforma — vários atendentes no mesmo número, fila de distribuição, histórico centralizado, funil e relatórios.

Somos parceiros oficiais da Meta e conduzimos com você o processo inteiro: a verificação de negócio, o onboarding do número e a aprovação dos templates. E, por fazermos os dois caminhos, a conversa começa pela sua operação em vez de começar pela limitação do fornecedor.

Fale com a gente antes de registrar o número: a conversa de dez minutos evita o erro que não tem desfazer.

Fontes

  1. Meta — Onboard WhatsApp Business app users: sincronização em fases, tabela de recursos, throughput de 20 mps, versão mínima do app e desconexão
  2. Meta — Business phone numbers: limites de números por portfólio e regras do número
  3. Meta — Migrate an existing WhatsApp number to a business account: preservação do histórico no onboarding via parceiro
  4. Meta — Official Business Accounts: critérios da conta oficial e exclusão de números do aplicativo

Rode seu WhatsApp na API Oficial da Meta

O AtendeChat é parceiro oficial da Meta: multiatendimento, Kanban, campanhas e IA — dentro das regras.

Leia também