Blog

Resumo em uma frase: o WhatsApp CoEx (Coexistence) permite conectar o número que já funciona no aplicativo WhatsApp Business à API oficial da Meta e usar os dois ao mesmo tempo, com as conversas espelhadas entre o celular e a plataforma de atendimento, CRM ou chatbot da empresa.

Durante anos, migrar para a API oficial do WhatsApp exigia um sacrifício: o número deixava de funcionar no aplicativo. A empresa ganhava automação, múltiplos atendentes e integrações, mas perdia a rotina que o time já dominava no celular. Muitos negócios adiavam a migração por medo de perder o histórico, os contatos e a agilidade do app.

O WhatsApp CoEx acabou com essa escolha binária. Com a coexistência, o mesmo número atende pelo aplicativo WhatsApp Business e pela WhatsApp Business Platform (Cloud API) simultaneamente. O dono do negócio continua respondendo pelo celular enquanto o chatbot qualifica leads, o CRM registra cada conversa e a equipe atende em escala pela plataforma.

Este guia foi revisado em 29 de julho de 2026 e reúne o que a documentação oficial da Meta e os parceiros oficiais publicam sobre o recurso, incluindo detalhes técnicos que raramente aparecem em português: os webhooks de coexistência, a janela de 24 horas para sincronizar o histórico, a regra de abrir o aplicativo a cada poucos dias e a lista completa do que deixa de funcionar. Recursos, limites e preços mudam com frequência; confirme os pontos sensíveis nos links oficiais listados ao final.

O que é o WhatsApp CoEx

O WhatsApp CoEx (abreviação de Coexistence, ou coexistência) é um recurso oficial da Meta que permite usar o mesmo número no aplicativo WhatsApp Business e na API oficial (Cloud API) ao mesmo tempo, com conversas e contatos espelhados entre o celular e a plataforma de atendimento da empresa.

Na documentação da Meta, o recurso aparece como Onboarding WhatsApp Business App Users: um fluxo que conecta a conta existente do aplicativo WhatsApp Business à Cloud API sem desativar o app. Com ele, o mesmo número passa a ter duas superfícies de atendimento:

• o aplicativo WhatsApp Business no celular, do jeito que o time já usa;
• a API oficial, conectada a uma plataforma de atendimento, CRM, chatbot ou sistema próprio.

As mensagens enviadas e recebidas são espelhadas entre os dois lados. Uma conversa iniciada no app aparece na plataforma; uma resposta enviada pela API aparece no celular. Contatos criados no aplicativo também são sincronizados com a integração.

O recurso começou em beta em fevereiro de 2025, com o Brasil entre os primeiros países atendidos, e foi expandido ao longo de 2025 e 2026 até se tornar praticamente global, segundo levantamentos de mercado. A Meta não publica uma lista fixa de países: a elegibilidade de cada número é confirmada durante o próprio fluxo de ativação.

Migrar para a API do WhatsApp sem perder o número: o que muda com o CoEx

Antes da coexistência, a empresa tinha três caminhos, todos com um problema sério:

1. Ficar só no aplicativo: simples e gratuito, mas sem automação real, sem vários atendentes de forma organizada e sem integração com sistemas.
2. Migrar para a API oficial: poderosa, mas o número deixava de funcionar no app e o histórico ficava para trás. A operação inteira precisava trocar de ferramenta no mesmo dia.
3. Usar API não oficial: ferramentas que simulam o WhatsApp Web para automatizar o app. Funcionam até o dia em que a Meta detecta o uso e bane o número, sem aviso e sem recurso.

O CoEx cria um quarto caminho: adoção gradual da API oficial, sem abandonar o aplicativo e sem perder as conversas recentes. Os casos de uso mais comuns:

• PME que quer testar automação: o dono segue atendendo pelo app enquanto um chatbot responde fora do horário e a plataforma organiza a fila.
• Time comercial com vendedores em campo: vendedores respondem pelo celular; a gestão acompanha tudo pelo CRM, com histórico consolidado e indicadores de funil.
• Empresa em migração para atendimento estruturado: a equipe muda para a plataforma aos poucos, sem virada única e sem treinar todo mundo de uma vez.
• Operação que precisa de campanhas: disparos de template para listas grandes saem pela API, enquanto o relacionamento um a um continua no app.

