Migrar número para a API do WhatsApp: o passo a passo

Profissional confere o celular antes de migrar o número do WhatsApp Business para a API oficial do WhatsApp

Dá para migrar o número do WhatsApp Business para a API oficial mantendo o mesmo telefone: o que muda é o caminho escolhido e o que sobrevive depois dele. Para usar um número do aplicativo WhatsApp Business na Cloud API, a Meta exige que a conta desse número seja apagada ou que a ativação seja feita por um parceiro que ofereça onboarding de números do aplicativo. Na rota direta, o histórico de conversas é perdido e o número deixa de funcionar no aplicativo; pela rota de parceiro, o histórico fica salvo e o aplicativo segue ativo. A decisão começa com backup, prazo e uma conta honesta do custo do atendimento após a mudança.

Os dois caminhos da migração

A Meta documenta duas formas de levar para a plataforma de API um número que já atende clientes no WhatsApp Business. A primeira é apagar a conta do número dentro do aplicativo e registrá-lo em seguida na Cloud API, processo que a própria equipe executa com acesso à conta da Meta. A segunda é ativar a plataforma por meio de um parceiro que suporte o onboarding de números do aplicativo, formato em que a migração acontece sem apagar nada.

As consequências práticas são bem diferentes. Se a conta for apagada e o número registrado na Cloud API, o histórico existente é perdido e o número não volta a funcionar no aplicativo WhatsApp Business enquanto permanecer registrado na Cloud API — o retorno ao aplicativo só é possível desregistrando o número da API. Já no caminho do parceiro, o histórico é preservado e o aplicativo WhatsApp Business continua funcionando ao lado da plataforma do parceiro, com uso simultâneo das duas frentes. Para quem tem uma equipe pequena que depende do celular no dia a dia, essa diferença costuma pesar mais do que qualquer outro critério.

Critério Rota direta (apagar a conta) Rota com parceiro que suporta o aplicativo
Histórico de conversas Perdido após o registro na Cloud API Preservado
Uso do WhatsApp Business app Bloqueado enquanto o número estiver na API Aplicativo e plataforma funcionam ao mesmo tempo
Retorno ao aplicativo Somente desregistrando o número da Cloud API Desnecessário
Quem executa Sua equipe, com acesso à conta Meta Business Parceiro contratado

Backup antes de apagar a conta

O backup é o passo que separa uma migração planejada de uma perda definitiva de histórico na rota direta: a documentação de migração da própria Meta lembra de salvar as conversas antes de apagar a conta. Para quem vai pelo Android, o guia oficial do WhatsApp orienta salvar uma cópia manual em Ajustes, Conversas e Backup de conversas antes de qualquer mudança, com opção de agendar backups recorrentes e de criar uma cópia criptografada de ponta a ponta. No iPhone, siga o guia oficial de backup indicado na mesma documentação de migração.

Além das conversas, exporte a lista de contatos e registre em uma planilha as etiquetas, respostas rápidas e mensagens de ausência que a equipe usa. Esses recursos vivem no aplicativo; com o histórico perdido na rota direta, a organização do atendimento precisa ser recriada na nova plataforma, e ter essa lista em mãos encurta a semana seguinte à migração.

Passo a passo na Meta

  1. Faça o backup das conversas do número no aplicativo, seguindo o guia oficial de backup do WhatsApp.
  2. Abra Ajustes > Conta > Apagar minha conta no aplicativo WhatsApp Business e confirme o apagamento daquele número. Mensagens enviadas para o número nesse intervalo ficam em fila enquanto ele é liberado.
  3. Aguarde até 3 minutos até o número desconectado ficar disponível para registro.
  4. Adicione o número à sua conta no WhatsApp Manager e comprove a propriedade dele seguindo o fluxo de verificação indicado.
  5. Registre o número na chamada de registro da Cloud API, definindo o PIN de seis dígitos da verificação em duas etapas.

Se a escolha foi a rota de parceiro, os passos de apagamento e registro são conduzidos pela plataforma contratada, e a equipe apenas acompanha a transição sem interromper o atendimento.

Limites e erros do registro

O registro é uma etapa técnica com regras próprias: ele é concluído na chamada de API de registro, e não pelo WhatsApp Manager. Para evitar tentativas repetidas em loop, o endpoint de registro aceita no máximo 10 requisições por número de negócio em qualquer janela de 72 horas; ao estourar o limite, a API bloqueia novos registros daquele número pelo mesmo período e devolve o código de erro 133016. Se o registro falhar, trate a causa — verificação de propriedade pendente, PIN incorreto — antes de repetir a chamada, em vez de insistir até travar o número. Guarde o PIN em um cofre compartilhado da equipe: ele protege o número na verificação em duas etapas e evita bloqueios de acesso no futuro.

O que muda no dia seguinte

Com o número registrado na API, o atendimento passa a sair da plataforma conectada, e o aplicativo deixa de ser a frente de trabalho daquele número na rota direta. Ajuste a rotina da equipe na primeira semana: distribua as conversas com regras claras de fila, defina quem responde o quê e monitore o tempo de primeira resposta, porque o cliente não percebe a migração — percebe apenas a demora.

Depois da migração, vale reconstruir a base de consentimento: o opt-in duplo no WhatsApp documenta o consentimento de cada contato na nova plataforma e reduz o risco de bloqueio em campanhas futuras. Antes de migrar, rode também a conta financeira: calcule o custo do atendimento humano ou automatizado e compare com o custo por conversa da API no seu volume real de mensagens. Quem envia poucas mensagens por mês pode descobrir que a migração não se paga; quem já perde vendas por demora no celular tende a ver a troca com outros olhos.

Fontes