WhatsApp Coexistence (COEX): como usar o app e a API Oficial no mesmo número

10 min de leitura
WhatsApp Coexistence: app e API Oficial rodando juntos no mesmo número

Atualizado em setembro de 2026

Migrar para a API Oficial do WhatsApp sempre teve um medo por trás: perder o número, perder o histórico de conversa ou deixar a equipe sem acesso ao app enquanto a plataforma nova entra no ar. O WhatsApp Coexistence, ou COEX, é o recurso oficial da Meta que acaba com esse corte seco: o mesmo número passa a funcionar ao mesmo tempo no aplicativo comum do celular e na API Oficial, sem trocar de número e sem apagar o que já existia. Este guia explica o que sincroniza, como ativar e um limite técnico que praticamente ninguém explica direito: quantas mensagens por segundo o número aguenta rodando nos dois ambientes.

O que é o WhatsApp Coexistence (COEX)?

COEX é a funcionalidade oficial da Meta que conecta a conta que já roda no aplicativo WhatsApp Business a uma plataforma que usa a API Oficial (Cloud API), fazendo os dois operarem juntos no mesmo número. Na prática, alguém da equipe continua respondendo pelo celular, normalmente, enquanto o restante do time atende pela plataforma, com CRM, automação e relatórios, tudo no mesmo número de telefone.

Antes do COEX, migrar para a API era um evento único: o número saía do app, ia para a API, e quem dependia do aplicativo perdia o acesso. Com o COEX, essa migração vira um processo gradual, e é por isso que o recurso resolve o medo mais comum de quem adia a troca.

Como ativar o COEX

A ativação parte de dentro do aplicativo WhatsApp Business: a empresa escolhe conectar a conta já existente a um provedor de tecnologia, confirma por um código de verificação e, nesse momento, pode optar por compartilhar o histórico de conversa. Como o número já está registrado no app, o passo de registro de número, que costuma ser o mais demorado numa migração comum, é pulado inteiramente.

Um detalhe técnico que a documentação oficial da Meta deixa claro e que quase nenhum conteúdo sobre o tema menciona: a sincronização de histórico é opcional, cobre até 6 meses das conversas individuais mais recentes, e só pode rodar uma vez, dentro de uma janela de 24 horas após iniciar o processo. Perder essa janela significa recomeçar a ativação do zero. Vale também conferir a versão do aplicativo antes de começar: a Meta exige WhatsApp Business a partir da versão 2.24.17.

O que sincroniza e o que não sincroniza no COEX

Depois de ativado, mensagens individuais e contatos passam a aparecer nos dois ambientes, mas alguns recursos do aplicativo ficam de fora ou mudam de comportamento. Confira o que muda:

SincronizaNão sincroniza ou fica desativado
Conversas individuais (1 para 1), incluindo até 6 meses de histórico na ativação, se autorizadoConversas em grupo
Todos os contatos com WhatsApp, com webhook a cada contato criado, editado ou removidoMensagens temporárias (ficam desligadas)
Mensagens novas, nos dois sentidos, a partir da ativaçãoMensagens de visualização única (ficam desativadas)
Localização ao vivo (fica desativada)
Listas de transmissão (passam a ser só leitura)
Dispositivos companheiros não suportados, como WhatsApp Web em certas versões e WearOS, que se desvinculam automaticamente

Concessão honesta: se a sua operação depende muito de grupo, mensagem temporária ou dispositivo companheiro específico, vale mapear esse uso antes de ativar, porque esses recursos não seguem para o lado da API.

O COEX também pode se desconectar sozinho, e vale saber os gatilhos antes que aconteça sem aviso: inatividade prolongada, problema identificado na conta, troca do número de telefone ou um novo registro de dispositivo disparam a desconexão automática. Quando isso acontece, dá para reconectar repetindo o processo de ativação, sem perder o número.

Quando faz sentido ativar o COEX (e quando não faz)

O COEX resolve um problema específico: equipe que cresce e precisa de mais gente organizada atendendo o mesmo número. Se esse não é o seu caso agora, não há pressa nenhuma.

Ativa o COEX quando…Mantém só o app quando…
A equipe cresceu e mais de uma pessoa precisa atender o mesmo número ao mesmo tempoSó 1 ou 2 pessoas atendem, e o app dá conta do volume
Falta histórico organizado, fila de atendimento ou automaçãoNão usa CRM, automação nem relatório de atendimento
Quer migrar aos poucos, sem tirar ninguém do celular de uma vezJá está pronto para deixar o app de vez e migrar 100% para a API

Limite de 20 mensagens por segundo: o que isso muda pra quem dispara campanha

Um número em modo COEX, rodando ao mesmo tempo no app e na API, tem um limite fixo de 20 mensagens por segundo, segundo a documentação oficial da Meta. Para a maioria dos negócios, que atende e responde, esse teto nunca aparece no radar. Mas para quem dispara campanha em volume, é justamente o tipo de número que interessa acompanhar antes de decidir manter o COEX ligado permanentemente ou, em algum momento, desligar o app e seguir só pela API.

