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

Atualizado em 25/10/2026

Desde o novo modelo de contas da Meta, trocar de provedor da API do WhatsApp não exige mais migrar o número. Você compartilha a sua conta do WhatsApp, que guarda o número, com o novo provedor; ele ganha uma conta de mensagens própria para templates e cobrança, e o número segue funcionando sem interrupção. O provedor antigo pode continuar ou ser removido depois, quando você quiser. O que exige cuidado são os templates, que não vão junto automaticamente, a forma de pagamento e as integrações que apontam para o provedor antigo.

Este guia explica o que mudou, o passo a passo da troca, o que acontece com templates, cobrança e limites, e os cuidados para não ficar sem envio no meio do caminho.

O que mudou: a WABA virou duas contas

Até 2026, a conta do WhatsApp Business (WABA) reunia tudo: números, templates, cobrança, webhooks e acesso de parceiros. Trocar de provedor significava migrar o número de uma WABA para outra.

A página Updates to WhatsApp Business accounts descreve o novo modelo, que começou a ser liberado em 23/09/2026 com previsão de chegar a todas as empresas até meados de outubro de 2026. A WABA foi dividida em duas:

• Conta do WhatsApp (WAAC): guarda o número de telefone, o perfil comercial e o catálogo. É sempre da empresa e pode ser compartilhada com vários parceiros.
• Conta de mensagens (Messaging account): guarda templates, forma de pagamento e assinaturas de webhook. Cada parceiro tem a sua. O ID antigo da WABA passou a ser o ID da conta de mensagens.

Item	Antes (WABA)	Depois (novo modelo)
Número de telefone	Na WABA	Na conta do WhatsApp
Templates	Na WABA	Na conta de mensagens de cada parceiro
Cobrança e forma de pagamento	Na WABA	Na conta de mensagens
Histórico de conversas	No número	No número (sem mudança)
Classificação de qualidade	No número	No número (sem mudança)
Verificação da empresa	No portfólio	No portfólio (sem mudança)
Webhooks	Na WABA	Na conta de mensagens

A consequência prática está escrita na própria documentação: migrar um número de um parceiro para outro não é suportado no novo modelo, porque não é mais necessário. A empresa compartilha a conta do WhatsApp com o novo parceiro, o número não sai do lugar e as conversas não são interrompidas.

Para entender quem é quem entre os intermediários, veja o que é BSP e Tech Provider.

Passo a passo para trocar de provedor

1. Faça um inventário do provedor atual. Liste os templates aprovados (nome, idioma, categoria, texto e botões), as URLs de webhook, os sistemas que usam o token atual e a forma de pagamento.
2. Conecte o novo provedor. Pelo Cadastro Incorporado (Embedded Signup) do novo provedor, você entra com o número que já usa. Segundo a página de mudanças no cadastro, clientes que já estão com um parceiro podem se cadastrar com outro usando o número existente, e o fluxo cria automaticamente uma conta de mensagens para o novo parceiro.
3. Recrie ou copie os templates. Templates pertencem à conta de mensagens em que foram criados. Recrie no novo provedor ou use a API de migração de templates (detalhes abaixo).
4. Configure a cobrança. Cada conta de mensagens tem sua própria forma de pagamento. Sem pagamento ativo, os envios cobrados param.
5. Aponte suas integrações para o novo provedor. Troque URL base, token e webhooks no seu sistema. Se o código segue o formato da Cloud API, a mudança costuma ser só de configuração.
6. Teste antes de virar a chave. Envie templates de teste, confira os status no webhook e verifique se as mensagens recebidas chegam no lugar certo.
7. Decida o que fazer com o provedor antigo. Para encerrar, a empresa remove o compartilhamento no Meta Business Suite: primeiro a conta de mensagens, depois a conta do WhatsApp ligada ao número, conforme o guia Migrating customers off a Multi-Partner Solution.

Manter os dois por um tempo é permitido: o compartilhamento é aditivo, e a Meta diz que remover o parceiro anterior não é pré-requisito para entrar com o novo.

Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →

O que acontece com os templates

Templates não são compartilhados entre contas de mensagens. Você tem duas saídas: recriar e mandar para aprovação, ou usar a API de migração de templates, que recria os modelos na conta de destino:

curl -X POST "https://graph.facebook.com/v26.0/<DESTINATION_WABA_ID>/migrate_message_templates" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "source_waba_id": "<SOURCE_WABA_ID>",
    "page_number": 0
  }'

A resposta lista o que foi copiado e o que falhou, com o motivo:

{
  "migrated_templates": ["1473688840035974", "6162904357082268"],
  "failed_templates": {
    "1019496902803242": "Incorrect category",
    "259672276895259": "Formatting error - dangling parameter"
  }
}

Limitações documentadas:

• só funciona entre contas de mensagens do mesmo portfólio empresarial;
• só migram templates com status APPROVED e qualidade GREEN ou UNKNOWN;
• até 500 templates por página de migração.

Na prática, isso significa que a API serve quando as duas contas de mensagens pertencem à sua empresa. Se a conta do provedor antigo era dele, conte com recriar os templates. Os motivos mais comuns de reprovação estão em template reprovado no WhatsApp, e a escolha de categoria em marketing, utilidade ou autenticação.

