Quando recebemos um cliente que já tem API Oficial, ou vamos migrar um cliente entre Brokers ou diretamente para Meta, existem uma série de coisas que devemos ter em mente e que aprendi ao longo de várias ativações bem e mal sucedidas. Abaixo estou elaborando um checklist.

Como preparar o ambiente

Como o processo de ativação pode exigir muitos envolvidos (cliente, terceiros, BM), o ideal é maximizar o que pode ser feito antes e minimizar a chance de dar problema na hora da migração, portanto abaixo seguem algumas coisas que DEVEM ser executadas ANTES do momento da migração.

Localizar Número

O primeiro passo é identificar onde está esse número e se o cliente tem acesso. Neste caso vemos 3 possibilidades principais:

• 🟢 Número está no Convert e conseguimos pegar código (melhor cenário, não precisa envolver o cliente na virada)

• 🟡 Número está em uma outra central com URA ou Mensagem (cenário mais complicado, pois precisa combinar com cliente momento onde outro fornecedor vai desabilitar)

• 🟡 Número está caindo direto em um telefone (tem que combinar com o cliente para ele estar lá e pegar o código)

• 🔴 Número está em um celular (se revelou pior cenário, pois cliente muitas vezes não sabe nem aonde está o chip)

Desabilitar 2FA

Este passo também é imprescindível para fazer a migração, pois como forma de segurança, a Meta bloqueia a ativação do número enquanto ele estiver ativo e é necessário desabilitar isso. Existem duas formas de desabilitar a 2FA:

• 🟢 Se o cliente é mais recente e fez onboarding via Embedded Signup, você consegue desabilitar 2FA pelo próprio BM

• 🟡 Se o cliente é muito antigo e fez o fluxo OBO (On Behalf Of), você precisa solicitar ao partner atual via suporte que desabilite o 2FA

Acesso ao BM

Após, o ideal é conseguir acesso ao BM para continuar o processo pelo nosso lado. Para isso, siga o guia para solicitar ao cliente.

Criar WABA

Para que seja possível configurar o pagamento, é necessário criar uma WABA que irá ser responsável por conter esse número.

Para criar uma WABA, devemos fazer através do fluxo de embedded signup de partner da Convert:

• Acesse o hub.convert.app.br

• Clique em Onboarding Meta Cloud API

• Clique em “Continuar como…”

• Escolha o BM

• Clique para Criar uma Waba

• Crie o nome da WABA no seguinte padrão: CLIENTE DDD 8408 1111 (celular deixar sem o nono dígito mesmo)

• Nos últimos ambientes que ativei, tive que colocar o nono dígito (12/2025)

• IMPORTANTE: O nome de exibição deve ser exatamente igual ao nome de exibição atual do número (isso faz com que falhe a virada). Para descobrir o nome de exibição, localize no seu WhatsApp a conta e pegue o nome que estará na primeira ou se houver segunda linha do contato.

• Quando chegar na parte de verificar o telefone, encerre o processo

• A WABA foi criada, pode seguir para o passo do pagamento

Configurar Pagamento

Para migrar um número de Broker, é IMPRESCINDÍVEL ter um pagamento configurado na conta nova, pois caso contrário a migração irá falhar na API de Registro. Para isso, configure o pagamento na WABA antes de fazer a virada.

A virada

Se o processo anterior de preparação do ambiente foi bem executado, a virada é o passo possivelmente mais fácil. Para isso, pode-se seguir o procedimento de onboarding.