Coexistência no WhatsApp: use o app e a API oficial no mesmo número

O que é coexistência no WhatsApp?

Coexistência é o modo em que um número do app WhatsApp Business é conectado à Cloud API sem sair do celular. Quem atende continua respondendo pelo app, e o seu sistema passa a receber os mesmos eventos pela API e a enviar por ela. Segundo a Meta, as mensagens enviadas e recebidas ficam espelhadas entre os dois lados.

Antes, ir para a API oficial significava tirar o número do app, mudar a rotina de quem atende e começar a conversa com os clientes do zero no sistema novo. Para muita empresa isso travava a migração: o número tem anos de clientes e o dono não quer largar o celular. A coexistência resolve esse impasse sem trocar de número.

Se você ainda está decidindo como entrar na API oficial, o panorama completo está no guia de como usar a API oficial do WhatsApp.

Quais são os requisitos da coexistência?

O número precisa estar ativo no app WhatsApp Business, na versão 2.24.17 ou mais nova. Além dele, você precisa de uma conta no Facebook e de um portfólio empresarial na Meta, onde ficam a conta do WhatsApp Business e a forma de pagamento das mensagens. A conexão é feita pelo Cadastro Incorporado da Meta, por meio de um parceiro.

• App WhatsApp Business atualizado. Versão 2.24.17 ou mais nova, no celular onde o número já funciona.
• Número no app Business, não no WhatsApp comum. Os dois são apps diferentes e o mesmo número não roda nos dois ao mesmo tempo. Se ele está no WhatsApp comum, transfira a conta para o WhatsApp Business antes, pelo caminho que a própria Central de Ajuda descreve.
• Conta no Facebook e portfólio empresarial. É onde a conta do WhatsApp Business vai morar. Dá para criar o portfólio durante a conexão.
• O celular à mão. A conexão é confirmada dentro do próprio app.
• Forma de pagamento na Meta. Necessária para os templates e para as respostas pela API além das 1.000 grátis do mês.

O que muda e o que fica igual com a coexistência?

As conversas individuais seguem no app e passam a existir também na API. Alguns recursos do app são desligados e outros não passam pela API. A tabela resume o que a documentação da Meta lista para números em coexistência. Leia antes de conectar, principalmente se a operação depende de grupos ou de listas de transmissão.

Um cuidado de rotina: entre os motivos de desconexão que a Meta lista está o celular principal sem uso por cerca de 14 dias. Se o número vive só na automação, alguém precisa abrir o app no aparelho de tempos em tempos.

Quanto custa usar o app e a API no mesmo número?

Mensagem enviada pelo app continua sem custo. Mensagem enviada pela API paga a tarifa da Meta, cobrada direto na forma de pagamento que você cadastrou nela. No Brasil, desde 1 de outubro de 2026, a de marketing custa R$ 0,3217 e as de utilidade e autenticação custam R$ 0,035 cada. A resposta pela API dentro da janela de 24 horas tem 1.000 grátis por número por mês e custa R$ 0,035 da 1.001ª em diante.

Tarifas da tabela em reais da Meta para o Brasil, vigente desde 1 de outubro de 2026. Isso abre um modelo misto: o atendimento humano do dia a dia segue no app, sem tarifa, e a automação (aviso de pedido, confirmação, agente de IA) sai pela API. Por cima, o Omnique cobra por número conectado: R$ 50 por mês para quem tem de 1 a 4 números, sem taxa de ativação. As outras faixas estão em preços.

Como conectar um número em coexistência no Omnique?

O Omnique suporta coexistência. No painel, em Conexões, você escolhe a opção Já uso no app WhatsApp Business, faz login com o Facebook na janela oficial da Meta, informa o número e confirma no app do celular. O número segue no app e passa a entregar os eventos no webhook que você configurar, sem você criar app na Meta.

1. Atualize o app WhatsApp Business no celular para a versão 2.24.17 ou mais nova e deixe o aparelho por perto.
2. No Omnique, abra Conexões, clique em Conectar e escolha Já uso no app WhatsApp Business.
3. Na janela da Meta, entre com o Facebook, escolha ou crie o portfólio empresarial e informe o número.
4. A janela mostra um código. No app, aceite o pedido de conexão com a plataforma, decida se compartilha o histórico de conversas e informe o código.
5. De volta ao Omnique, cadastre a URL de destino dos eventos: um Webhook do n8n, o seu sistema ou outra ferramenta.
6. Nas 24 horas seguintes, decida se quer o histórico e os contatos do app no seu sistema. A tela da instância mostra o prazo.

Em número de coexistência, o Omnique entrega três tipos de evento a mais que num número novo:

• Eco do celular (message.echo): cada mensagem que você digita no app chega ao seu webhook com origin: "outbound_device". Vem ligado, sem nada para configurar.
• Histórico (history.synced): até 180 dias de conversas individuais, sem grupos, entregue em partes. Vem desligado; ligar dentro das 24 horas faz o pedido à Meta.
• Contatos (contacts.synced): a agenda do app, só quem tem WhatsApp, e cada contato adicionado, editado ou removido depois. Mesma regra das 24 horas.

O eco é o que muda o jogo para quem registra atendimento num CRM: a mensagem digitada no celular, fora do sistema, também chega. Numa automação, processe só origin: "inbound" e ignore o que começa com outbound_, para o fluxo não responder a si mesmo. Enquanto a Meta envia o histórico, deixe o app aberto no celular. O formato de cada evento está no guia de webhook do WhatsApp Cloud API e na documentação.

Quer testar com o seu número? Crie a conta e conecte em coexistência; o teste é grátis.

Coexistência ou número novo: quando escolher cada um?

Escolha coexistência quando o número já tem clientes e alguém atende pelo celular: você ganha a API sem trocar de número nem largar o app. Escolha um número novo quando ele vai servir só à automação, quando a vazão fixa de 20 mensagens por segundo pode limitar campanhas grandes ou quando a operação depende de listas de transmissão.

Quem vem de API não oficial costuma ter um número com histórico que não quer perder. Os riscos e a conta de cada caminho estão na comparação entre API oficial e não oficial.

Dá para desfazer a coexistência?

Dá. A desconexão é feita no próprio app WhatsApp Business, no menu de configurações da conta, na área da plataforma de negócios (Settings, Account, Business Platform, no app em inglês). O número continua no app; só deixa de funcionar na API, e o sistema que recebia os eventos para de receber.

Quando isso acontece, a Meta avisa o parceiro com o evento PARTNER_REMOVED. Conectar de novo depois é possível e reabre o prazo de 24 horas para pedir histórico e contatos, o único jeito de recuperar esse pedido se ele não foi feito na primeira conexão.