Como migrar um número do WhatsApp Business para outro provedor

Este guia é para líderes de operações, CX e TI que já enviam mensagens pela API do WhatsApp Business e querem trocar de provedor sem perder o número, o selo verde ou meses de trabalho com modelos. Ao final, você saberá exatamente o que a Meta leva junto, o que precisa mover por conta própria e como planejar a virada com o mínimo de interrupção.

É possível mover um número do WhatsApp Business para outro provedor?

Sim. A Meta permite migrar um número comercial de um Solution Partner e de uma WhatsApp Business Account (WABA) para outros. O número permanece o mesmo, e os clientes continuam escrevendo no chat que já conhecem.

Na documentação para desenvolvedores, a Meta descreve dois caminhos:

• Migração via Embedded Signup. O cliente inicia o fluxo na tela de onboarding do novo provedor. A Meta cria a WABA de destino, vincula-a ao portfólio empresarial da Meta do cliente e concede acesso ao app do provedor. A Meta chama essa de opção preferencial.
• Migração programática. O provedor de destino executa as chamadas de API. A Meta recomenda esse caminho principalmente quando o provedor será o titular da WABA em nome do cliente (o modelo "On-Behalf-Of").

Tecnicamente, uma nova WABA é criada e o número é associado a ela. Esse detalhe importa, porque tudo que está ligado à WABA antiga, mas não ao número, precisa ser refeito.

O que é transferido e o que não é?

A reputação do número é transferida; seus dados operacionais, não. A tabela resume a documentação da Meta e a realidade prática de trocar de plataforma.

Dois limites merecem destaque. Primeiro, números migrados só podem ser registrados na Cloud API. Segundo, números de teste fornecidos pelo WhatsApp não podem ser migrados de forma alguma.

O que você precisa antes de começar?

A migração falha com mais frequência porque algum pré-requisito foi esquecido. A Meta lista estes requisitos para a empresa titular do número:

• O portfólio empresarial da Meta tem status verificado.
• A WABA existente tem status aprovado.
• A WABA existente tem uma forma de pagamento válida vinculada.
• O número tem um nome de exibição aprovado e nenhuma alteração de nome de exibição pendente.
• A verificação em duas etapas está desativada no número.

A verificação em duas etapas é o PIN de seis dígitos que protege o registro do número. Não existe endpoint de API para desativá-la; se o seu provedor atual é titular da WABA, você precisa pedir que ele a desligue no WhatsApp Manager. Faça esse pedido cedo e por escrito.

No lado do destino, pelo menos um app deve estar inscrito nos webhooks da nova WABA antes de o número ser movido.

Como migrar, passo a passo?

A sequência abaixo segue o caminho de migração via Embedded Signup da Meta, com etapas de preparação no início e no fim.

Antes do dia da migração

1. Faça o inventário. Liste modelos (nome, idioma, categoria, status, qualidade), webhooks, integrações, fluxos de chatbot e respostas salvas.
2. Exporte seus dados. Solicite ao provedor atual o histórico de conversas, contatos, tags e registros de opt-in em CSV ou JSON. Não conte com a Meta para o histórico: a Cloud API mantém dados de mensagens por no máximo 30 dias.
3. Limpe os modelos. Exclua os que não são usados e corrija os de baixa qualidade. Somente modelos aprovados e verdes são copiados.
4. Refaça as integrações na nova plataforma, usando um número de teste, incluindo webhooks de CRM e gatilhos de pedidos ou agendamentos.
5. Combine uma janela de virada com os dois provedores, de preferência em um período de pouco tráfego e sem campanhas agendadas.

No dia da migração

1. Desative a verificação em duas etapas no número pelo WhatsApp Manager, ou confirme que o provedor antigo já o fez.
2. Inicie primeiro a migração de modelos, se o provedor de destino a oferecer. A Meta observa que a duplicação leva tempo, e começá-la antes do registro do número evita indisponibilidade de modelos.
3. Conclua o Embedded Signup com o novo provedor, informando o mesmo número e o mesmo nome de exibição.
4. O novo provedor compartilha sua linha de crédito (ou sua cobrança é configurada), inscreve os webhooks e registra o número na Cloud API. O registro é a etapa que move o número.
5. Reative a verificação em duas etapas com um novo PIN, guardado no seu próprio gerenciador de senhas.

