Solucionar problemas de desconexão da coexistência
Por que a coexistência do WhatsApp se desconecta e como resolver
Visão geral
A coexistência do WhatsApp permite que uma empresa use o WhatsApp Business App no celular e o Chakra Chat com o mesmo número, ao mesmo tempo. É uma ótima configuração, mas a conexão entre o celular e o Chakra Chat pode ser interrompida por alguns motivos. Este guia aborda todos os motivos conhecidos, como evitar que isso aconteça e exatamente o que fazer quando acontecer.
Resumo
A maioria das desconexões ocorre por um destes motivos:
- A empresa deixou de abrir o WhatsApp Business App no celular por muito tempo.
- A empresa trocou de celular, mudou de número ou reinstalou o app.
- A empresa (ou alguém da equipe) mudou o número para uma conta pessoal do WhatsApp.
- A empresa desconectou manualmente , às vezes por acidente.
- O WhatsApp restringiu ou baniu a conta por um motivo relacionado às políticas.
A boa notícia: no caso mais comum (troca de celular), o WhatsApp reconecta automaticamente em poucos minutos — não é preciso fazer nada, desde que a empresa não opte por sair quando solicitado. Nos outros casos, a empresa precisa refazer a conexão.
1. Todos os motivos
a) Celular inativo
O que aconteceu: se o WhatsApp Business App não for aberto no celular por cerca de 2 semanas, o WhatsApp considera a conta inativa e a desconecta do Chakra Chat.
Como evitar: peça à empresa para abrir o WhatsApp Business App no celular principal pelo menos uma vez por semana. Basta abrir o app para reiniciar a contagem — não é necessário enviar mensagens.
Se for um dispositivo conectado (como o WhatsApp Web), e não o celular principal: o período de tolerância é maior — cerca de um mês de inatividade até que a sessão seja encerrada. Isso não afeta a conexão principal com o Chakra Chat, apenas esse dispositivo adicional, que pode ser reconectado facilmente (consulte a Seção 3).
b) Celular novo ou app reinstalado
O que aconteceu: a troca para um novo dispositivo ou o novo registro do WhatsApp no mesmo dispositivo interrompe a conexão com o Chakra Chat.
A boa notícia: o WhatsApp geralmente resolve isso automaticamente. Quando a empresa terminar de configurar o WhatsApp Business App no celular novo (ou após a reinstalação), verá uma tela com a plataforma conectada (Chakra Chat) e uma caixa já marcada para manter a conexão. Desde que não desmarque essa opção, a reconexão será feita discretamente em segundo plano — geralmente em poucos minutos.
O que a empresa precisa saber:
- Basta concluir a configuração normal do WhatsApp Business App e deixar marcada a opção "manter conectado".
- As mensagens podem ficar temporariamente indisponíveis durante esse processo.
- Todos os dispositivos conectados anteriormente (como o WhatsApp Web) precisarão ser conectados novamente manualmente — essa etapa não é feita automaticamente.
Se a conexão não for restabelecida automaticamente: talvez outra pessoa tenha conectado uma ferramenta comercial diferente do WhatsApp a esse número nesse meio-tempo, o que cancela a reconexão automática. Nesse caso, a empresa precisa refazer todo o processo de conexão do Chakra Chat desde o início.
c) Número de telefone alterado
O que aconteceu: isso é diferente de trocar de celular — significa que o número do WhatsApp em si foi alterado.
O que fazer: não é possível reconectar automaticamente. Faça como se fosse configurar a coexistência pela primeira vez em um número novo, incluindo garantir que o novo número tenha atividade real suficiente no WhatsApp Business App (consulte a seção sobre requisitos de elegibilidade abaixo).
d) Número transferido para o WhatsApp pessoal
O que aconteceu: alguém registrou o número da empresa no app normal e pessoal do WhatsApp, em vez de usar o WhatsApp Business App.
O que fazer: a empresa precisa registrar novamente esse número no WhatsApp Business App e, em seguida, reconectar ao Chakra Chat.
Como evitar: garanta que todos na equipe do cliente saibam que esse é um número comercial e que ele nunca deve ser configurado no app pessoal do WhatsApp "só para verificar uma coisa".
e) Toque em "Desconectar"
O que aconteceu: o WhatsApp Business App tem a opção Desconectar em Configurações → Conta → Plataforma comercial. Às vezes, alguém da equipe do cliente toca nessa opção por acidente.
O que fazer: basta reconectar pelo fluxo normal de configuração do Chakra Chat — o WhatsApp Business App exibirá a opção de reconexão.
Importante: se isso acontecer, diga à empresa para não desinstalar o app na tentativa de "resolver" o problema — desinstalar pode piorar a situação e dificultar a reconexão. Basta reconectar pelo fluxo normal.
f) Restrição ou banimento do WhatsApp
O que aconteceu: isso não é exatamente um problema de coexistência — é uma ação do WhatsApp contra a conta por violação das regras (comportamento parecido com spam, violações de políticas, queda excessiva na qualidade das mensagens etc.).
O que fazer: é necessário resolver o problema diretamente com o WhatsApp antes que seja possível reconectar. Verifique se o cliente recebeu algum aviso ou notificação de restrição e peça que resolva isso primeiro. A reconexão não funcionará enquanto a conta estiver sob restrição ativa.
2. Como evitar desconexões
Compartilhe esta lista de verificação com todos os clientes durante a integração:
✅ Abra o WhatsApp Business App no seu celular principal pelo menos uma vez por semana. Só isso já evita a causa mais comum de desconexão.
✅ Se você trocar de celular, configure o WhatsApp Business App normalmente — não desinstale o app antigo antes e não pule as etapas da configuração. Deixe marcada a opção "manter conectado ao Chakra Chat" quando ela aparecer.
✅ Nunca registre seu número comercial no app pessoal do WhatsApp.
✅ Use apenas o WhatsApp Web ou o WhatsApp para Mac como dispositivos adicionais conectados — outras opções (como o WhatsApp para Windows) não são compatíveis e as mensagens não serão exibidas corretamente no Chakra Chat.
✅ Antes de conectar à coexistência, certifique-se de que o número tenha sido usado ativamente no WhatsApp Business App por pelo menos uma semana — de preferência, por um ou dois meses. Números totalmente novos ou que acabaram de ser excluídos e adicionados novamente costumam ser rejeitados durante a configuração como "não elegíveis".
✅ Se o número já tiver sido usado com outra ferramenta comercial do WhatsApp, desconecte-o completamente dessa ferramenta antiga primeiro e mantenha-o ativo no WhatsApp Business App por um ou dois meses antes de conectá-lo ao Chakra Chat.
✅ Mantenha o WhatsApp Business App atualizado com a versão mais recente.
✅ Mantenha a qualidade das suas mensagens em bom nível — evite padrões de envio parecidos com spam que possam levar à restrição da conta.
3. Soluções passo a passo
"Meu WhatsApp Web se desconectou, mas meu celular principal continua funcionando"
Isso é apenas o encerramento da sessão de um dispositivo conectado — não há nada de errado com sua conexão do Chakra Chat.
- Abra o WhatsApp Business App no seu celular principal.
- Acesse Dispositivos conectados.
- Toque em Conectar um dispositivo e escaneie o código QR do WhatsApp Web ou do WhatsApp para Mac. Pronto — não é preciso mexer no Chakra Chat.
"Troquei de celular e agora as mensagens não chegam pelo Chakra Chat"
- Conclua a configuração normal do WhatsApp Business App no celular novo.
- Quando aparecer a tela com a plataforma conectada (Chakra Chat) e uma caixa de seleção, deixe-a marcada.
- Aguarde alguns minutos; geralmente a conexão é restabelecida automaticamente.
- Depois de reconectar, vincule manualmente os dispositivos, como o WhatsApp Web — essa etapa não acontece automaticamente.
- Se ainda não tiver reconectado depois de 15–20 minutos, entre em contato com o suporte — outra pessoa pode ter conectado uma ferramenta diferente ao número nesse meio-tempo, e isso precisa ser resolvido primeiro.
"Troquei para um novo número comercial"
Isso exige uma nova configuração, não uma reconexão. Entre em contato com seu representante da Chakra Chat para refazer o cadastro no Coexistence com o novo número — e confirme se o novo número já tem alguma atividade real no WhatsApp Business App (pelo menos uma semana, idealmente mais).
"Alguém da minha equipe desconectou por acidente"
- Não desinstale o app.
- Reconecte pelo fluxo normal de configuração da Chakra Chat — você verá a opção de reconectar sua conta existente do WhatsApp Business App.
"Aparece que meu número de telefone não está qualificado para se conectar"
Isso significa que o WhatsApp ainda não detectou atividade real suficiente nesse número.
- Use o número normalmente no WhatsApp Business App — envie e receba mensagens reais — por pelo menos uma semana, idealmente por 30–60 dias.
- Não exclua e adicione o número novamente várias vezes enquanto espera — isso reinicia a contagem a cada vez.
- Se esse número já foi conectado a outra ferramenta de negócios do WhatsApp, desconecte-o dessa ferramenta primeiro e, em seguida, retome a atividade antes de tentar novamente.
"Aparece que este número já está registrado em outra conta"
Isso significa que o número ainda está vinculado à configuração de um provedor anterior.
- Essa conexão antiga precisa ser totalmente removida pelo provedor anterior primeiro.
- Registre novamente o número normalmente no WhatsApp Business App.
- Use-o ativamente por um ou dois meses.
- Depois, tente se conectar à Chakra Chat novamente.
"Meu histórico de conversas não está sincronizando ou está demorando muito"
- Confirme se o WhatsApp Business App permaneceu aberto e se o celular ficou conectado à internet durante a configuração — se o app for fechado ou o celular perder o sinal durante a sincronização, ela pode travar.
- Confirme se a conexão está estável (Wi-Fi ou dados móveis de boa qualidade).
- Históricos de conversa grandes podem levar algumas horas — isso é normal e não significa que houve uma desconexão.
- Se estiver realmente travado, entre em contato com o suporte em vez de tentar fazer a configuração novamente por conta própria — em geral, só é possível tentar sincronizar o histórico uma vez por conexão.
"Algumas mensagens não aparecem na Chakra Chat"
Isso costuma acontecer quando a mensagem foi enviada de um dispositivo não compatível com o Coexistence (como o WhatsApp para Windows). Peça à empresa para conferir essas mensagens diretamente no WhatsApp Business App e trocar os dispositivos adicionais pelo WhatsApp Web ou WhatsApp para Mac.
"Meu selo azul de verificação desapareceu depois da conexão"
Isso pode acontecer brevemente quando o Coexistence é ativado pela primeira vez e, normalmente, o selo volta em alguns dias. Esse comportamento é esperado e não significa que algo esteja com defeito — não é necessário fazer nada.
"Não consigo alterar o nome da minha empresa"
Depois de conectado, o WhatsApp bloqueia o nome da empresa para que o app e a Chakra Chat estejam sempre iguais. Defina o nome corretamente antes de se conectar. Se for realmente necessário alterá-lo depois, será preciso fazer uma solicitação ao suporte do WhatsApp, e não há garantia de aprovação.
4. Tabela de consulta rápida
O que o cliente diz | O que provavelmente está acontecendo | Onde procurar |
|---|---|---|
"Desconectou sozinho" | O celular não foi aberto por ~2 semanas | Seção 1, "celular ficou sem uso" |
"Comprei um celular novo" | Deve reconectar automaticamente | Seção 1 & 3, "celular novo" |
"Troquei de número" | É necessária uma nova configuração completa | Seção 1 & 3, "número alterado" |
"Saí do WhatsApp Web" | Tempo limite normal, fácil de corrigir | Seção 3, "WhatsApp Web desconectado" |
"Alguém desconectou por engano" | Desconexão manual | Seção 1 & 3, "desconectado por acidente" |
"Aparece que meu número não está qualificado" | Ainda não há histórico de atividade suficiente | Seção 3, "não está qualificado" |
"Aparece que o número já está registrado em outro lugar" | Conexão remanescente com um provedor antigo | Seção 3, "já está registrado" |
"As conversas não estão sincronizando" | O app foi fechado durante a sincronização ou o histórico é muito grande | Seção 3, "histórico de conversas" |
"Algumas mensagens estão faltando" | Dispositivo vinculado não compatível | Seção 3, "mensagens não aparecem" |
"Perdi meu selo azul" | Temporário, esperado e se resolve sozinho | Seção 3, "selo azul" |
"Não consigo mudar o nome da empresa" | Bloqueado por definição após a conexão | Seção 3, "não consigo mudar o nome da minha empresa" |
5. Solucionar problemas de desconexão da coexistência
Sempre que algo muda na sua conta do WhatsApp, a Meta envia um evento da conta para a Chakra. Quando o suporte investiga uma desconexão, geralmente vê um dos eventos abaixo. Esta tabela explica cada um em termos simples: o que significa, se interrompe a conexão com a Chakra e o que fazer.
Evento | O que significa | Desconecta a Chakra? | O que fazer |
|---|---|---|---|
| Seu número foi desconectado porque o app WhatsApp Business foi transferido para um novo celular ou o número foi registrado novamente. | Sim – geralmente por alguns minutos | Conclua a configuração do app e deixe marcada a opção “manter conectado”. Normalmente, a conexão é restabelecida automaticamente (veja 1b). |
| A conexão foi restabelecida após a troca de celular ou o novo registro do número. | Não – conexão restabelecida | Nada a fazer na Chakra. Reconecte manualmente o WhatsApp Web ou outros dispositivos vinculados. |
| Sua conta do WhatsApp não é mais compartilhada com a Chakra – por exemplo, alguém tocou em Desconectar no app ou removeu a Chakra no Business Manager. Veja a seção 6 para saber o motivo informado pela Meta. | Sim | Não desinstale o app. Confira o motivo na seção 6 e, em seguida, reconecte pela configuração guiada da Chakra. |
| Alguém da empresa removeu as permissões da Chakra para acessar a conta. | Sim | Reconecte pela Chakra com um administrador do portfólio empresarial e aceite todas as permissões. |
| A conta de mensagens do WhatsApp foi excluída. | Sim – permanente | Configure a conexão novamente desde o início. |
| A Meta alterou o status da conta após ela violar as políticas ou os termos da Meta – geralmente, isso significa que ela foi desativada. | Sim, enquanto estiver desativada | Acesse a Central de Suporte para Empresas e entre com um recurso. A reconexão não funcionará até que o problema seja resolvido (veja 1f). |
| A Meta restringiu a conta do WhatsApp por violação de políticas. | Nem sempre – mas o envio de mensagens é limitado ou bloqueado | Confira a restrição na Central de Suporte para Empresas, corrija a causa e solicite uma análise. |
| A conta violou as políticas ou os termos da Meta. É um aviso que pode levar a uma restrição. | Não por si só | Leia o aviso na Central de Suporte para Empresas e corrija o problema antes que ele se agrave. |
| Sua conta do WhatsApp foi compartilhada com um parceiro, como a Chakra – a conexão foi configurada. | Não | Nada. |
| A empresa concedeu à Chakra permissões para acessar a conta. | Não | Nada. |
| A conta aderiu à Marketing Messages API e deu ao parceiro acesso às contas de anúncios. | Não | Nada. |
| A conta aceitou os termos da Marketing Messages API. | Não | Nada. |
| A verificação da empresa enviada por meio do parceiro foi aprovada, rejeitada ou descartada. | Não | Se for rejeitada, corrija os dados e envie a verificação novamente. |
| A conta agora se qualifica para as tarifas internacionais da Meta para mensagens de autenticação (OTP). | Não | Nada – apenas informações sobre preços. |
| O país principal da empresa da conta foi definido (usado para determinar os preços). | Não | Nada – apenas informações sobre preços. |
| A faixa de preços da conta baseada no volume foi alterada. | Não | Nada – apenas informações sobre preços. |
6. Por que a conexão foi removida (detalhes de PARTNER_REMOVED)
Quando o evento PARTNER_REMOVED ocorre em um número que usa tanto o app WhatsApp Business quanto a Chakra, a Meta geralmente adiciona dois detalhes: quem iniciou a desconexão e por quê.
Quem iniciou
Iniciado por | O que significa |
|---|---|
| O WhatsApp desconectou a conta automaticamente – por exemplo, porque um dispositivo não foi usado por algum tempo ou devido a uma medida relacionada a políticas. |
| Uma ação da empresa causou a desconexão – por exemplo, mudar o número, configurar a conta em um novo celular, excluir a conta do WhatsApp ou transferir o número para o WhatsApp pessoal. |
Por que aconteceu
Motivo | Iniciado por | O que aconteceu, em termos simples | O que fazer |
|---|---|---|---|
| Sistema | O app WhatsApp Business no telefone principal não foi aberto por cerca de 14 dias. | Reconecte pelo fluxo de configuração do Chakra. A partir de agora, abra o app pelo menos uma vez por semana (consulte 1a). |
| Sistema | Um dispositivo conectado (por exemplo, WhatsApp Web) não foi usado por cerca de 30 dias. | Abra o app no telefone principal e conecte o dispositivo novamente. Se as mensagens pararam de chegar no Chakra, reconecte pelo fluxo de configuração do Chakra (consulte a seção 3). |
| Usuário | A empresa configurou o WhatsApp em um novo telefone ou reinstalou o app. | Conclua a configuração com a opção “manter conectado” marcada — geralmente, a conexão é restabelecida em poucos minutos. Se isso não acontecer, reconecte pelo Chakra (consulte 1b). |
| Usuário | A empresa mudou o número de telefone do WhatsApp. | Configure a conexão novamente com o novo número (consulte 1c). |
| Usuário | O número da empresa foi registrado no app WhatsApp pessoal em vez do WhatsApp Business. | Mova o número de volta para o app WhatsApp Business e reconecte pelo Chakra (consulte 1d). |
| Usuário ou Sistema | Iniciado pelo Sistema: o WhatsApp desconectou a conta por um motivo relacionado a políticas. Iniciado pelo Usuário: a empresa excluiu a conta do WhatsApp. | Sistema: acesse a Central de Suporte para Empresas e resolva o problema primeiro (consulte 1f). Usuário: registre novamente o número no app WhatsApp Business e configure a conexão desde o início., |
Referência da Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update#account-information-for-partner-events
Fontes: documentação oficial da WhatsApp Business Platform da Meta, além de anotações de solução de problemas baseadas na experiência de outros provedores de plataformas do WhatsApp.