Na prática, o CoEx é a forma oficial de ter a API do WhatsApp funcionando junto com o atendimento no celular: a automação roda na nuvem e o número continua ativo no aplicativo.

O que sincroniza e o que não sincroniza

Este é o ponto que mais gera dúvida, e onde a maior parte dos artigos em português é vaga. As regras documentadas pela Meta:

Item	Sincroniza?	Detalhe
Conversas individuais (1:1)	Sim	Até 6 meses (180 dias) de histórico no momento da conexão
Mídias das conversas	Parcial	Apenas mensagens dos últimos 14 dias incluem os arquivos
Contatos da agenda do app	Sim	Todos os contatos com WhatsApp, incluindo adições e remoções futuras
Conversas de grupo	Não	Grupos ficam apenas no aplicativo
Mensagens novas (após conectar)	Sim	Espelhadas em tempo real nos dois sentidos
Etiquetas, respostas rápidas e mensagens automáticas do app	Não	Ferramentas do app não migram para a plataforma

Três regras operacionais importantes que quase ninguém menciona:

• O compartilhamento do histórico é opcional e decidido pelo cliente durante a conexão. Se a empresa recusar, a integração recebe apenas as conversas novas.
• A escolha não pode ser mudada depois. Para compartilhar o histórico mais tarde, é preciso desconectar a conta e refazer todo o processo.
• A sincronização precisa começar em até 24 horas após a conexão. O histórico chega em fases pelos webhooks da Meta: primeiro as conversas do último dia, depois até 90 dias, depois até 180 dias. Se o celular ficar sem internet ou o aplicativo sair de primeiro plano durante esse período, a sincronização pode falhar.
• Nem toda plataforma implementa a importação de histórico. Os 180 dias são uma capacidade da API da Meta, mas cada fornecedor decide se consome esses webhooks. A respond.io, por exemplo, oferece coexistência sem importar o histórico. Confirme esse ponto antes de contratar.

Requisitos para ativar o WhatsApp CoEx

Antes de iniciar a ativação, confira os pré-requisitos:

• Aplicativo WhatsApp Business na versão 2.24.17 ou superior, instalado em um smartphone com câmera.
• Número já ativo no aplicativo, com uso real. A Meta avalia idade da conta e qualidade das mensagens; contas recém-criadas podem não ser elegíveis de imediato. Parceiros recomendam pelo menos uma a quatro semanas de uso genuíno.
• Uma plataforma ou integração que suporte coexistência. A ativação acontece pelo Embedded Signup de um Solution Partner ou Tech Provider da Meta. Nem todo fornecedor suporta: a Twilio, por exemplo, não oferece coexistência. Entre os que documentam suporte estão 360dialog, Infobip, WATI, respond.io, SleekFlow e outros. Uma empresa também pode se tornar Tech Provider e ativar o recurso na própria integração.
• Conta Meta Business organizada. O fluxo cria os ativos na conta empresarial da Meta, então vale preparar o Business Portfolio antes. O passo a passo completo está no nosso guia de como configurar Meta Business e WhatsApp Embedded Signup.

Um detalhe técnico com prazo: as versões 2 e 3 do Embedded Signup serão desativadas pela Meta em outubro de 2026; integrações próprias devem usar a versão 4 do fluxo. Os detalhes estão na seção para desenvolvedores, mais abaixo.

Como ativar a coexistência do WhatsApp: passo a passo

O fluxo exato varia um pouco conforme a plataforma, mas a espinha dorsal é definida pela Meta:

