Reconectar um número que a Meta desconectou após 14 dias (PRIMARY_INACTIVITY)
Quando o app do WhatsApp Business no telefone principal fica cerca de 14 dias sem ser aberto, a Meta encerra o lado da Cloud API de um número em Coexistência e informa o motivo PRIMARY_INACTIVITY. Para restabelecer, abra o app nesse telefone e deixe que ele sincronize; depois, execute o fluxo do Embedded Signup novamente com o mesmo número. O app, suas conversas e o próprio número não são afetados.
O easyCoexistence envia um e-mail ao titular no momento em que a Meta informa a queda, e a página do número explica o motivo: "A Meta desconectou porque o app do WhatsApp Business no telefone não foi aberto por cerca de 14 dias", ao lado de um botão "Reconectar este número".
Inatividade do dispositivo principal por trás do motivo de desconexão PRIMARY_INACTIVITY.
O valor de initiated_by no exemplo de payload PARTNER_REMOVED da Meta para PRIMARY_INACTIVITY: foi a plataforma que encerrou, não uma pessoa.
O evento account_update que a Meta envia quando uma empresa faz novo onboarding com o mesmo parceiro após o offboarding.
Janela, após um onboarding, para sincronizar contatos e histórico de conversas, utilizável uma vez por onboarding.
Com que frequência nosso painel recomenda abrir o app no telefone principal, com uma margem abaixo da regra da Meta.
O que significa PRIMARY_INACTIVITY?
É o motivo que a Meta informa quando remove a API de um número em Coexistência porque o dispositivo principal ficou inativo. A Meta envia um webhook account_update com o evento PARTNER_REMOVED, e dentro de disconnection_info o motivo aparece como PRIMARY_INACTIVITY, documentado como o dispositivo principal inativo por aproximadamente 14 dias. No payload de exemplo da Meta, initiated_by é SYSTEM.
O dispositivo principal é o telefone que guarda o número no app do WhatsApp Business. Nada muda nele: os clientes continuam escrevendo, a equipe continua respondendo, e as conversas permanecem onde estavam. O que para é tudo do lado da API. Os envios pela Cloud API falham, os webhooks deixam de chegar, e automações, respostas de IA e sistemas conectados ficam em silêncio nesse número até que ele seja reconectado.
Por que ninguém percebe a queda?
Porque as pessoas mais próximas do número estão com o telefone, e o telefone continua funcionando. O app não mostra nenhum aviso quando o lado da API termina, então uma loja pode passar dias achando que as automações estão respondendo, enquanto os clientes só recebem resposta quando alguém pega o telefone.
O padrão mais comum: a empresa conectou o número, configurou uma resposta de IA ou um webhook para o seu sistema, e depois deixou a equipe trabalhar pelo WhatsApp Web ou por um segundo dispositivo, enquanto o telefone principal ficava numa gaveta. Dispositivos vinculados não mantêm o telefone principal ativo. O WhatsApp também informa que um dispositivo principal inativo por um longo período desconecta a conta dos dispositivos companheiros, de modo que o telefone da gaveta acaba derrubando esses também.
O que precisa ser refeito depois de reconectar?
Uma reconexão é um novo onboarding pelo Embedded Signup, então algumas coisas voltam como decisões novas, e não são herdadas.
- O destino do webhook. A Meta o guarda como uma substituição na assinatura do app do provedor, e o
PARTNER_REMOVEDdesinstala junto com o app. Ele precisa ser configurado de novo. - Histórico de conversas. O app pergunta de novo se deve compartilhá-lo, e abre-se uma nova janela de 24 horas para sincronizar contatos e histórico.
- Os tokens emitidos para a conexão antiga podem não funcionar. Busque as credenciais de novo depois de reconectar.
- A Meta mantém o ID da conta de mensagens existente para a Coexistência, então a Conta do WhatsApp Business é a mesma de antes.
O que aconteceu com as mensagens enviadas durante o período sem conexão?
Elas chegaram ao app do WhatsApp Business no telefone como qualquer outra mensagem, então a empresa não perdeu nada. Já os seus sistemas não receberam nada nesse período, porque o app do provedor foi desinstalado da conta. Uma automação não conseguiu responder a essas conversas, e um agente de IA nunca as viu.
Depois de reconectar, leia no app as conversas que chegaram no período e responda as que ainda estão aguardando. Se o seu próprio sistema precisa dessas mensagens, a sincronização de histórico oferecida com o novo onboarding é a única forma de trazê-las: até seis meses de conversas individuais, quando a empresa aceita compartilhar e um destino de webhook direto é salvo em até 24 horas após a reconexão. Um número com automações ativadas não recebe a importação.
Como evitar que aconteça de novo?
Abra o app do WhatsApp Business no telefone principal regularmente, com o telefone online, e deixe que ele sincronize. A Meta enquadra a regra no dispositivo principal, e, no nosso monitoramento, mensagens enviadas ou recebidas pela API não contam como atividade nele. A Meta publica um número aproximado, cerca de 14 dias, não uma hora exata, então um hábito semanal deixa uma margem confortável.
Formas práticas que as empresas adotam: um lembrete recorrente na agenda para quem cuida do telefone, deixar o telefone principal na recepção e não numa gaveta, e responder pelo menos algumas conversas direto do telefone em vez de só pelo WhatsApp Web. Um monitoramento que avisa a queda no mesmo dia transforma uma semana silenciosa em alguns minutos de indisponibilidade.
Em que se diferencia de outras desconexões?
O campo de motivo separa um telefone parado de um número que realmente foi embora, e cada um tem a sua solução.
PRIMARY_INACTIVITY: o app ficou cerca de 14 dias sem ser aberto. Abra-o e depois reconecte o mesmo número.COMPANION_INACTIVITY: um dispositivo vinculado ficou cerca de 30 dias sem uso. Abra o app no telefone e depois reconecte.USER_RE_REGISTERED: o número foi registrado em um novo dispositivo. Reconecte pelo telefone que o tem agora.CHANGE_NUMBERouBUSINESS_DOWNGRADE: um número diferente, ou a volta para o app de consumo. É preciso uma nova conexão.- Uma restrição é uma decisão de cumprimento de regras, não uma desconexão. Reconectar não a remove.
Como configurar
- Open the app on the primary phoneOpen WhatsApp Business on the phone that holds the number, with mobile data or Wi-Fi on, and wait until the chats finish syncing.
- Start the connect flow againOn the number's page in the dashboard, click "Reconnect this number", or start Embedded Signup from your provider, and log in with a Meta account that administers the business portfolio.
- Choose the same portfolio and numberPick the same business portfolio and WhatsApp Business Account. In our experience Meta recognizes the number and offers, pre-checked, to restore what it had before.
- Confirm on the phoneScan Meta's QR code from inside the WhatsApp Business app, confirm the connection and decide whether to share chat history.
- Check delivery end to endConfirm the webhook destination is set, send a test message from a customer phone, and check that your automation or system answered it.
Erros comuns
- Executar o fluxo de conexão enquanto o telefone está offline ou o app não foi aberto. Abra o app e deixe que ele sincronize antes, ou a reconexão pode falhar na etapa do telefone.
- Supor que o destino do webhook voltou com a conexão. A Meta o remove junto com o app, então o seu sistema continua em silêncio até que ele seja configurado de novo.
- Tratar o PARTNER_REMOVED com PRIMARY_INACTIVITY como um cliente que foi embora. É a desconexão mais recuperável que existe.
- Contar com a atividade do WhatsApp Web para manter o número ativo. A regra observa o telefone principal, e um principal ocioso também desconecta os seus companheiros.
Depois de reconectar, o destino de mensagens salvo é restaurado automaticamente e as automações voltam a responder. De US$ 9 a US$ 0.75 por número por mês, com o preço caindo conforme você adiciona números, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
É exatamente 14 dias?
A Meta documenta como aproximadamente 14 dias de inatividade do dispositivo principal e não publica uma hora exata. Abrir o app pelo menos a cada 10 dias, ou semanalmente, evita o limite.
Os meus clientes percebem a desconexão?
Não diretamente. As mensagens deles chegam ao app no telefone normalmente. O que eles percebem é que as respostas automáticas param até que o número seja reconectado.
Minha agência ou desenvolvedor pode reconectar para mim?
Podem executar a parte no navegador com um login da Meta que administra o Portfólio de Negócios, mas a confirmação acontece no app do WhatsApp Business, então alguém com o telefone precisa participar.
Eu sou cobrado enquanto o número estiver fora do ar?
Com o easyCoexistence, o número continua no seu plano enquanto estiver fora, já que identificar essa queda é justamente o que o monitoramento faz, e reconectar não gera cobrança adicional. Remova o número para parar a cobrança.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em