Após a virada

1. Envie um modelo de teste e uma resposta de sessão e confirme que os webhooks de status chegam.
2. Verifique quais modelos não foram duplicados e reenvie-os.
3. Acompanhe a qualidade dos modelos nos primeiros dias, já que as classificações começam como desconhecidas.
4. Confirme que os agentes conseguem ver e responder aos novos chats.

O que causa indisponibilidade ou interrupção?

O registro do número é instantâneo, então o risco raramente é o WhatsApp "cair". O risco é que as peças ao redor não estejam prontas.

• Lacunas de modelos. Até a duplicação terminar, os modelos afetados não podem ser enviados. Modelos de OTP e de atualização de pedidos são os mais sensíveis.
• Lacunas de webhook. Mensagens recebidas antes de o webhook da nova plataforma entrar no ar podem não chegar aos agentes.
• Cobrança. A Meta informa que mensagens entregues antes da conclusão da migração são cobradas do Solution Partner antigo, e as entregues depois são cobradas da empresa. Combine com os dois provedores como serão tratados a fatura final e eventual saldo pré-pago.
• Reavaliação de categoria. Modelos duplicados têm a categoria reavaliada. Se um for reclassificado, por exemplo de utilidade para marketing, mudam os custos e as regras de opt-in. Veja nosso guia sobre categorias de modelos.

Exemplo prático: um grupo de clínicas de Dubai troca de provedor

Um exemplo sintético. A "Marina Health" opera três clínicas em Dubai com um único número de WhatsApp com selo verde. Ela envia lembretes de consulta, avisos de resultados de exames e, ocasionalmente, marketing.

A equipe faz o inventário de 42 modelos. Nove estão pausados ou rejeitados; eles excluem seis e reescrevem três. Exportam da caixa de entrada antiga 12 meses de histórico de conversas e registros de opt-in para arquivo próprio.

O novo provedor constrói o webhook do sistema de agendamento em um número de teste. Numa sexta-feira à tarde, quando o volume de lembretes é menor, o provedor antigo desativa a verificação em duas etapas. A migração de modelos começa primeiro; depois a clínica conclui o Embedded Signup e o número é registrado. Dois modelos não passam na reavaliação de categoria e são reenviados. Os lembretes voltam no mesmo dia, o selo verde permanece e os agentes trabalham na nova caixa de entrada já no sábado de manhã.

Erros comuns a evitar

• Alterar o nome de exibição durante o projeto. Uma alteração pendente bloqueia a migração.
• Esquecer a verificação em duas etapas. É o bloqueio mais comum, e só o titular da WABA pode desativá-la.
• Supor que o histórico acompanha. Ele não acompanha. Exporte antes.
• Migrar com modelos ruins. Modelos de baixa qualidade não são transferidos, e você perde a aprovação deles.
• Não ter plano de reversão. Mantenha as integrações antigas disponíveis até que a nova configuração esteja validada.
• Perder o PIN. Defina um novo PIN de duas etapas após a migração e guarde-o onde sua equipe, e não um fornecedor, tenha o controle.

Como a OmniChannels.ai ajuda

A OmniChannels.ai, com tecnologia da BroadNet Technologies, Meta Business Solution Provider oficial, ativa números na API do WhatsApp Business pelo Embedded Signup da Meta, o mesmo fluxo que a Meta prefere para migrações. Depois da conexão, você pode recriar os modelos com variáveis, mídia e botões, conferi-los na pré-visualização no celular e acompanhar o status de aprovação. As conversas chegam ao Omni Inbox junto com Instagram, Telegram e e-mail, com suporte a árabe e inglês. Relatórios de entrega com exportação em CSV ajudam a confirmar que os modelos estão sendo entregues após a virada, e a API REST e os webhooks têm documentação pública. Fale conosco para planejar uma migração.