Esse ponto se conecta direto com a régua de disparo em massa: uma base de milhares de contatos, dividida em lotes dentro do limite recomendado de disparo por hora, dificilmente esbarra nos 20 mensagens por segundo do COEX. Na conta, 20 por segundo dá 1.200 por minuto: uma campanha de 5 mil contatos, disparada nesse teto contínuo, levaria cerca de 4 minutos só de limite técnico. Na prática, boas práticas de disparo já recomendam um ritmo bem mais lento que isso, então o teto do COEX raramente é o fator que trava a campanha primeiro. Ele começa a importar em picos concentrados, campanhas muito grandes disparadas de uma vez só, sem escalonar.

COEX reduz risco de banimento?

O COEX reduz risco porque incentiva o uso da API Oficial dentro das regras da Meta, mas não é uma blindagem contra banimento: a causa mais comum de conta banida continua sendo o comportamento de envio, não o recurso em si. Envio de promoção sem consentimento prévio, sistema não homologado pela Meta e disparo descontrolado para uma base fria seguem sendo risco, com ou sem COEX ativo.

A tese da Clickmassa sobre esse assunto já é publicada: a API Oficial reduz risco de banimento porque roda dentro da infraestrutura homologada pela própria Meta, com modelo de mensagem aprovado e rastreabilidade de envio. O COEX herda essa mesma base de segurança, só que sem obrigar a empresa a abandonar o app de um dia para o outro.

Dentro das regrasUso arriscado
Manda mensagem para quem já conversou com a empresa ou deu consentimento prévioCompra lista fria e dispara sem nenhum consentimento
Usa modelo de mensagem aprovado pela MetaUsa sistema não homologado ou burla o processo de aprovação
Escalona o envio em lotes, respeitando limite de disparo por horaDispara volume concentrado de uma vez, sem escalonar

Quem já lida com o medo de perder o número tem um guia dedicado a isso, incluindo o que fazer se acontecer, em conta banida no WhatsApp. E quem dispara campanha em volume encontra o passo a passo de fazer isso sem levar bloqueio em disparo em massa no WhatsApp sem banimento.

Como a Clickmassa oferece o COEX

A Clickmassa já suporta o WhatsApp Coexistence: dá para conectar o número que já roda no aplicativo do celular à plataforma sem precisar trocar de número nem tirar ninguém do app de uma vez. O time comercial continua atendendo pelo celular enquanto quem precisa de fila, histórico organizado e automação passa a usar a API Oficial por dentro da Clickmassa, no mesmo número.

Concessão honesta, para fechar: se a sua operação é pequena e o app sozinho já resolve, não existe pressa nenhuma para ativar o COEX. Ele faz sentido no momento em que a equipe cresce e o número precisa de mais gente atendendo ao mesmo tempo, com histórico organizado, sem abrir mão do que já funciona no celular.

💬 Fale com a Clickmassa

Migre pro COEX sem tirar ninguém do celular

A Clickmassa já conecta seu número ao WhatsApp Coexistence: o time continua no app enquanto o resto ganha fila, histórico organizado e automação pela API oficial. Manda um oi e veja como fica pro seu caso.

Falar com um especialista no WhatsApp

Resposta rápida, sem compromisso

O que é o WhatsApp Coexistence?

É a funcionalidade oficial da Meta que permite usar o mesmo número de WhatsApp ao mesmo tempo no aplicativo do celular e numa plataforma que roda a API Oficial, sem trocar de número.

Preciso trocar de número para ativar o COEX?

Não. O COEX conecta o número que já está ativo no aplicativo WhatsApp Business, sem precisar de um número novo nem de reregistro completo.

O histórico de conversa do celular vai para a plataforma?

Só se você autorizar durante a ativação, e só as conversas individuais dos últimos 6 meses. Grupos não sincronizam, e essa sincronização de histórico roda uma única vez, dentro de 24 horas do início do processo.

O COEX tem limite de mensagens por segundo?

Tem: 20 mensagens por segundo para números em modo dual, segundo a documentação oficial da Meta. Para a maioria das operações de atendimento isso nunca chega a ser um limite sentido no dia a dia; para disparo de campanha muito concentrado, vale planejar.

O COEX evita banimento da conta?

Reduz o risco porque mantém a operação dentro das regras da API Oficial, mas não blinda contra banimento. Envio sem consentimento e disparo descontrolado continuam sendo risco, com ou sem COEX.

O que acontece com grupos e mensagens temporárias no COEX?

Grupos não sincronizam com a plataforma. Mensagens temporárias e de visualização única ficam desativadas, e a localização ao vivo também. Listas de transmissão continuam existindo, mas só para leitura.

Dá para desativar o COEX depois?

Dá. A desconexão pode acontecer pela própria empresa ou por motivos como inatividade, problema na conta ou troca de número, e é possível reconectar passando pelo processo de ativação de novo.

Ativar o COEX tem custo?

A ativação em si não tem cobrança própria da Meta. O que continua valendo são as regras normais de cobrança por mensagem da API Oficial, as mesmas de qualquer conta que já usa a API.

COEX é a mesma coisa que Embedded Signup?

É o mesmo mecanismo técnico: a documentação oficial da Meta trata o Coexistence como parte do fluxo de Embedded Signup para quem já usa o aplicativo WhatsApp Business.

João Mário Costa

João Mário Costa é jornalista formado pela Universidade Federal do Rio Grande do Norte (UFRN) e cuida de SEO e conteúdo na Clickmassa. Escreve sobre atendimento e vendas no WhatsApp.