← Blog

·

Conta do WhatsApp x conta de mensagens: a nova estrutura da WABA

Atualizado em 28/10/2026

Desde 23 de setembro de 2026, a Meta está dividindo a antiga conta do WhatsApp Business (WABA) em duas: a conta do WhatsApp (WAAC), que guarda o número de telefone e o perfil, e a conta de mensagens, que guarda templates, cobrança e assinaturas de webhook. A migração é automática, os IDs e tokens atuais continuam funcionando e a conta de mensagens herda o ID da WABA. A consequência mais prática: trocar ou somar provedor deixou de exigir migração de número; basta compartilhar a conta do WhatsApp.

Por que a Meta mudou a WABA

A página Atualizações nas contas do WhatsApp Business explica o problema. A WABA juntava número, templates, cobrança, webhooks e acesso de parceiros numa entidade só. Para trabalhar com dois parceiros, a empresa precisava de dois números, e o cliente final via dois contatos diferentes da mesma marca.

O novo modelo separa a identidade da empresa (o número) da operação de mensagens (templates e cobrança). Um mesmo número pode ter várias contas de mensagens, uma por integração, cada uma com seus templates, sua forma de pagamento e suas métricas. O usuário do WhatsApp continua vendo um único contato.

O que fica em cada conta

AtivoAntes (WABA)Depois (novo modelo)
Número de telefoneWABAConta do WhatsApp (WAAC)
Username comercial (futuro)não existiaConta do WhatsApp
Perfil comercial e catálogosWABAConta do WhatsApp
TemplatesWABAConta de mensagens (uma por parceiro)
Cobrança e forma de pagamentoWABAConta de mensagens
Assinaturas de webhookWABAConta de mensagens
Histórico de conversas e qualidadeNúmeroNúmero (sem mudança)
Verificação da empresaPortfólioPortfólio (sem mudança)
Tokens de acessoApp + WABAApp + conta de mensagens (os mesmos tokens)

Alguns detalhes que a tabela não mostra:

  • Cada WAAC tem um único número. Para agrupar números, a Meta usa uma hierarquia com uma WAAC principal e WAACs vinculadas. Compartilhar a principal dá acesso a todos os números do conjunto.
  • A WAAC é sempre do cliente (ou do desenvolvedor direto). A conta de mensagens pode ser do cliente ou do parceiro.
  • Nos Termos de Serviço, a WAAC é chamada de “Conta do WhatsApp Business” e a outra de “Conta de mensagens”. Vale saber para não confundir ao ler contrato.
  • Templates não são compartilhados entre contas de mensagens. Se precisar do mesmo template em duas, crie em cada uma ou use a API de migração de templates. Ao migrar templates, qualidade e nível de mensagens voltam ao padrão, com ajuste de 2 a 4 semanas.
  • Throughput e limite de mensagens continuam onde estavam. O throughput é do número, e o limite de destinatários únicos em 24 horas é do portfólio; quando vários parceiros usam o mesmo número, eles dividem os dois.

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

O que muda (e o que não muda) na API

A lista do que não muda é longa: endpoints da Cloud API, da Business Management API e da Marketing Messages API; POST /<PHONE_NUMBER_ID>/messages; IDs de número; tokens; fluxo de templates; registro de número; verificação da empresa; nome de exibição; qualidade; e a assinatura de webhook do tópico whatsapp_business_account, agora feita com o ID da conta de mensagens (que é o mesmo ID da WABA). O GET/POST/DELETE /<WABA_ID>/message_templates continua igual.

O que muda vem em três fases:

FaseQuandoO que aconteceO que você faz
1. Disponibilidade geralDe 23/09/2026 até meados de outubro de 2026Migração automática; contas de mensagens mantêm o ID da WABA; WAACs criadas, mas sem ID exposto; messaging_account_id opcionalNada, salvo se o seu token alcança mais de uma conta de mensagens no mesmo número
2. Nova versão da Graph API1º semestre de 2027ID da WAAC devolvido junto com o do número; novos endpoints; webhook whatsapp_account; permissões separadas para WAAC e conta de mensagens; messaging_account_id obrigatório na versão nova em cenários com várias contasCapturar waac_id nos eventos e adotar a versão nova se tiver várias contas de mensagens
3. Transição obrigatória1º semestre de 2028APIs que recebem o ID do número no caminho (incluindo /messages e /marketing_messages) passam a exigir o ID da WAACTer migrado o código em 2027

A Meta avisa que toda a página está sujeita a alterações. As datas de 2027 e 2028 são semestres, não dias.

O parâmetro messaging_account_id

Quando o token tem acesso a mais de uma conta de mensagens no mesmo número, a Meta não sabe em qual cobrar. O parâmetro resolve isso:

curl -X POST 'https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>/messages' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5584999999999",
    "messaging_account_id": "<MESSAGING_ACCOUNT_ID>",
    "type": "template",
    "template": { "name": "pedido_enviado", "language": { "code": "pt_BR" } }
  }'

Regras da página de contas de mensagens:

  • se o token alcança uma só conta de mensagens naquele número, a Meta escolhe por você;
  • se alcança duas ou mais e você omite o parâmetro, a mensagem pode ser cobrada na conta errada ou a requisição pode ser rejeitada;
  • paid_messaging_account_id é um alias antigo: migre para messaging_account_id até 31 de dezembro de 2026; se enviar os dois, vale messaging_account_id;
  • para saber se uma conta de mensagens tem forma de pagamento, consulte GET /<MESSAGING_ACCOUNT_ID>?fields=primary_funding_id; sem esse campo, ela não envia mensagens pagas.