1. Inicie o Embedded Signup na plataforma escolhida e informe o número que já está no aplicativo WhatsApp Business.
2. Faça login com a conta Meta/Facebook da empresa e selecione ou crie o Business Portfolio.
3. Receba a notificação no celular. O aplicativo WhatsApp Business recebe uma mensagem oficial com o convite para conectar à plataforma de negócios.
4. Escaneie o QR code ou digite o código exibido na tela do Embedded Signup para confirmar que você controla o número.
5. Decida sobre o histórico. O app pergunta se você quer compartilhar as conversas e contatos com a plataforma. Essa escolha é definitiva para esta conexão.
6. Aguarde a sincronização. Contatos chegam em minutos; o histórico completo pode levar de minutos a horas. Mantenha o celular conectado à internet e o aplicativo aberto em primeiro plano no início do processo.

Depois da conexão, o número aparece na plataforma como uma conta da API oficial, com acesso a templates, chatbot, múltiplos atendentes e relatórios, enquanto o aplicativo continua funcionando no celular.

O que muda no aplicativo depois de ativar

A coexistência tem um preço funcional que os materiais comerciais costumam esconder. Ao conectar, alguns recursos do aplicativo são desativados ou limitados. A lista consolidada da documentação oficial e dos parceiros:

Ficam disponíveis apenas no aplicativo (não aparecem na API):

• Grupos e comunidades: continuam funcionando no app, mas não sincronizam com a plataforma.
• Chamadas de voz e vídeo: seguem apenas pelo celular. Números em coexistência não podem usar a Calling API da Meta.
• Status e Canais: publicações continuam possíveis no app, sem visibilidade pela API.
• Catálogo e pedidos: o gerenciamento permanece no aplicativo.

São desativados ou limitados no aplicativo:

• Listas de transmissão: as existentes viram somente leitura; não é possível criar novas.
• Mensagens temporárias e visualização única: desativadas nas conversas individuais.
• Localização em tempo real: desativada.
• Ferramentas de mensagem do app (mensagem de saudação, ausência, respostas rápidas e etiquetas): deixam de operar; essas funções passam a ser papel da plataforma conectada.
• Dispositivos vinculados: todos são desconectados na ativação. WhatsApp Web e WhatsApp para Mac podem ser reconectados; WhatsApp para Windows e WearOS deixam de ser suportados.

Limites da conta em coexistência:

• Throughput fixo de 20 mensagens por segundo, adequado para a maioria das operações, mas insuficiente para disparos massivos de alto volume.
• Selo de conta oficial (OBA, o selo azul) não é suportado nesse modo, segundo parceiros oficiais; a verificação Meta Verified segue caminho próprio.
• A WABA criada para coexistência comporta um único número e não pode ser migrada entre parceiros. A Infobip documenta um limite de quatro WABAs desse tipo por portfólio; outros parceiros, como a 360dialog, não citam limite. Confirme com o seu fornecedor.
• Números em coexistência não usam a Groups API nem a Marketing Messages Lite API.

Regras de operação que evitam sustos

Depois de ativar, três cuidados mantêm a conexão saudável:

1. Abra o aplicativo com frequência. Os parceiros oficiais documentam que o WhatsApp Business precisa ser aberto pelo menos uma vez a cada 13 ou 14 dias. Sem isso, a conexão com a API expira e a entrega de mensagens é afetada.
2. Não desinstale o aplicativo. Desinstalar, excluir a conta ou registrar o número em outro serviço desconecta a integração. Desde 2026, trocar de aparelho ou reinstalar o app aciona um fluxo de reconexão automática em poucos minutos, mas o app precisa continuar existindo.
3. Defina quem responde o quê. Como app e plataforma enxergam as mesmas conversas, sem um combinado claro dois atendentes podem responder o mesmo cliente ao mesmo tempo. Boas práticas: chatbot e campanhas na plataforma, atendimento humano com regra explícita de posse da conversa.

Um comportamento conhecido: logo após a ativação, o primeiro envio pela API pode retornar o erro 131060 (mensagem não suportada). Normalmente se resolve em segundos, sozinho.

Quanto custa usar o WhatsApp CoEx

A coexistência em si não tem cobrança própria da Meta. O custo total combina três componentes:

1. Mensagens enviadas pelo aplicativo: gratuitas. Nada muda em relação ao uso normal do WhatsApp Business.

