Coexistência do WhatsApp desconectou? Motivos e solução

A coexistência do WhatsApp desconecta por um de seis motivos, e a Meta informa ao parceiro qual foi: alguém tocou em desconectar no aplicativo, o celular principal ficou cerca de 14 dias sem uso, um aparelho vinculado ficou cerca de 30 dias sem uso, o número foi trocado, o WhatsApp foi registrado de novo ou a conta deixou de ser do WhatsApp Business. Em todos os casos o celular continua com as conversas e os contatos. O que para é a ponta da API: o sistema deixa de receber e de enviar pelo número até uma nova conexão, que leva alguns minutos e pode trazer o histórico outra vez.

Este guia mostra como perceber que a coexistência caiu, o que cada motivo significa, como reconectar, como desconectar de propósito e como trocar de provedor sem perder o número. Se você ainda não sabe o que é coexistência, comece pelo guia definitivo da coexistência.

Como saber que a coexistência caiu

A desconexão não aparece como erro no celular. O aplicativo WhatsApp Business segue funcionando normalmente, e é por isso que ela costuma ser percebida tarde, quando alguém nota que o sistema parou de responder. Os sinais são estes:

• Mensagens enviadas pelo sistema falham. Resposta automática, lembrete, envio em massa: nada sai pela API.
• O painel para de mostrar o que acontece no celular. Mensagens recebidas e respostas dadas pelo app deixam de aparecer na conversa do sistema.
• A tela Plataforma comercial do app mudou. Em Configurações › Conta › Plataforma comercial (em algumas versões, Plataforma de negócios), o parceiro some da lista ou aparece como desconectado.
• A Meta avisou o parceiro. A desconexão chega ao provedor por um aviso chamado account_update, com o evento PARTNER_REMOVED ou ACCOUNT_OFFBOARDED.

No Frame Conexa, esse aviso marca o número como desconectado na hora, antes de qualquer envio falhar, e a tela do número passa a mostrar o botão Reconectar. Quem integra pela API recebe o evento instance_status com o estado disconnected no mesmo instante e, quando o número volta, outro evento com o estado connected. O formato está no guia de webhooks da documentação.

Nota: a desconexão da coexistência é diferente de um número bloqueado pela Meta. No bloqueio, o próprio número perde o direito de enviar, pelo app e pela API. Na desconexão, o número está saudável e só a integração caiu. Se o celular mostra "Esta conta não tem permissão para usar o WhatsApp", o problema é outro, e o artigo sobre WhatsApp Business bloqueado explica o caminho.

Os seis motivos que a Meta informa

Quando a coexistência cai, o aviso da Meta pode trazer um campo chamado disconnection_info com dois dados: o motivo (reason) e quem iniciou (initiated_by), que é USER quando uma pessoa fez algo e SYSTEM quando a própria Meta desligou. A lista oficial de motivos está na página da Meta sobre usuários do app WhatsApp Business.

Nenhum desses motivos apaga nada no celular. E nenhum deles é uma punição: a Meta desliga a integração porque as duas pontas deixaram de estar sincronizadas, não porque o número fez algo errado.

O celular principal ficou 14 dias parado

É o motivo mais comum e o mais fácil de evitar. Na coexistência, o celular onde o WhatsApp Business está instalado continua sendo a raiz do número. A Meta espera que ele esteja ativo: ligado, com internet e com o app aberto de vez em quando. Depois de cerca de 14 dias sem atividade, ela desliga a integração com o motivo PRIMARY_INACTIVITY.

O caso típico é o do negócio que conectou o número e passou a atender só pelo sistema. O celular fica numa gaveta, a bateria acaba, e duas semanas depois a API para de funcionar sem nenhum aviso no aparelho. Se a ideia é nunca mais usar o celular, a coexistência não é a modalidade certa. O caminho é um número novo, só na API, comparado com a coexistência no guia definitivo.

Alguém desconectou pelo app

