Voltar ao blog
API do WhatsApp

Coexistência no WhatsApp: app Business e API no mesmo número

Coexistência no WhatsApp: use o app Business no celular e a API oficial no mesmo número. Requisitos, o que sincroniza, custos e cuidados no dia a dia.

Equipe Vamo8 min de leitura
Mesa de escritório com dois celulares, um tablet e notebooks
Foto: Jakub Żerdzicki no Unsplash

Coexistência é o recurso da Meta que deixa o mesmo número funcionando ao mesmo tempo no app WhatsApp Business do celular e na API oficial (a Cloud API). As conversas individuais ficam espelhadas nos dois lados, o que você manda pelo app continua grátis e o que sai pela API segue a tabela de preços da Meta. A ativação é feita por um parceiro oficial, lendo um QR code no app.

Por que isso importa para a loja

Até pouco tempo, a escolha era dura. Ou a loja ficava no app WhatsApp Business, com o vendedor respondendo pelo celular, ou migrava o número para a API e perdia o app de vez. Muita loja de celular desistia da API porque o dono não queria largar o celular no balcão, onde ele fecha negócio com o cliente que pergunta "faz por quanto no Pix?".

Com a coexistência, o número é um só. A IA ou o sistema responde pela API, e você continua vendo e respondendo tudo pelo celular. O cliente não percebe diferença nenhuma: fala com o mesmo número de sempre, com o mesmo nome e a mesma foto.

Como funciona na prática

A documentação oficial da Meta sobre coexistência descreve o fluxo assim: no cadastro feito pelo parceiro, você escolhe conectar a conta do app que já existe, informa o número e confirma no próprio WhatsApp Business. Depois disso, a conta do app é convertida numa conta de mensagens da plataforma, mantendo o mesmo identificador.

A partir daí, valem três regras:

  • Mensagem que entra aparece no celular e no sistema.
  • Mensagem que o sistema manda pela API aparece no seu app.
  • Mensagem que você manda pelo celular também chega ao sistema, como um "eco".

Esse eco é o que permite a um sistema bem feito saber que você assumiu a conversa. No Vamo, quando você responde um cliente pelo celular, a IA pausa naquela conversa por 30 minutos (o padrão) para não atropelar o que você está negociando.

O que continua igual no app e o que muda

A mesma página da Meta traz uma tabela do que acontece com cada recurso do app depois da conexão. Para o dia a dia de uma loja, o que importa é isto:

  • Conversas individuais: continuam no app e passam a aparecer na API. Editar e apagar mensagem passa a ser sincronizado.
  • Contatos: continuam no app e podem ser sincronizados com o sistema.
  • Grupos: continuam no app, sem mudança, mas não aparecem na API.
  • Listas de transmissão: são desativadas. Você não cria listas novas e as existentes ficam só para leitura.
  • Mensagens temporárias, visualização única e localização em tempo real: são desligadas nas conversas individuais.
  • Catálogo, etiquetas, respostas rápidas, mensagem de saudação e de ausência: continuam no app como estavam, mas não existem na API.
  • Ligações de voz e vídeo: continuam no app, sem passar pela API.

Os aparelhos conectados (WhatsApp Web, computador, tablet) são desconectados no momento da ativação, e você conecta de novo depois. O WhatsApp para Windows e o de relógio WearOS não são compatíveis com a coexistência.

A troca das listas de transmissão é a que mais pega loja de surpresa. Se você usa lista para avisar chegada de modelo novo, planeje a troca para templates de marketing pela API antes de ativar. O post sobre lista de transmissão no WhatsApp Business compara as duas opções.

Perco minhas conversas ao migrar para a API?

Não. Nada é apagado do seu celular. A questão é o que o sistema do parceiro passa a enxergar.

Durante a conexão, o app pergunta se você quer compartilhar o histórico de conversas com o parceiro. Se você aceitar, a Meta envia ao sistema as conversas individuais dos últimos 180 dias, ou seja, cerca de 6 meses. Fotos e vídeos só vêm junto se tiverem sido trocados nos 14 dias anteriores à conexão; os mais antigos chegam como texto de aviso. Se você recusar, o sistema começa do zero e só vê o que acontecer dali para frente.

A sincronização tem prazo: o parceiro precisa fazê-la em até 24 horas depois da ativação, e ela só acontece uma vez. Para repetir, é preciso desconectar e refazer o cadastro inteiro. Por isso, mantenha o app aberto no celular durante a conexão e pense antes de responder à pergunta do histórico.

Quem pode usar a coexistência

Os requisitos que a Meta publica são:

  • App WhatsApp Business na versão 2.24.17 ou mais nova.
  • Ativação feita por um parceiro oficial (Solution Partner ou Tech Provider), pelo fluxo de cadastro da Meta.
  • Número já registrado e em uso no app.