2. Mensagens enviadas pela API: seguem o pricing oficial da Meta. Desde 1º de julho de 2025, a cobrança é por mensagem de template entregue, não mais por conversa:

• Mensagens de serviço (respostas livres dentro da janela de atendimento de 24 horas): gratuitas.
• Templates de utilidade: gratuitos quando enviados dentro de uma janela de atendimento aberta; fora dela, cobrados por mensagem, com descontos por volume.
• Templates de autenticação: sempre cobrados por mensagem, com valores menores que os de marketing e descontos por volume.
• Templates de marketing: sempre cobrados, com o maior valor por mensagem da tabela.

Para empresas brasileiras, a Meta passou a permitir faturamento em reais a partir de julho de 2026. Os valores exatos por categoria estão no rate card oficial e mudam com o câmbio e a política da Meta; confirme na tabela vigente antes de projetar custos.

3. Mensalidade da plataforma ou o custo da integração própria. Plataformas de atendimento cobram assinatura por número ou por usuário. Uma integração própria via Tech Provider elimina a mensalidade de terceiros, mas exige desenvolvimento e manutenção.

Um detalhe do modelo que joga a favor da coexistência: mensagens enviadas pelo aplicativo não abrem nem estendem a janela de 24 horas da API e não geram cobrança. A conversa humana pelo celular continua gratuita, e a API entra apenas onde a automação agrega valor.

As regras da API continuam valendo

A coexistência não flexibiliza as políticas da WhatsApp Business Platform. No lado da API:

• Janela de atendimento de 24 horas: ao receber uma mensagem do cliente, a empresa tem 24 horas para responder com mensagens livres pela API. A janela só é aberta por mensagens recebidas após a conexão.
• Templates aprovados fora da janela: para iniciar conversa pela API ou responder após as 24 horas, é obrigatório usar um template aprovado pela Meta. Templates são criados e gerenciados apenas pela plataforma, nunca pelo app.
• Opt-in e qualidade: as regras de consentimento para mensagens ativas e o monitoramento de qualidade do número continuam idênticos aos de qualquer conta da API.

Para desenvolvedores: como a coexistência funciona por dentro

Se a sua empresa pretende integrar a API diretamente, sem depender de plataforma de terceiros, estes são os detalhes que fazem diferença no projeto. Nenhum artigo em português cobre este bloco, e ele é decisivo para estimar o esforço de desenvolvimento.

A coexistência adiciona três assinaturas de webhook além do campo messages tradicional:

Webhook	Função
history	Entrega o histórico compartilhado em fases (dia 0 a 1, 1 a 90 e 90 a 180), em blocos com metadados de fase e progresso. Se o cliente recusar o compartilhamento, chega com o código de erro 2593109
smb_message_echoes	Ecoa as mensagens que o negócio envia pelo aplicativo ou por dispositivo vinculado, incluindo edições e exclusões, com o identificador da mensagem original
smb_app_state_sync	Sincroniza os contatos: carga inicial minutos após a conexão e eventos de adição, edição e remoção dali em diante

Pontos de arquitetura que valem atenção:

• Idempotência nos echoes. Trate os handlers de smb_message_echoes como idempotentes, usando o ID da mensagem, e diferencie mensagens originadas no app das enviadas pela própria API para não criar loops nem duplicar registros no CRM.
• Echoes não abrem janela. Mensagens enviadas pelo app não criam janela de atendimento, não disparam automações de entrada e não geram cobrança. A lógica de fluxo do bot deve ignorá-las como gatilho.
• A sincronização é única. O processo de importar histórico e contatos só roda uma vez por conexão e deve ser iniciado em até 24 horas. Falhou ou mudou de ideia, o caminho é desconectar e refazer.
• Ciclo de vida da conexão. A desconexão iniciada pelo cliente gera o webhook account_update com o evento PARTNER_REMOVED e um objeto com o motivo. Há ainda eventos de conta desconectada e reconectada para tratar troca de aparelho. Parceiros não podem usar a Deregister API nessas contas.
• Embedded Signup v4. Novas integrações devem nascer na versão 4 do fluxo. As versões 2 e 3 serão desligadas em 15 de outubro de 2026 e, embora a maioria das integrações antigas seja convertida automaticamente, fluxos de coexistência criados na v2 estão entre os que exigem migração manual.