Casos típicos em que o parâmetro é necessário: desenvolvedor direto que terceiriza o marketing para um parceiro no mesmo número, parceiro que recebeu duas contas de mensagens de um cliente e cliente que fatura em moedas diferentes (cada moeda exige uma conta de mensagens própria).

IDs nos webhooks

Na fase 1, nada muda no código, mas o waba_id que chega nos eventos passou a significar o ID da conta de mensagens. Na fase 2, os eventos ganham waac_id. Guarde os três (waac_id, ID do número e waba_id) no seu cadastro de instâncias. Se o seu CRM também está se adaptando aos usernames e ao BSUID, vale fazer as duas mudanças de modelo de dados juntas.

Trocar de provedor ficou mais simples

Esse é o impacto mais visível para quem contrata a API. Desde 18 de agosto de 2026 a Meta documenta que a migração de número entre parceiros não é suportada no novo modelo. Em vez disso:

  1. O cliente compartilha a conta do WhatsApp (WAAC) com o novo provedor.
  2. O Cadastro Incorporado cria automaticamente uma conta de mensagens nova para esse provedor, com o ID devolvido no campo da WABA.
  3. O número, as conversas e a qualidade continuam onde estavam; não há interrupção.
  4. O cliente decide se mantém ou remove o provedor anterior, quando quiser.

Dois cuidados. Primeiro, como templates são isolados por conta de mensagens, o novo provedor começa sem os seus templates: recrie ou migre. Segundo, o registro no novo provedor é encaminhado para o número já registrado sem redefinir o PIN, e a Meta está descontinuando o PIN de 6 dígitos da verificação em duas etapas para números elegíveis da Cloud API (mesmo assim, continue enviando um pin válido no /register até a Meta anunciar outra regra). Mais contexto em como trocar de provedor da API do WhatsApp e em registrar o número na Cloud API.

Quando um provedor é removido de uma conta de mensagens, ele recebe o webhook account_update. Para casos com mais de um parceiro no mesmo número, a Meta lançou em 23 de setembro de 2026 o Conversation Routing, que define qual parceiro recebe cada mensagem que chega.

Coexistência e a nova estrutura

Números do app WhatsApp Business em coexistência também migram. Na integração de coexistência, a Meta converte a WABA existente do cliente numa conta de mensagens compatível (mesmo ID) e compartilha a conta do WhatsApp e essa conta de mensagens com o parceiro; não é criada uma conta de mensagens específica do parceiro. O guia de coexistência agora exige assinar account_update. O que sincroniza entre app e API está em coexistência: o que sincroniza.

O que muda no Meta Business Suite

Para empresas já migradas, o Meta Business Suite mostra duas abas: Contas do WhatsApp (números e usernames) e Contas de mensagens (templates e cobrança). Até a migração da sua empresa, o Gerenciador do WhatsApp e o Business Suite seguem com a tela antiga, então a documentação pode estar à frente do que você vê. Se você gerencia várias marcas, isso muda a rotina descrita em API do WhatsApp para agências.

Como fica na Vectalk

A Vectalk é um proxy da API oficial do WhatsApp. A conexão continua pelo Cadastro Incorporado em Instâncias → Conectar conta, que importa phone_number_id, waba_id e o token; com o novo modelo, esse waba_id é o ID da conta de mensagens. Se você está vindo de outro provedor, a regra da Meta no novo modelo vale também aqui: o número não é migrado, a conta do WhatsApp é compartilhada com o novo provedor. O passo a passo está no guia rápido, e o cadastro é feito em apps.vectalk.com.br/register.

Perguntas frequentes

Meu WABA ID mudou?

Não. O ID da WABA passou a ser o ID da conta de mensagens e continua funcionando nas chamadas de templates, webhooks e Business Management API.

Preciso mudar meu código agora?

Só se o seu token tiver acesso a mais de uma conta de mensagens no mesmo número; nesse caso, envie messaging_account_id. Também troque paid_messaging_account_id por messaging_account_id até 31/12/2026. O trabalho maior, usar o ID da WAAC, é para 2027, antes da fase 3 em 2028.

Posso usar dois provedores no mesmo número?

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

Os templates vão junto quando troco de provedor?

Não automaticamente. Templates pertencem à conta de mensagens. Recrie no novo provedor ou use a API de migração de templates, sabendo que qualidade e nível de mensagens do template recomeçam do padrão.

Ainda existe migração de número entre provedores?

Não no novo modelo. A Meta documenta que a requisição é rejeitada se a conta do WhatsApp de destino não for dona do número. O caminho é compartilhar a WAAC.


Fontes oficiais consultadas em 28/10/2026: Atualizações nas contas do WhatsApp Business (atualizada em 22/09/2026), Gerenciamento de contas de mensagens (atualizada em 29/08/2026), Alterações de integração (atualizada em 26/06/2026), Changelog da plataforma do WhatsApp.

Coloque o WhatsApp oficial da sua empresa para funcionar

Crie sua conta, conecte seu número à API oficial (dá para manter o app com coexistência) e comece a atender e enviar mensagens.