Existe ainda um filtro de atividade. A lista de erros do cadastro da Meta traz um código específico para número recusado porque "é necessária mais atividade no app WhatsApp Business". A Meta não publica um prazo mínimo. Parceiros como a 360dialog explicam que contas recém-criadas não ficam elegíveis na hora e que a análise considera tempo de conta e qualidade das mensagens; vários provedores recomendam pelo menos 7 dias de uso antes de tentar.

Se o número já estiver ligado a outro parceiro, o cadastro avisa e pede que você desconecte o parceiro antigo no app antes. Depois de desconectar, a Meta pede para esperar cerca de 15 minutos antes de tentar de novo.

Quanto ao país, o Brasil é atendido. O registro de mudanças da Meta mostra que, em outubro de 2025, a coexistência foi liberada também para União Europeia, Reino Unido, Austrália, Japão e outros mercados que antes ficavam de fora.

Quanto custa usar app e API juntos

A Meta é clara nesse ponto: as mensagens que você manda pelo app continuam gratuitas, e só o que sai pela API entra na cobrança por mensagem. A janela de 24 horas também vale só para a API. O que você responde pelo celular não abre, não estende e não afeta a janela nem a fatura.

Pela API, a lógica é a de sempre: respostas dentro da janela de 24 horas são mensagens de serviço (1.000 grátis por número no mês, depois R$ 0,035 cada para números do Brasil, na tabela em reais), e fora da janela só sai template, com preço por categoria. Um detalhe que confunde: se um cliente mandou mensagem pouco antes da ativação, a API não tem janela aberta com ele e só pode responder com template. Você, pelo celular, responde normalmente. Os números completos estão no post sobre quanto custa a API oficial do WhatsApp.

Cuidados no dia a dia

Alguns hábitos evitam dor de cabeça:

  1. Abra o app no celular principal com frequência. Provedores como a 360dialog pedem que ele seja aberto pelo menos uma vez a cada 13 dias; ficar duas semanas sem abrir pode derrubar a conexão.
  2. Não desinstale o app nem troque o chip de aparelho sem planejar. Desinstalar desconecta a conta da API.
  3. Combine quem responde o quê. Se a IA atende o primeiro contato e você entra na negociação de preço, a equipe precisa saber disso.
  4. Lembre do limite de velocidade. Número em coexistência envia até 20 mensagens por segundo pela API, o que basta para atendimento e campanhas de loja pequena e média, mas não para disparos gigantes.

Como ativar e como desligar

Para ativar, o roteiro costuma ser:

  1. Atualize o WhatsApp Business no celular.
  2. Entre no sistema do parceiro e abra o cadastro do WhatsApp, logado com a conta do Facebook que é dona do portfólio da empresa (acesso de funcionário costuma falhar).
  3. Escolha conectar o app existente, informe o número e confirme no celular lendo o QR code.
  4. Decida se compartilha o histórico de conversas.
  5. Mantenha o app aberto até o parceiro confirmar que terminou.

Para desligar, vá no app em Configurações, Conta, Plataforma comercial, escolha o parceiro e toque em Desconectar. O número continua no app como antes, e a API para de funcionar com ele.

Quando a coexistência não é a melhor escolha

Ela foi pensada para empresa pequena e média que já usa o app e quer automatizar sem trocar de número. Se a sua operação tem dezenas de atendentes, volume muito alto de envio ou precisa de recursos que só existem na API pura (como chamadas pela API), um número dedicado só para a API pode servir melhor.

Para a maioria das lojas de celular que vendem pelo Instagram e pelo WhatsApp, a coexistência resolve o impasse: o dono segue no celular, e o atendimento das 23h de domingo deixa de depender dele. É dessa forma que o Vamo conecta o número da loja, pela API oficial da Meta, sem tirar o app do seu bolso.

Perguntas frequentes

Posso usar o WhatsApp Business no celular e a API ao mesmo tempo?

Sim, com a coexistência. O mesmo número fica ativo no app do celular e na API oficial, e as conversas individuais aparecem nos dois lados. A ativação é feita por um parceiro oficial da Meta.

Perco minhas conversas ao migrar para a API?

Não. As conversas continuam no seu celular. Durante a conexão, você escolhe se compartilha o histórico com o parceiro; se compartilhar, a Meta permite sincronizar até 6 meses de conversas individuais.

O que acontece com a lista de transmissão e os grupos?

Os grupos continuam funcionando no app, mas não aparecem na API. As listas de transmissão são desativadas: você não cria novas e as antigas ficam só para leitura. Para campanhas, o caminho passa a ser template pela API.

Quais números podem usar coexistência?

Números que já estão em uso no app WhatsApp Business, na versão 2.24.17 ou mais nova, com histórico de atividade. Contas recém-criadas costumam ser recusadas até terem mais uso, e o Brasil é um dos países atendidos.