EntrarComeçar teste grátis
Meta Tech Provider

Como desconectar a Coexistência e voltar a usar só o app

A Coexistência é desligada no próprio app do WhatsApp Business: Configurações, Conta, Plataforma Business e Desconectar conta. O app continua funcionando no número, o acesso do provedor termina e um webhook account_update com PARTNER_REMOVED é enviado. O endpoint Deregister da Cloud API não pode ser usado em um número que roda nos dois lugares.

Settings > Account > Business Platform

Onde fica o botão Desconectar conta no app do WhatsApp Business.

PARTNER_REMOVED

O evento account_update que a Meta envia quando o negócio se desconecta da Cloud API.

Not allowed

Cancelar pela API o registro de um número em uso na Cloud API e no app do WhatsApp Business ao mesmo tempo.

Como desligo a Coexistência?

Pelo celular que tem o número. A Meta documenta um único caminho para um negócio sair da Cloud API quando o número é compartilhado com o app do WhatsApp Business, e ele passa pelo app, não por um painel ou endpoint. Quem tem o celular principal toma a decisão, então uma agência ou um desenvolvedor pede ao negócio que faça isso.

  • Abra o app do WhatsApp Business no dispositivo principal.
  • Vá em Configurações, depois Conta, depois Plataforma Business.
  • Toque em Desconectar conta e confirme.
  • Espere um webhook account_update com o evento PARTNER_REMOVED no lado da API.

Por que a API Deregister recusa o número?

Porque a Meta exclui de propósito os números em Coexistência. A documentação de registro afirma que o endpoint Deregister não pode cancelar o registro de um número de telefone comercial em uso na Cloud API e no app do WhatsApp Business ao mesmo tempo.

Cancelar o registro é a operação que torna um número inutilizável na Cloud API e, em um número só de API, é a forma de tirá-lo da plataforma. Em um número compartilhado, o app é o dono principal do número, então a Meta devolve a decisão a quem está com o aparelho. Um software que tenta o endpoint primeiro recebe um erro, não uma desconexão, e o número continua conectado até alguém tocar no botão do app.

O que acontece com o app, o histórico e o número?

Desconectar não é o mesmo que excluir a conta, e essa diferença é a resposta inteira.

O aviso da Meta sobre perda do histórico de mensagens vale para quem exclui a conta do app do WhatsApp Business e registra o número na Cloud API. Desconectar não faz nenhuma das duas coisas. O app continua instalado e registrado, o número continua nele e a equipe segue atendendo os clientes pelo mesmo celular.

O que termina é o lado da API. O app do provedor é removido do número, então o envio pela Cloud API e a entrega de webhook para ele param. Os recursos que a Coexistência desligou, como as listas de transmissão, estão na página sobre recursos desativados.

O número pode ser conectado de novo depois?

Sim, executando o fluxo de onboarding de novo desde o início. A própria documentação da Meta trata o offboarding e a repetição do fluxo como a forma normal de reiniciar uma conexão, por exemplo quando a janela de 24 horas para sincronizar contatos e histórico foi perdida.

Uma reconexão é um novo onboarding, então as perguntas feitas na primeira vez são feitas outra vez, inclusive se o histórico de conversas será compartilhado. Tudo que foi configurado na conexão antiga, como um override de webhook, precisa ser aplicado de novo. Um número que deve migrar para outro provedor segue o mesmo caminho: desconectar aqui e depois fazer o onboarding com o novo.

Erros comuns

  • Chamar o endpoint Deregister em um número em Coexistência. A Meta recusa; a desconexão é feita no app.
  • Excluir a conta do app do WhatsApp Business para sair. Esse é o caminho que perde o histórico de conversas.
  • Tratar PARTNER_REMOVED como uma queda a ser repetida. É uma desconexão deliberada feita pelo negócio.
Fazendo isso com o EasyCoexistence

A EasyCoexistence registra o evento PARTNER_REMOVED na linha do tempo da conexão no momento em que a Meta o envia, e assim uma desconexão feita pelo celular aparece no painel em vez de ser descoberta no próximo envio que falhar.

Perguntas frequentes

Vou perder minhas conversas se eu desconectar?

Não. Desconectar remove a API do número; não exclui a conta do app do WhatsApp Business, que é o que a Meta avisa que faz perder o histórico.

Posso desconectar pela API?

Não. A Meta não permite o endpoint Deregister em um número em uso na Cloud API e no app ao mesmo tempo.

Como meu sistema sabe que isso aconteceu?

A Meta envia um webhook account_update com o evento PARTNER_REMOVED quando o negócio se desconecta.

Posso reconectar o mesmo número?

Sim. Execute o fluxo de onboarding de novo desde o início, como na primeira conexão.

Continue lendo

Moving a number from Coexistence to Cloud API onlyTaking a number off the WhatsApp Business app and running it on Cloud API alone: the order of steps, the history Meta says is lost, and what changes.Migrating a number from another WhatsApp providerMoving a WhatsApp number that already sits with another provider: the Coexistence case, the API-only case, what Meta carries over and what resets.Changing the phone number on a Coexistence connectionWhy changing the number in the WhatsApp Business app ends a Coexistence connection, what the new number needs, and what to do with the old one.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.Which WhatsApp features stop working after CoexistenceDisappearing messages, view once, live location and broadcast lists are switched off on a connected number. What each one means in practice.Coexistence referenceWhat Coexistence is, how messages flow, what it costs, what it cannot do, eligibility, and how to roll it back. The short reference version.

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em

Como desconectar a Coexistência