Agendar Demo
Cases
Agendar Demo

Como migrar um número de WhatsApp de outra plataforma para a Nuvia

O que verificar antes, o passo a passo correto e o que fazer quando a conexão falha ao trazer um número que já esteve em outro provedor (Blip, Zendesk, Take e outros).

Disponível em
contas com canal WhatsApp Cloud API .
Quem pode fazer
o processo exige acesso de administrador à Meta Business Manager que hoje controla o número. Módulo: Menu lateral > Configurações > Canais

Nesta página6 seções

Se o número que você quer usar na Nuvia já está (ou já esteve) ativo em outra plataforma de atendimento, a conexão exige alguns cuidados. Não basta conectar pela Nuvia: o número continua amarrado à conta de WhatsApp da plataforma antiga, e é essa amarra que precisa ser desfeita primeiro.

Módulo: Menu lateral > Configurações > Canais

Conceitos que você precisa entender antes

Três coisas diferentes costumam ser confundidas, e essa confusão é a causa da maioria das falhas de migração.

ConceitoO que é
Número O telefone em si. É o que você quer migrar.
WABA (WhatsApp Business Account) A “conta” da Meta onde o número fica pendurado. Uma WABA pode ter vários números. É aqui que mora o problema: a WABA guarda o vínculo com a plataforma antiga.
BSP (Business Solution Provider) O provedor que intermediava o WhatsApp antes (exemplo: Blip, Zendesk, Take etc). Ele é quem “detém” a WABA antiga.
BM (Business Manager) A conta empresarial da sua empresa na Meta, que abriga as WABAs.

O que verificar antes de tentar conectar

Confirme estes dois pontos com quem administra a Business Manager que hoje controla o número:

  • A verificação em duas etapas (2FA) do número precisa estar desativada. Este é, de longe, o motivo mais comum de falha. Enquanto o 2FA estiver ligado na conta antiga, qualquer tentativa de conectar o número em outro lugar trava e o erro que aparece costuma ser genérico, sem dizer o motivo real.

  • A WABA de origem precisa estar com status aprovado, sem pendências.

Passo a passo da migração

  1. Peça a liberação ao provedor antigo. Solicite formalmente que a plataforma anterior libere o número. Dependendo do provedor, isso leva alguns dias.

  2. Desative o 2FA do número na Business Manager antiga.

  3. Confirme que o número foi realmente liberado. Veja a seção de erros comuns abaixo, pois alguns provedores demoram ou simplesmente não soltam o número no primeiro pedido.

  4. Conecte o número pela Nuvia, seguindo o passo a passo de Como conectar o WhatsApp na Nuvia.

  5. Ao escolher a conta durante a conexão, selecione uma WABA diferente da original: uma WABA nova, ou uma existente que nunca tenha sido vinculada a um BSP.

  6. Confirme que o canal aparece ativo em Configurações > Canais e que o número está vinculado a uma caixa de entrada.

Depois de reconectar: atualizar os números

Quando o número volta em uma WABA nova, o identificador da WABA e o ID do número mudam. A Nuvia precisa saber disso.

  1. Acesse Integrações > WhatsApp

  2. Clique em Atualizar números

A Nuvia refaz a verificação e atualiza a caixa de entrada vinculada àquele número com os novos dados de WABA e de ID. Isso é o que faz o canal voltar a funcionar sem precisar recriar nada.

Erros comuns e o que fazer

SituaçãoO que está acontecendoO que fazer
A conexão falha com erro genérico O 2FA do número ainda está ativo na conta antiga Peça ao administrador da BM antiga para desativar o 2FA daquele número
O número conecta, mas não envia mensagens e não dá para trocar a forma de pagamento O número foi reconectado na mesma WABA antiga Refaça a conexão escolhendo uma WABA nova
O número aparece como pendente na Business Manager O provedor antigo ainda não liberou o número de fato Cobre a liberação diretamente com o provedor antigo. Sem isso, nenhuma tentativa de conexão vai funcionar
O botão Registrar na Meta diz que deu certo, mas o número continua sem funcionar O número segue preso ao provedor antigo Mesmo caso acima: a solução está do lado do provedor, não na Nuvia
O número sumiu da Business Manager e o canal parou Em contas com WhatsApp Coexistence, o dono do número pode ter desconectado pelo próprio celular Peça ao dono do número para verificar no aplicativo se a conexão com a plataforma foi removida
O canal existe na Nuvia mas o número não está vinculado a nenhuma caixa de entrada O canal foi excluído em algum momento do processo Fale com o suporte da Nuvia para reativar o canal antes de usar Atualizar números

Como saber se deu certo

  • O número aparece em Configurações > Canais com status ativo

  • O número está vinculado a uma caixa de entrada

  • O número aparece na WABA nova dentro da Business Manager, sem status pendente

  • Uma mensagem de teste é enviada e recebida normalmente

Perguntas frequentes

Quanto tempo leva a migração?

A parte que depende da Nuvia é imediata. O que costuma demorar é a liberação do número pelo provedor antigo, que pode levar alguns dias. Planeje a migração com essa folga e evite marcar a virada para um dia de pico de atendimento.

Preciso mesmo criar uma WABA nova? Não dá para usar a que já existe?

Dá para usar uma WABA que já existe, desde que ela nunca tenha sido vinculada a um BSP. O que não funciona é reconectar o número na mesma WABA que estava com o provedor antigo, nesse caminho a conexão não opera de verdade e você fica sem conseguir configurar a forma de pagamento. Na dúvida, crie uma WABA nova.

Perco o histórico de conversas do provedor antigo?

Sim. O histórico de mensagens fica na plataforma anterior e não é transferido junto com o número, a migração move apenas o número. Se esse histórico for importante, exporte-o na plataforma antiga antes de concluir a migração.

Meus templates aprovados vêm junto?

Não. Templates HSM são aprovados por WABA. Como o número vai para uma WABA diferente, os templates precisam ser criados e submetidos à aprovação da Meta novamente. Veja Como gerenciar templates HSM.

A conta antiga precisa ter forma de pagamento configurada para liberar o número?

Não. O que precisa estar resolvido é o 2FA desativado e a WABA de origem sem pendências. A forma de pagamento é configurada na conta nova, depois que o número já estiver conectado.

Cliquei em Atualizar números e nada mudou. E agora?

Verifique se o canal daquele número ainda existe em Configurações > Canais. Com o canal excluído, a atualização não reconcilia nada. Se o canal foi apagado, fale com o suporte da Nuvia para reativá-lo antes de tentar de novo.

Este artigo ajudou?