Mover um número da Coexistência para só Cloud API
Um número em Coexistência passa a usar só a API ao ser desconectado no app do WhatsApp Business, ter a conta do app excluída e ser registrado na Cloud API com um PIN de verificação em duas etapas. A Meta avisa que o histórico de mensagens existente é perdido, e o número só volta ao app se for removido do registro da Cloud API.
Histórico de mensagens existente quando um número do app Business é excluído e registrado na Cloud API.
Quanto tempo um número excluído pode levar para ficar disponível para registro.
Throughput padrão da Cloud API por número, contra 20 mps fixos em um número em Coexistência.
Requisições de registro permitidas por número comercial em uma janela móvel.
Por que uma empresa sairia do app?
Em geral porque ninguém mais responde pelo celular. Quando toda conversa é tratada por software ou por uma caixa de entrada construída sobre a API, o app só acrescenta obrigações: o dispositivo principal ainda precisa ser aberto com regularidade, e o número continua no throughput fixo da Coexistência.
A Meta documenta que números usados ao mesmo tempo no app e na Cloud API têm throughput fixo de 20 mensagens por segundo. Um número só de API começa com até 80 mensagens por segundo por padrão e pode ser elevado automaticamente para 1.000 quando cumpre as condições da Meta. Para um número que envia em volume, essa diferença é o motivo da mudança.
Qual é a ordem dos passos?
São quatro passos, e a ordem importa porque o endpoint Deregister recusa um número que ainda é compartilhado com o app. Cada passo é feito pela empresa no celular, exceto o último, que é uma chamada de API feita por quem vai operar o número daqui em diante.
- Faça backup do histórico de conversas no app do WhatsApp Business, como a Meta recomenda.
- Desconecte no app: Configurações, Conta, Plataforma Business, Desconectar conta.
- Exclua a conta do app: Configurações, Conta, Excluir minha conta, e aguarde até 3 minutos.
- Registre o número na Cloud API com um PIN de verificação em duas etapas de 6 dígitos.
O que a empresa deixa para trás?
As conversas do celular e o próprio celular como forma de responder.
A Meta afirma que excluir a conta do app do WhatsApp Business e registrar o número na Cloud API faz perder o histórico de mensagens existente. É o oposto do onboarding por Coexistência, em que a Meta indica que o histórico é preservado e os dois apps funcionam ao mesmo tempo.
O número também não pode voltar a ser usado no app do WhatsApp Business, a menos que seja removido do registro da Cloud API antes. Portanto, é uma mudança deliberada e sem volta na forma de trabalhar da empresa, e vale confirmar que ninguém na equipe ainda depende do app antes de começar.
O que continua igual no lado da API?
A forma como o software conversa com o número. Continua sendo a Cloud API: valem os mesmos tipos de mensagem, templates, webhooks e preços, porque a Coexistência sempre foi apenas outro onboarding para a mesma plataforma.
O que muda é o registro. Um número em Coexistência é registrado pelo fluxo de onboarding; um número só de API é registrado por uma chamada de registro com o PIN de verificação em duas etapas, e a Meta limita essas chamadas a 10 por número em uma janela móvel de 72 horas. Uma tentativa que falha, portanto, tem custo: confira o PIN antes de repetir.
Erros comuns
- Excluir a conta do app antes de fazer backup das conversas. A Meta afirma que, nesse caminho, o histórico se perde.
- Chamar Deregister enquanto o número ainda é compartilhado com o app. A Meta recusa a requisição.
- Repetir o registro em loop. A Meta permite 10 requisições de registro por número em 72 horas.
A EasyCoexistence conecta números por onboarding de Coexistência, então o app continua no lugar. Quando a empresa decide sair do app, a desconexão feita no celular fica registrada na linha do tempo da conexão, como qualquer outro evento.
Perguntas frequentes
Posso manter o histórico de conversas ao passar para só API?
Não pela API. A Meta avisa que o histórico se perde e recomenda fazer backup pelo app antes.
O número pode voltar ao app depois?
Só depois de ser removido do registro da Cloud API, segundo o guia de migração da Meta.
O throughput melhora?
Sim. Números em Coexistência ficam fixos em 20 mps; números só de API começam com até 80 mps.
Posso usar a API Deregister para começar?
Não enquanto o número for compartilhado com o app. Desconecte-o antes no app do WhatsApp Business.
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