O motivo ACCOUNT_DISCONNECTED com initiated_by: USER quer dizer que alguém com o celular na mão abriu a tela Plataforma comercial e tocou em desconectar. Às vezes é intencional. Muitas vezes é um funcionário que não reconheceu o nome do parceiro na lista, ou alguém que seguiu um tutorial de outro provedor. Combine com a equipe quem pode mexer nessa tela.

O número mudou de aparelho ou foi registrado de novo

Trocar de celular é o gatilho mais traiçoeiro. Quando o WhatsApp Business é instalado e registrado num aparelho novo, a Meta considera que o número foi registrado de novo (USER_RE_REGISTERED) e desliga a coexistência. O mesmo vale para reinstalar o app e confirmar o número por SMS no mesmo aparelho. A Meta também avisa o parceiro por um evento próprio, account_offboarded, que ela descreve como a saída por troca de aparelho ou novo registro.

Se a troca de celular está planejada, faça assim: migre o WhatsApp Business para o aparelho novo, confira que as conversas vieram, abra o app, e só então reconecte a plataforma. A reconexão traz de volta a ponta da API.

O número foi trocado ou a conta deixou de ser Business

CHANGE_NUMBER aparece quando a empresa usa a função de mudar de número dentro do app. A conta passa a responder por outro número, e a coexistência do número antigo acaba. O número novo precisa passar pelo fluxo de conexão do zero, porque para a Meta ele é outro ativo.

BUSINESS_DOWNGRADE aparece quando o número deixa de ser uma conta do WhatsApp Business, por exemplo ao ser registrado no WhatsApp comum. A coexistência só existe para o app Business. Para voltar, o número precisa estar de novo no WhatsApp Business antes da reconexão.

O que acontece quando a coexistência cai

A pergunta que todo mundo faz é o que se perdeu. A resposta curta é: nada que estava no celular, e nada que já estava no painel.

Um ponto merece atenção: o que acontece no celular enquanto a coexistência está desligada não chega ao painel depois. Uma conversa de três dias sem integração só volta ao sistema se você reconectar e aceitar compartilhar o histórico de novo, como mostra a próxima seção.

Também vale lembrar o que a coexistência desliga dentro do app enquanto está ativa, segundo a Meta: mensagens temporárias, visualização única, localização em tempo real e a criação de listas de transmissão. Com a integração desligada, esses recursos voltam ao aplicativo. Quando você reconectar, eles saem de novo. Grupos, chamadas e catálogo não mudam no app em nenhum dos dois estados; eles só não passam pela API.

Como reconectar sem perder nada

Reconectar é refazer o mesmo fluxo da primeira conexão, o Embedded Signup da Meta, com o mesmo número. Leva poucos minutos quando o celular está à mão.

1. Prepare o celular. Abra o WhatsApp Business, confira que ele está atualizado e com internet, e deixe o app aberto.
2. Abra a reconexão. No Frame Conexa, entre na tela do número e toque em Reconectar. Se o número é de um cliente seu, gere um novo link de conexão e mande para quem tem o celular.
3. Autorize na janela da Meta. Entre com a conta que administra a empresa, escolha a mesma conta do WhatsApp Business e o mesmo número.
4. Confirme no celular. O app pede para conectar à plataforma e pergunta se você quer compartilhar o histórico. Aceite para trazer as conversas do período em que a integração ficou desligada.
5. Espere a sincronização. O painel mostra o andamento da importação de conversas e contatos. Mantenha o app aberto até terminar.

No Frame Conexa, reconectar o mesmo número devolve a mesma instância: o identificador que a sua integração usa não muda, as conversas que já estavam no painel continuam lá e o número volta a ocupar a mesma vaga da assinatura. A sincronização de histórico recomeça do zero, como na primeira conexão.

O histórico pode ser compartilhado de novo

