Como migrar para a API oficial do WhatsApp

Resposta rápida (TL;DR)

Migrar um número para a API oficial do WhatsApp tem dois caminhos. No primeiro, você apaga a conta daquele número no aplicativo e registra o número na Cloud API: o histórico do aparelho não vai junto e o número deixa de funcionar no aplicativo. No segundo, você entra por um provedor que suporta uso conjunto, mantém o aplicativo funcionando lado a lado e sincroniza contatos e conversas dos últimos 180 dias. A indisponibilidade em si é curta, porque a Meta cita até 3 minutos para o número desconectado ficar disponível, e as mensagens recebidas nesse intervalo entram em fila. O ponto sem volta é apagar a conta: faça backup antes.

O que significa migrar para a API oficial

Migrar é tirar o número do modo aplicativo e registrá-lo na plataforma, para que ele passe a enviar e receber mensagens por integração. Existem dois caminhos oficiais e eles produzem resultados bem diferentes.

Caminho 1, exclusão. Você apaga a conta daquele número no aplicativo WhatsApp ou no WhatsApp Business e registra o número na Cloud API. Depois disso, o número segue servindo para ligações e SMS comuns, mas não pode mais ser usado no aplicativo.

Caminho 2, uso conjunto. Você entra pelo fluxo de um provedor que suporta a entrada de números do aplicativo WhatsApp Business. O número passa a funcionar nos dois mundos ao mesmo tempo: atendimento individual no aplicativo e escala pela API, com o histórico sincronizado entre os dois.

O que se perde em cada caminho

Item	Apagando a conta e registrando	Uso conjunto via provedor
Histórico de conversas	Perdido. Só resta o backup que você fizer antes.	Preservado e sincronizado, se a empresa autorizar o compartilhamento.
Aplicativo WhatsApp Business	Deixa de funcionar com aquele número.	Continua funcionando lado a lado com a API.
Conversas em grupo	Não existem na API.	Não são sincronizadas.
Ferramentas do aplicativo	Catálogo, etiquetas, respostas rápidas e mensagens de saudação não existem na API.	Seguem no aplicativo, mas não são suportadas pela API.

No uso conjunto, alguns recursos são desligados no aplicativo assim que a conexão é feita: mensagens temporárias, visualização única e localização em tempo real são desativadas nas conversas individuais, e as listas de transmissão ficam somente leitura, sem permitir criar novas. Os dispositivos conectados são desvinculados e precisam ser vinculados de novo.

Ordem das etapas, do jeito que funciona

Decida o caminho antes de mexer no aparelho. Se o histórico importa, o uso conjunto é a única forma oficial de preservá-lo.
Faça backup do histórico do aplicativo, em Android ou iPhone, antes de qualquer exclusão.
Prepare a estrutura na Meta: portfólio de negócios, conta de WhatsApp Business e meio de pagamento, como detalha o guia sobre como obter a API oficial do WhatsApp.
Avise a operação. Quem responde o número precisa saber a hora exata do corte.
Apague a conta do número no aplicativo, em Configurações, Conta, Apagar minha conta. As mensagens enviadas ao número nesse intervalo ficam em fila.
Espere o número liberar. A Meta indica que pode levar até 3 minutos para o número desconectado ficar disponível.
Adicione e verifique o número por SMS ou chamada, defina o nome de exibição e o PIN de verificação em duas etapas.
Registre o número na Cloud API. Adicionar pelos painéis comprova a posse, mas não conclui o registro.
Suba os modelos de mensagem e só então religue as automações.

A janela de indisponibilidade real

A parada técnica é curta. O que costuma doer é o entorno: modelo ainda não aprovado, integração não testada e equipe sem acesso à nova caixa de entrada. Migração feita numa sexta à tarde, com a análise de modelo em curso, produz um fim de semana inteiro sem canal de saída, mesmo com o número já registrado.

Reduza a janela fazendo o inverso da ordem intuitiva: deixe conta, meio de pagamento, integração e conteúdo dos modelos prontos primeiro, e só depois apague a conta do aplicativo. O corte deixa de ser um projeto e vira um passo de poucos minutos.

Plano de retorno: dá para voltar atrás?

Depende do caminho. No uso conjunto, o cliente desconecta da plataforma pelo próprio aplicativo, em Configurações, Conta, Plataforma de Negócios, no botão de desconectar. É reversível por desenho.

No caminho da exclusão, voltar exige cancelar o registro do número na plataforma. Vale saber duas restrições antes de contar com isso: apenas administradores do portfólio podem excluir um número de negócio, e a exclusão não é permitida se o número enviou mensagens pagas nos últimos 30 dias. Além disso, excluir um número é irreversível e obriga a verificar tudo de novo para readicioná-lo. O histórico apagado no aparelho não volta em nenhum dos cenários.

Uso conjunto: o que a sincronização traz

Quando a empresa autoriza o compartilhamento, o provedor recebe as conversas trocadas nos 180 dias anteriores à entrada, organizadas em três fases: do dia zero ao dia 1, do dia 1 ao dia 90 e do dia 90 ao dia 180. Conversas em grupo ficam de fora. Mensagens de mídia chegam sem o arquivo, exceto as enviadas nas duas semanas anteriores.

