---
title: Coexistência do WhatsApp desconectou? Motivos e solução
description: Por que a coexistência entre o WhatsApp Business e a API oficial desconecta, o que cada motivo informado pela Meta significa e como reconectar sem perder nada.
date: 2026-09-16
category: coexistencia
tags: coexistência, desconectou, whatsapp business, api oficial, reconectar, trocar de provedor
author: gabriel-miranda
cover: /blog-assets/covers/coexistencia-whatsapp-desconectou.jpg
coverAlt: Mulher confere o celular sentada diante do notebook
coverSource: https://www.pexels.com/photo/3756688/
---

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](/blog/coexistencia-whatsapp-business-api).

## 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](/docs/guides/webhooks).

> **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](/blog/whatsapp-business-bloqueado-o-que-fazer) 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/).

| Motivo informado pela Meta | O que aconteceu | O que fazer |
|---|---|---|
| `ACCOUNT_DISCONNECTED` | Alguém desconectou a plataforma pelo app | Reconectar, se não foi de propósito |
| `PRIMARY_INACTIVITY` | O celular principal ficou cerca de 14 dias sem uso | Abrir o app no celular e reconectar |
| `COMPANION_INACTIVITY` | Um aparelho vinculado ficou cerca de 30 dias sem uso | Usar o app no aparelho e reconectar |
| `CHANGE_NUMBER` | O número da conta foi trocado pelo app | Conectar o número novo |
| `USER_RE_REGISTERED` | O WhatsApp foi registrado de novo, em outro aparelho ou no mesmo | Reconectar depois de o app estar ativo |
| `BUSINESS_DOWNGRADE` | A conta deixou de ser do WhatsApp Business | Voltar ao WhatsApp Business e reconectar |

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](/blog/coexistencia-whatsapp-business-api#coexistencia-ou-numero-novo-so-na-api-como-escolher).

### 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.

| O quê | Depois da desconexão |
|---|---|
| App WhatsApp Business no celular | Continua funcionando, com conversas e contatos |
| Número | Continua seu, no mesmo aparelho |
| Envio pelo sistema | Para até a reconexão, inclusive respostas automáticas e envio em massa |
| Mensagens recebidas | Chegam só no celular enquanto a integração estiver desligada |
| Conversas já importadas para o painel | Continuam no painel |
| Vaga no Frame Conexa | Continua reservada para o número |

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](/blog/embedded-signup-whatsapp), 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](/blog/opcao-de-coexistencia-nao-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](/blog/embedded-signup-whatsapp#2388002-parceiro-ja-atribuido-a-conta). 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](/blog/forma-de-pagamento-whatsapp-business-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](/#precos) e o [guia de início rápido](/docs/quickstart) para o primeiro envio depois da conexão.