A Meta permite compartilhar o histórico e os contatos uma única vez por conexão. A regra oficial diz que, para repetir, o cliente precisa primeiro desconectar e depois refazer o Embedded Signup. Uma reconexão é exatamente isso, então o histórico pode vir outra vez: as mensagens dos 180 dias anteriores à nova conexão, com mídia só dos últimos 14 dias.

É também a saída para quem recusou o compartilhamento na primeira vez e se arrependeu. Quando o dono do número recusa, a Meta informa o parceiro com o código 2593109 ("History sync is turned off by the business from the WhatsApp Business App"), e a única forma de mudar a resposta é desconectar e conectar de novo.

Aparelhos vinculados saem de novo

Ao conectar, a Meta desvincula todos os aparelhos ligados à conta: WhatsApp Web, aplicativo de computador e tablet. Isso vale também para a reconexão. Depois que o número voltar, vincule de novo os aparelhos que a equipe usa. A Meta informa que os aplicativos para Windows e para relógios com WearOS não são suportados na coexistência: mensagens enviadas por eles não chegam à API.

Quando a Meta avisa que você voltou

Quando o número se conecta de novo ao mesmo parceiro depois de ter saído, a Meta envia o evento account_reconnected. Para quem integra, esse é o sinal de que a pausa terminou. No Frame Conexa ele se soma ao instance_status com o estado connected, que é o evento que a sua integração deve escutar para marcar o canal como ativo de novo.

Desconectar de propósito: os dois caminhos

Há boas razões para desconectar: trocar de provedor, parar de usar a API, refazer o fluxo para compartilhar o histórico. A Meta aceita dois caminhos, e nenhum deles apaga o número.

Pelo aplicativo. No celular do número, abra Configurações › Conta › Plataforma comercial, toque no parceiro e em desconectar. É o caminho oficial da documentação da Meta. Em setembro de 2026, um cliente do Frame Conexa desconectou por esse botão e o número voltou pelo mesmo link de conexão 26 minutos depois, sem nenhuma recusa da Meta.

Pelo Business Manager. Em Configurações do portfólio › Parceiros, abra o parceiro, a conta do WhatsApp e escolha Gerenciar › Remover acesso. É o caminho de quem administra a empresa pelo computador e não tem o celular por perto. A Meta avisa o parceiro com os eventos PARTNER_APP_UNINSTALLED e PARTNER_REMOVED.

Atenção: a Meta não permite descadastrar da API um número que está em coexistência. A chamada de descadastro (deregister) não funciona nesse modo, e a desconexão precisa passar pelo app ou pelo Business Manager. Desconfie de qualquer procedimento que peça outra coisa.

O que não fazer para desconectar

Três atalhos parecem resolver e criam problema maior:

• Excluir o número da conta do WhatsApp Business. Parceiros relatam que um número removido da conta pode ficar semanas ou meses sem conseguir voltar à coexistência. A exceção é um número que ficou pendente numa conta sem nunca ter sido registrado, caso tratado no artigo sobre quando a opção de coexistência não aparece.
• Apagar a conta do WhatsApp Business ou o portfólio. O efeito é o mesmo, com o risco de perder a verificação da empresa.
• Registrar o número como "número novo" em outro sistema. Isso tira o número do aplicativo do celular. Na coexistência, o número nunca passa pelo registro de número novo, e é o que mantém o app funcionando.

Trocar de provedor sem perder o número

A Meta não conecta dois provedores ao mesmo número ao mesmo tempo. Trocar de provedor é, portanto, uma sequência: desconectar o antigo e conectar o novo.

1. Exporte o que precisa do provedor antigo. Conversas, contatos e relatórios de campanha ficam no sistema dele. A Meta não transfere nada de um provedor para outro.
2. Desconecte o provedor antigo por um dos dois caminhos acima. Confira na tela Plataforma comercial que ele saiu da lista.
3. Espere alguns minutos. Um número que acabou de sair de uma conta pode ser recusado por pouco tempo. A Meta responde com o código 3441030, e a orientação é tentar de novo depois de cerca de 3 minutos.
4. Conecte no provedor novo pelo fluxo normal e aceite compartilhar o histórico. O provedor novo recebe os 180 dias anteriores à conexão.