Três detalhes operacionais mudam o resultado. O aplicativo precisa estar em versão 2.24.17 ou superior. O provedor tem 24 horas após a entrada para sincronizar contatos e histórico, senão o processo precisa ser refeito do zero. E o número em uso conjunto fica com vazão fixa de 20 mensagens por segundo, contra as 80 padrão de um número só de API, algo que só pesa em operação de disparo grande, como mostra o guia sobre limites da API oficial do WhatsApp.

Sobre custo, a regra é simples: o que sai pelo aplicativo continua gratuito, e o que sai pela API é cobrado pela tabela da Meta, que varia por país e por categoria de modelo.

Migração entre provedores: o que viaja com o número

Trocar de fornecedor não exige número novo. A migração leva o número de uma conta de WhatsApp Business para outra e preserva parte da reputação construída.

O que vai junto	O que fica para trás	Detalhe
Nome de exibição	Modelos de baixa qualidade, rejeitados ou pendentes	Só modelos aprovados e de alta qualidade são duplicados.
Nota de qualidade do número	Nota de qualidade dos modelos	Todo modelo migrado recomeça sem nota nas primeiras 24 horas.
Limite de mensagens	Números de teste	Números de teste da Meta não podem ser migrados.
Status de conta oficial	Migração em lote	A API migra um número por vez.

A sequência é sempre iniciada por quem recebe o número: desativar a verificação em duas etapas na origem, iniciar a migração pela conta de destino, verificar a posse do número com o código recebido e registrar o número de novo com o PIN. A conta de origem precisa ter a verificação de empresa aprovada, e a de destino precisa de verificação, meio de pagamento e ao menos um aplicativo assinando os webhooks. Os modelos duplicados passam de novo pela checagem de categoria, então alguns podem chegar rejeitados do outro lado.

Erros comuns na migração

Apagar a conta do aplicativo sem backup. O histórico não é recuperável depois, e não existe migração de conversas nesse caminho.
Migrar antes de ter modelo aprovado. Sem modelo, o número registrado só responde quem escreveu primeiro.
Apagar a conta de WhatsApp Business de origem antes de conferir os modelos. A recomendação da Meta é validar que tudo foi duplicado no destino antes de excluir a origem.
Esquecer a verificação em duas etapas. Ela precisa estar desativada no número para a migração entre contas começar.
Contar com o retorno rápido ao aplicativo. Número que enviou mensagem paga nos últimos 30 dias não pode ser excluído da plataforma.
Tratar o uso conjunto como cópia do aplicativo. Grupos, catálogo, etiquetas e chamadas não existem do lado da API, tema tratado no comparativo entre API oficial e aplicativo WhatsApp Business.

Perguntas frequentes (FAQ)

Como faço para migrar meu número do WhatsApp Business para a API oficial?

Há dois caminhos. Você apaga a conta daquele número no aplicativo, em Configurações, Conta, Apagar minha conta, e registra o número na Cloud API depois que ele libera. Ou entra pelo fluxo de um provedor que suporta uso conjunto, mantendo o aplicativo ativo em paralelo. Em ambos, prepare antes o portfólio de negócios, a conta de WhatsApp Business, o meio de pagamento e os modelos de mensagem.

Perco meu histórico de conversas ao migrar para a API oficial do WhatsApp?

Sim, se você apagar a conta do número no aplicativo para registrá-lo na Cloud API: o histórico do aparelho não vai junto. Faça backup antes, pelo próprio aplicativo. A exceção é o uso conjunto por um provedor compatível, em que contatos e conversas dos 180 dias anteriores podem ser sincronizados, sem incluir conversas em grupo, se a empresa autorizar o compartilhamento.

Quanto tempo o número fica indisponível durante a migração?

A parada técnica é curta: a Meta indica que pode levar até 3 minutos para o número desconectado ficar disponível, e as mensagens recebidas nesse intervalo entram em fila. O que costuma alongar a interrupção é o entorno, principalmente modelo de mensagem ainda em análise e integração não testada. Deixe tudo pronto antes e apague a conta do aplicativo apenas no último passo.

Dá para voltar a usar o aplicativo WhatsApp Business depois de migrar?

No uso conjunto, sim: o próprio aplicativo tem a opção de desconectar da plataforma, em Configurações, Conta, Plataforma de Negócios. No caminho da exclusão, é preciso cancelar o registro do número na plataforma, e há duas travas: só administradores do portfólio podem excluir um número, e a exclusão fica bloqueada se ele enviou mensagens pagas nos últimos 30 dias.

Como trocar de provedor da API oficial do WhatsApp sem perder o número?

A migração entre contas de WhatsApp Business preserva o nome de exibição, a nota de qualidade do número, o limite de mensagens, o status de conta oficial e os modelos aprovados de alta qualidade. Não vão junto os modelos de baixa qualidade, rejeitados ou pendentes, nem a nota dos modelos, que recomeça. A verificação em duas etapas precisa estar desativada e a migração ocorre um número por vez.

Continue lendo

Histórico de revisões

2026-07-27 · v1.0 · publicação inicial.

Sobre as marcas mencionadas

Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.