Como migrar o número da API do WhatsApp de um provedor para outro

O que a Meta permite hoje ao trocar de provedor?

A resposta depende do modelo de conta. No modelo novo da Meta, o número mora na conta do WhatsApp e os templates e a cobrança moram na conta de mensagens (a mudança está explicada no gerenciador do WhatsApp). Como a Meta migrou as empresas em etapas, confirme com o seu provedor em qual modelo a sua conta está antes de planejar a troca.

No novo modelo, a documentação da Meta é direta: migrar um número de um parceiro para outro não é suportado. Desconectar o número da conta atual não o libera, e se a conta de destino não for dona do número, o pedido é recusado. O caminho oficial é outro: o cliente compartilha a sua conta do WhatsApp com o novo parceiro. O número fica onde está, as conversas continuam, e o compartilhamento é aditivo, o que significa que o cliente pode manter o parceiro atual enquanto adiciona o novo.

O que acontece com templates, qualidade e cobrança?

Na migração de uma conta de mensagens entre soluções, a Meta descreve a duplicação dos templates elegíveis para a conta de destino, e o teto de templates da conta de destino (250 sem verificação, até 6.000 com portfólio verificado e nome aprovado) limita quantos cabem. As regras de elegibilidade e de qualidade dos copiados estão na página oficial de migração e mudam com o tempo; confira lá antes de planejar. O que não for copiado precisa ser recriado e enviado de novo para aprovação.

• Aprovação: a Meta diz que a decisão pode levar até 24 horas, então recriar templates entra no cronograma da troca. Veja aprovação de template do WhatsApp.
• Limite de envio: é do portfólio empresarial desde 07/10/2025, e não do provedor. Detalhes em limite de envio do WhatsApp API.
• Cobrança: no novo modelo, cada parceiro é cobrado pela própria conta de mensagens. Combine por escrito quem paga as mensagens do período de transição e deixe a forma de pagamento da conta pronta (veja forma de pagamento do WhatsApp API).
• Webhook: o novo parceiro precisa assinar os webhooks da conta para receber respostas e status; sem isso, a campanha sai e o retorno não chega.

Quando vale trocar de provedor?

Troque quando o custo, o suporte ou a integração com o seu CRM deixarem de atender, e não por impulso. Antes de decidir, responda três perguntas: a ferramenta atual envia o que a campanha precisa (mídia, botões, lotes)? As respostas chegam ao atendimento sem perda? Quem responde por falha de envio e por conta restrita? Se a resposta for não para alguma, a troca tem motivo. Se a necessidade é só disparar uma campanha, existe um caminho mais curto: terceirizar o envio, como explica disparo em massa sem API própria.

Para entender o que cada tipo de empresa faz nessa camada, leia o que é BSP no WhatsApp e número para a API oficial do WhatsApp.

Como trocar de provedor, passo a passo?

1. 1
   Inventariar o que existe

   Liste número, nome de exibição, portfólio, templates (nome, categoria, idioma, status e qualidade), webhooks e quem tem acesso. Exporte tudo para uma planilha.

2. 2
   Confirmar o modelo da conta

   Pergunte ao provedor atual se a conta já está no novo modelo, com conta do WhatsApp e conta de mensagens separadas.

3. 3
   Garantir que o portfólio é seu

   A empresa precisa ser administradora do portfólio dono do número. Se o número está na conta do provedor, peça a transferência da propriedade ou o compartilhamento antes de qualquer troca.

4. 4
   Compartilhar a conta com o novo provedor

   No novo modelo, o cliente compartilha a conta do WhatsApp com o novo parceiro. Em migração de conta de mensagens, o pedido aparece no Meta Business Suite e precisa ser aceito por um administrador do portfólio.

5. 5
   Conferir templates e recriar os que faltam

   Compare a lista do passo 1 com o que chegou. Recrie e envie para aprovação o que não foi copiado, sem marcar campanha antes da decisão.

6. 6
   Trocar o webhook e testar

   Aponte as respostas e os status para o novo sistema. Faça o teste do checklist de webhook do WhatsApp API.

7. 7
   Enviar um lote pequeno e acompanhar

   Dispare para uma parte da base, olhe entrega, falhas e respostas, e só então volte ao volume normal.

8. 8
   Encerrar o acesso antigo

   Quando tudo estiver estável, remova o acesso do provedor anterior, se essa for a decisão.

O que fazer com a verificação em duas etapas do número?

A verificação em duas etapas usa um PIN de seis dígitos definido no registro do número, e a documentação da Meta informa que não existe endpoint para desativá-la. Se o PIN foi esquecido, ele pode ser trocado no WhatsApp Manager, na aba de verificação em duas etapas. Para os números elegíveis, a Meta está descontinuando o PIN e a aba some do painel. Ter o PIN em mãos, ou saber que o número já não usa PIN, evita uma parada no meio da troca.

DADOS DA CONTA
Portfólio empresarial (nome e ID): ____________
Número: +55 ___ _________  Nome de exibição: ____________
Modelo da conta: novo (conta do WhatsApp + conta de mensagens) / antigo
Administradores da empresa: 1) ________ 2) ________

TEMPLATES (uma linha por template)
Nome | Categoria | Idioma | Status | Qualidade | Vai ser copiado? | Recriar até ___/___

ANTES DA TROCA
[ ] Forma de pagamento pronta na conta de mensagens
[ ] Webhook novo testado com mensagem de teste
[ ] Time de atendimento avisado da data e do horário
[ ] Campanhas agendadas pausadas ou realocadas
[ ] Combinado por escrito com o novo provedor: prazo, custo, suporte, quem responde por falha

DEPOIS DA TROCA
[ ] Lote pequeno enviado e conferido (entregues, falhas, respostas)
[ ] Templates recriados enviados para aprovação
[ ] Acesso do provedor antigo removido (se for o caso)
[ ] Relatório do primeiro dia guardado