Dois problemas podem aparecer no caminho. O primeiro é o provedor antigo continuar atribuído à conta, o que faz a Meta recusar o número com o erro 2388002; a solução está no artigo sobre o Embedded Signup. O segundo é a linha de crédito: se o provedor antigo era um Solution Partner e a conta ainda usa a linha de crédito dele, a Meta avisa que pode haver erro ao mudar de parceiro. Nesse caso, a conta precisa ter uma forma de pagamento própria, e o artigo sobre forma de pagamento da API mostra como cadastrar.

Como evitar desconexões

A maioria das desconexões vem de hábitos, não de falhas técnicas. Uma rotina curta evita quase todas:

• Abra o WhatsApp Business no celular principal pelo menos uma vez por semana, mesmo que a equipe atenda pelo sistema. A margem da Meta é de cerca de 14 dias; uma vez por semana deixa folga.
• Mantenha o celular ligado e com internet. Um aparelho sem bateria conta como inativo.
• Não reinstale nem troque de celular sem planejar. Se precisar, reconecte logo depois de o app estar funcionando no aparelho novo.
• Restrinja quem mexe na tela Plataforma comercial. Explique para a equipe o que é o parceiro que aparece ali.
• Mantenha o app atualizado. A Meta exige a versão 2.24.17 ou superior para a coexistência.
• Escute o evento de desconexão. Quem integra pela API deve tratar o instance_status e avisar alguém quando o estado virar disconnected, em vez de descobrir no primeiro envio que falha.

Perguntas frequentes

Por que a coexistência do WhatsApp desconectou sozinha?

Quase sempre porque o celular principal ficou cerca de 14 dias sem uso, e a Meta desligou a integração com o motivo PRIMARY_INACTIVITY. Os outros motivos oficiais são desconexão feita pelo app, aparelho vinculado parado por cerca de 30 dias, troca de número, novo registro do WhatsApp e conta que deixou de ser do WhatsApp Business. Nenhum deles apaga as conversas do celular.

Perdi as conversas quando a coexistência caiu?

Não. O app do celular mantém tudo, e as conversas que já estavam no painel continuam lá. O que fica de fora é o período em que a integração esteve desligada: essas mensagens só chegam ao sistema se você reconectar e aceitar compartilhar o histórico de novo, porque a Meta envia os 180 dias anteriores a cada nova conexão.

Como reconectar a coexistência?

Refaça o fluxo de conexão da Meta com o mesmo número: abra o WhatsApp Business no celular, inicie a reconexão no painel do provedor, autorize com a conta que administra a empresa e confirme no app. No Frame Conexa, o botão Reconectar fica na tela do número, e o número volta com o mesmo identificador e as mesmas conversas.

Como desconectar o WhatsApp Business da API?

Pelo celular, em Configurações › Conta › Plataforma comercial, tocando no parceiro e em desconectar. Ou pelo Business Manager, em Parceiros, removendo o acesso do parceiro à conta do WhatsApp. A Meta não permite descadastrar da API um número em coexistência por outro caminho, e excluir o número da conta pode impedir a volta por semanas.

Posso trocar de provedor mantendo o mesmo número?

Pode. Desconecte o provedor antigo, espere alguns minutos e conecte no novo, aceitando compartilhar o histórico. A Meta não conecta dois provedores ao mesmo tempo e não transfere dados entre eles, então exporte antes o que estiver no sistema antigo. Se o provedor antigo pagava a Meta por você, cadastre uma forma de pagamento própria na conta.

Próximo passo

Se o número caiu e você usa o Frame Conexa, abra a tela do número e toque em Reconectar com o celular por perto. Se está pensando em trazer o número de outro provedor, veja os planos por número e o guia de início rápido para o primeiro envio depois da conexão.