Um alerta importante da Meta: templates migrados para uma nova conta de mensagens começam com a qualidade zerada e precisam de um período de aquecimento estimado em 2 a 4 semanas. Evite trocar de provedor na véspera de uma campanha grande.

Cobrança, limites e throughput durante a transição

Tema	Como fica no novo modelo
Cobrança	Cada parceiro é cobrado pela própria conta de mensagens. A mensagem é cobrada na conta ligada ao app que enviou.
Recibos de entrega	Voltam para o app que enviou a mensagem
Limite de mensagens	Continua no portfólio empresarial e é dividido entre todos os parceiros do número
Throughput	Continua no número e é dividido entre os parceiros
Qualidade e nome de exibição	Sem mudança; ficam no número
Verificação da empresa	Sem mudança; fica no portfólio

Se o seu token tiver acesso a mais de uma conta de mensagens no mesmo número, a Meta orienta enviar o parâmetro messaging_account_id nas chamadas de envio, para que a cobrança vá para a conta certa. Hoje ele é opcional; passa a ser obrigatório nesses cenários na próxima versão da Graph API, prevista para o primeiro semestre de 2027.

Cuidados para não ficar sem envio

• Não exclua o número do app nem cancele o registro. Isso não é necessário para trocar de provedor no novo modelo e pode derrubar o atendimento.
• Remova o acesso do provedor antigo quando terminar. A documentação da Meta diz que, no momento, qualquer parceiro com acesso pode cancelar o registro do número. Não deixe acessos sobrando.
• Linha de crédito antiga. A Meta avisa que, se a empresa ainda compartilha a linha de crédito de um parceiro anterior, pode ver um erro ao tentar trocar de parceiro, e indica o guia de suporte para clientes.
• Coexistência. Números que usam o app WhatsApp Business junto com a API também passaram para o novo modelo. Veja coexistência no WhatsApp.
• Exporte seus dados. O histórico do lado do WhatsApp continua no número, mas os dados que o provedor antigo guardou (contatos, etiquetas, relatórios) ficam com ele. Exporte antes de encerrar.
• Token e webhooks. Cada provedor tem as próprias credenciais e URLs. Planeje a troca no seu sistema; veja token permanente com usuário do sistema se você integra direto com a Meta.

E se a minha conta ainda está no modelo antigo?

A Meta migra as empresas em etapas. Enquanto uma empresa não passa para o novo modelo, o WhatsApp Manager e o Meta Business Suite continuam mostrando a visão antiga de WABA única. Se é o seu caso, confirme com o novo provedor o procedimento vigente antes de mexer no número. As páginas antigas de migração de número entre parceiros hoje avisam que o procedimento descrito vale só para o modelo anterior.

Trocar para a Vectalk

A Vectalk é um proxy da Cloud API oficial da Meta: o cliente paga a Vectalk e a Vectalk paga a Meta. Para conectar um número que você já usa:

1. Crie sua conta em apps.vectalk.com.br/register.
2. Em Instâncias, clique em Conectar conta e conclua o Cadastro Incorporado da Meta com o seu número. A Vectalk importa phone_number_id, waba_id e o token.
3. Recrie seus templates com POST /api/templates e confira com GET /api/templates.
4. Registre seus webhooks com POST /api/webhooks.
5. Troque no seu sistema a URL base para https://apis.vectalk.com.br/api e o token. Os payloads são os mesmos da Meta.

O passo a passo está no guia rápido. Se preferir planejar a troca com o time, use a página de contato. Para critérios gerais de escolha, veja como escolher um provedor de API do WhatsApp e o guia da API oficial do WhatsApp.

Perguntas frequentes

Vou perder o número ou as conversas ao trocar de provedor?

Não, no novo modelo. O número fica na sua conta do WhatsApp, que você compartilha com o novo parceiro. A Meta afirma que as conversas existentes não são interrompidas quando um novo parceiro é adicionado.

Preciso verificar a empresa de novo?

Não. A verificação fica no portfólio empresarial e não muda com a troca de provedor. Veja verificação da empresa na Meta.

O nome de exibição e o selo verde mudam?

A Meta lista nome de exibição e classificação de qualidade entre os itens que não mudam no novo modelo; eles ficam no número. Se você tem ou quer o selo verde, confirme o status no WhatsApp Manager depois da troca.

Posso usar dois provedores ao mesmo tempo no mesmo número?

Sim. O novo modelo foi feito para isso: cada parceiro tem a sua conta de mensagens, com templates e cobrança separados. Eles dividem o limite de mensagens do portfólio e o throughput do número.

Meus templates aprovados vão junto?

Não automaticamente. Recrie no novo provedor ou use a API de migração, que só funciona entre contas de mensagens do mesmo portfólio e só para templates aprovados com qualidade verde ou desconhecida.

---

Fontes oficiais consultadas em 25/10/2026: Updates to WhatsApp Business accounts (changelog atualizado em 22/09/2026), Onboarding changes, Managing messaging accounts, Template migration, Migrate numbers among partners via Embedded Signup, Migrating customers off a Multi-Partner Solution, Onboard WhatsApp Business app users.