Esse nível de integração costuma aparecer em projetos que conectam o WhatsApp a sistemas internos, ERPs e CRMs ou que usam agentes de IA no atendimento. Nesses casos, um chatbot com base de conhecimento própria via RAG pela API, convivendo com o atendimento humano pelo app, é exatamente o cenário que a coexistência viabiliza.

App, CoEx ou API pura: qual caminho escolher

Critério	Só o aplicativo	CoEx (app + API)	Só a API
Automação e chatbot	Respostas simples do app	Completa, via plataforma	Completa
Vários atendentes	Até 5 dispositivos, sem gestão	Sim, com o app ainda ativo	Sim
Histórico ao migrar	Não se aplica	Até 180 dias sincronizados	Começa do zero
Grupos e chamadas	Sim	Sim, apenas pelo app	Grupos só via Groups API restrita; chamadas via Calling API
Volume de envio	Baixo	Até 20 mensagens por segundo	Alto, com tiers superiores
Selo de conta oficial (OBA)	Não	Não suportado	Sim, mediante aprovação
Custo Meta	Zero	Mensagens da API conforme tabela	Mensagens conforme tabela
Rotina do time	Mantida	Mantida, com plataforma em paralelo	Muda completamente

Em resumo:

• Fique só no aplicativo se a operação é pequena, o volume é baixo e não há necessidade de integração ou automação.
• Use o CoEx se você quer automação, CRM e atendimento em escala sem abrir mão do celular, ou como fase de transição segura rumo à API.
• Vá direto para a API pura se a operação precisa de alto throughput, selo de conta oficial, Calling API ou Groups API, e o time já não depende do aplicativo.

E sobre APIs não oficiais: com a coexistência disponível, o principal argumento delas (usar automação sem perder o app) deixou de existir. O caminho oficial elimina o motivo mais comum de banimento, a automação irregular sobre o app, um risco que em uma operação comercial significa perder o principal canal de vendas da noite para o dia.

Um alerta de migração para quem já está na API: um número ativo na Cloud API não pode ser convertido diretamente para coexistência. É preciso remover o número da API, reativá-lo no aplicativo WhatsApp Business e então refazer a conexão no modo CoEx.

Como desconectar o CoEx

A reversão é simples e fica no controle do cliente, não da plataforma. No aplicativo WhatsApp Business: Configurações → Conta → Plataforma de negócios → Desconectar conta. A partir daí o número volta a operar apenas no app, com todos os recursos restaurados. As conversas já registradas na plataforma permanecem lá; as novas deixam de ser espelhadas.

Perguntas frequentes sobre WhatsApp CoEx

Preciso desinstalar o WhatsApp Business para usar a API?

Não. Essa é justamente a proposta do CoEx: o app continua instalado e funcionando. Desinstalar o aplicativo desconecta a integração.

Dá para usar a API do WhatsApp no celular?

A API em si roda na nuvem, não no aparelho. O que o CoEx oferece é o efeito prático que a maioria busca nessa pergunta: o número conectado à API continua ativo no aplicativo do celular, e as conversas aparecem nos dois lugares.

Perco minhas conversas e contatos ao ativar?

Não. Você pode sincronizar até 180 dias de conversas individuais e todos os contatos da agenda. Grupos não são sincronizados, e mídias só acompanham as mensagens dos últimos 14 dias. Confirme se a plataforma escolhida implementa a importação de histórico.

O cliente percebe alguma diferença?

Não. Para quem conversa com a empresa, o número, o nome e o perfil continuam os mesmos, independentemente de a resposta sair do app ou da plataforma.

Posso responder pelo app e pela plataforma ao mesmo tempo?

Sim, as duas superfícies enxergam as mesmas conversas individuais. Defina regras internas de posse da conversa para evitar respostas duplicadas.

Mensagens enviadas pelo aplicativo são cobradas?

Não. A cobrança da Meta se aplica apenas aos templates enviados pela API. Conversas pelo app seguem gratuitas e não afetam a janela de 24 horas da API.

O CoEx evita banimento do número?

Ele não dá imunidade: as políticas de qualidade e denúncias continuam valendo. Mas substituir API não oficial por coexistência elimina o motivo mais comum de banimento, que é a automação irregular sobre o app.

Quanto tempo o número precisa ter para ser elegível?

A Meta avalia idade e qualidade da conta e confirma a elegibilidade durante a ativação. Números novos podem ser recusados; parceiros recomendam semanas de uso real antes de tentar.

Funciona com o WhatsApp pessoal?

Não. O CoEx conecta contas do aplicativo WhatsApp Business. Um número pessoal precisaria primeiro migrar para o WhatsApp Business.

WhatsApp Web continua funcionando?

Sim, WhatsApp Web e WhatsApp para Mac podem ser reconectados após a ativação. WhatsApp para Windows e para WearOS não são suportados no modo coexistência.

Posso trocar de celular com o CoEx ativo?

Sim. Desde 2026, trocar de aparelho ou reinstalar o aplicativo aciona um fluxo de reconexão automática em poucos minutos, desde que o número volte a ficar ativo no WhatsApp Business.

O catálogo continua funcionando?

Sim, mas o gerenciamento de catálogo e pedidos permanece apenas no aplicativo, sem visibilidade nem controle pela API.

Conta em CoEx pode ter o selo azul?

O selo de conta oficial (OBA) não é suportado no modo coexistência, segundo parceiros oficiais. A verificação Meta Verified segue um caminho separado e pode ser mantida.

Chatbot e campanhas funcionam junto com o atendimento pelo celular?

Sim. Chatbot, disparos de template e automações rodam pela API enquanto o time responde pelo app. Mensagens do app não disparam as automações da plataforma.

Posso trocar de plataforma depois?

O número em coexistência não migra entre WABAs. Na prática, trocar de fornecedor exige desconectar e refazer a ativação no novo parceiro. Se houver linha de crédito compartilhada com o parceiro anterior, a troca pode exigir ajuste na conta Meta.

Posso voltar atrás?

Sim, a qualquer momento, desconectando pelo próprio aplicativo em Configurações → Conta → Plataforma de negócios.

Conclusão: o CoEx virou a porta de entrada da API oficial

O WhatsApp CoEx resolveu o maior bloqueio da migração para a API oficial: o medo de perder o número, o histórico e a rotina do time. Em 2026, com a cobrança por mensagem, o faturamento em reais e a coexistência disponível de forma ampla, o caminho racional para a maioria das empresas brasileiras deixou de ser "app ou API" e passou a ser "app e API, cada um no seu papel".

A decisão relevante mudou de lugar: não é mais se vale conectar o número à API, e sim o que construir em cima dela. Um chatbot que realmente resolve, integração com ERP e CRM, qualificação automática de leads, painéis de atendimento: é nessa camada que a coexistência gera retorno, e é nela que a diferença entre uma integração bem projetada e um arranjo improvisado aparece.

Quer conectar o WhatsApp da sua empresa a sistemas e IA?

A X-Apps desenvolve integrações com a WhatsApp Business Platform de ponta a ponta: ativação da coexistência, webhooks, CRM, ERP e agentes de IA aplicados ao atendimento, com governança e segurança desde o primeiro commit.

Fontes oficiais e documentação

• Onboarding WhatsApp Business App Users (Coexistence) - Meta for Developers
• Pricing - WhatsApp Business Platform - Meta for Developers
• Webhook smb_message_echoes - Meta for Developers
• Webhook smb_app_state_sync - Meta for Developers
• Cloud API Calling - Meta for Developers
• Groups API - Meta for Developers
• WhatsApp Coexistence - 360dialog Docs
• WhatsApp Business App Coexistence - Infobip Docs
• WhatsApp Coexistence - respond.io Help Center