Mudanças na API do WhatsApp: Calendário de 2026 a 2028

As mudanças na API do WhatsApp que vêm por aí não chegam todas de uma vez. Elas se espalham por um calendário que vai de 15 de outubro de 2026 até o primeiro semestre de 2028. Cada data tem um efeito concreto: um número que não conecta, uma conta que para de entregar mensagens, uma integração que devolve erro. Este guia organiza tudo por data e diz o que fazer em cada uma.

TL;DR

• 15/10/2026: o Embedded Signup v2 e v3 é descontinuado. Quem conecta números de clientes precisa estar na v4.
• 31/12/2026: o campo paid_messaging_account_id sai de cena e dá lugar a messaging_account_id.
• 2027: as versões v21, v22 e v23 da Graph API expiram, e a Messaging account precisa ser faturada em BRL até 30/06/2027. Sem isso, a Meta para de entregar mensagens em 01/07/2027.
• 2027 e 2028: o novo modelo de contas (WhatsApp account + Messaging account) passa a exigir novos IDs nas chamadas da API.
• Termos de 23/09/2026: IA de uso geral como produto principal é vetada (salvo onde a lei obriga). O bot de atendimento da sua empresa continua liberado.

As mudanças na API do WhatsApp em uma linha do tempo

Antes dos detalhes, o mapa das mudanças na API do WhatsApp até 2028. Montei esta tabela com a documentação oficial da Meta, lida em 05/10/2026.

Data	O que acontece	Quem é afetado
01/10/2026 (já valendo)	Mensagens de serviço passam a ser cobradas acima de 1.000 por número/mês	Toda empresa na API oficial
15/10/2026	Fim do Embedded Signup v2 e v3	Plataformas e parceiros que conectam números
Até meados de out/2026	Fase 1 do novo modelo de contas (migração automática)	Todos, sem ação obrigatória
31/12/2026	Fim do paid_messaging_account_id	Quem integra direto na API
21/01/2027	Expira a Graph API v21.0	Integrações próprias
1º semestre de 2027	Fase 2 do modelo de contas (messaging_account_id obrigatório em alguns casos)	Integrações próprias e parceiros
20/05/2027	Expira a Graph API v22.0	Integrações próprias
30/06/2027	Prazo para todas as Messaging accounts estarem em BRL (em 01/07 a entrega para)	Empresas com país de faturamento Brasil
08/10/2027	Expira a Graph API v23.0	Integrações próprias
31/12/2027	Termina a gratuidade de serviço para governos e ONGs elegíveis	Órgãos públicos e ONGs
1º semestre de 2028	Fase 3: APIs passam a exigir o ID da WhatsApp account	Integrações próprias e parceiros

Repare na coluna da direita: boa parte das mudanças na API do WhatsApp cai no colo de quem mantém a integração. Se você usa uma plataforma, pergunte se o fornecedor tem esse calendário no radar. Se a integração é própria, o trabalho é seu.

15/10/2026: fim do Embedded Signup v2 e v3

O Embedded Signup é o fluxo em que o cliente clica num botão, entra com a conta do Facebook e conecta o número do WhatsApp a uma plataforma. Toda plataforma multiempresa na API oficial usa alguma versão dele.

A Meta publicou na página de versões do Embedded Signup que as versões v2 e v3, incluindo os public previews, serão descontinuadas em 15/10/2026. O caminho é a v4.

O que isso significa na prática

Esta é a primeira das mudanças na API do WhatsApp com prazo curto.

• Se você é cliente final: números já conectados não caem por causa disso. O risco está em conectar um número novo ou reconectar um número depois dessa data numa plataforma que ainda usa v2/v3.
• Se você é agência ou parceiro: é o seu onboarding de clientes que para. Teste o fluxo completo antes do dia 15, do clique até o primeiro template enviado, atualizando front-end e back-end juntos.
• Teste também a coexistência. Desde 15/07/2026, o fluxo "Phone Number First" entra sozinho nesse modo quando o número já está no app WhatsApp Business, o cenário mais comum em pequenas empresas.

O novo modelo de contas: WhatsApp account x Messaging account

Entre todas as mudanças na API do WhatsApp deste calendário, esta é a mais estrutural. A antiga WABA (WhatsApp Business Account) foi dividida em duas contas, conforme a página Account model evolution:

Conta	O que guarda	ID
WhatsApp account (WAAC)	Número, perfil, username e catálogo	ID novo
Messaging account	Templates, faturamento e webhooks	Mesmo ID da antiga WABA

A consequência prática: um mesmo número pode ser compartilhado com vários parceiros, cada um com cobrança própria. Uma empresa pode usar uma plataforma para atendimento e outra para campanhas no mesmo número, e os parceiros dividem o limite de mensagens e o throughput do número.

As três fases

1. Fase 1 (de 23/09/2026 até meados de outubro de 2026): migração automática. IDs, endpoints e tokens continuam funcionando. Ninguém precisa fazer nada.
2. Fase 2 (1º semestre de 2027): uma nova versão da Graph API passa a exigir messaging_account_id quando o token acessa mais de uma Messaging account no mesmo número. Surgem os IDs de WAAC, um tópico de webhook whatsapp_account e permissões separadas.
3. Fase 3 (1º semestre de 2028): todas as APIs que recebem o ID do número de telefone no caminho passam a exigir o ID da WhatsApp account.

Há um prazo intermediário que pouca gente notou: o campo paid_messaging_account_id está depreciado e deve ser trocado por messaging_account_id até 31/12/2026.

O fim da migração de número entre parceiros

Aqui está a mudança de negócio escondida na técnica. No modelo novo, a migração de número entre BSPs deixa de existir. Para trocar de parceiro, o cliente compartilha a WhatsApp account com o novo fornecedor. A própria Meta alerta que isso reduz o custo de troca.

Para quem contrata, fica mais fácil sair de um fornecedor ruim. Para quem vende, o cliente fica porque quer, não porque sair dá trabalho.

Versões da Graph API que expiram entre 2027 e 2028

Entre as mudanças na API do WhatsApp que exigem código, a expiração de versões é a mais previsível e a mais ignorada. A Cloud API do WhatsApp roda sobre a Graph API da Meta, que é versionada. Quando uma versão expira, as chamadas que ainda apontam para ela deixam de funcionar como esperado. O changelog da Graph API traz as datas:

Versão	Lançada em	Disponível até
v26.0 (atual)	29/07/2026	a definir
v25.0	18/02/2026	29/07/2028
v24.0	08/10/2025	18/02/2028
v23.0	29/05/2025	08/10/2027
v22.0	21/01/2025	20/05/2027
v21.0	02/10/2024	21/01/2027
v20.0	21/05/2024	expirou em 24/09/2026

Como fazer a atualização sem susto

• Procure a versão no código inteiro, não só na configuração. É comum o envio de mensagens estar numa versão e um módulo secundário (Conversions API, consulta de anúncios, onboarding) estar fixado em outra, mais antiga.
• Pule direto para v25 ou v26. Subir de v21 para v22 só empurra o problema para maio de 2027.
• Leia o changelog das versões intermediárias. Desde a v24, o objeto conversation sai do webhook de status (exceto em janela grátis de anúncio). Código que lê esse objeto quebra calado.
• Não deixe para a semana do prazo. Toda atualização revela algum campo renomeado.

Quem trabalha com Moodle conhece esse filme: plugin fixado numa versão antiga funciona até o dia em que não funciona mais, e esse dia costuma ser uma segunda-feira de matrícula. Com a API do WhatsApp é igual, só que quem para é o atendimento.

Faturamento em BRL obrigatório até 30/06/2027

Das mudanças na API do WhatsApp com impacto financeiro, esta é a que pode parar o atendimento. Desde julho de 2026, empresas com país de faturamento Brasil no Billing Hub podem criar Messaging accounts cobradas em reais, faturadas pela Facebook Brasil. O que era opção virou prazo:

• Até 30/06/2027: todas as Messaging accounts do portfólio precisam estar em BRL.
• A partir de 01/07/2027: a Meta não entrega mais mensagens de contas não-BRL desses clientes.

O detalhe que complica

A moeda não pode ser trocada numa conta existente. A saída é a Currency Migration API, disponível desde 01/06/2026, que clona a conta numa nova com outra moeda. Isso é uma operação técnica, não um botão nas configurações.

Quando fazer (e quando não fazer)

• Faça com antecedência, num mês de movimento baixo.
• Não faça na véspera de campanha ou data sazonal: ajuste de pagamento em pico vira atendimento parado.
• Confira a forma de pagamento. Desde 01/10/2026, uma Messaging account sem pagamento ativo só entrega as 1.000 mensagens de serviço gratuitas do mês por número. Depois, a entrega para.

Para entender o que essas tarifas e as demais mudanças na API do WhatsApp representam no mês, vale ler o nosso guia de custo por conversa na API oficial do WhatsApp, e somar a regra nova: desde 01/10/2026 as mensagens de serviço acima da franquia custam R$ 0,035 cada no Brasil, conforme a página de preços da Meta.

Termos e política atualizados em 23/09/2026

Nem todas as mudanças na API do WhatsApp são técnicas. No mesmo dia em que começou a Fase 1 do novo modelo de contas, a Meta atualizou dois documentos que valem para toda empresa na plataforma.

Termos da Meta para a Plataforma do WhatsApp Business

Os termos mudaram de nome e o link antigo redireciona para a nova página. O ponto que mais importa é a cláusula 4.7, sobre provedores de IA:

• Quem oferece LLM, IA generativa ou assistente de IA de uso geral não pode usar a plataforma quando a IA é a funcionalidade principal, salvo onde a lei obriga a Meta a permitir.
• IA incidental ou auxiliar, como o bot de atendimento de uma loja, continua permitida.

No Brasil, a Meta trata o país como mercado onde provedores de IA são permitidos, cobrando R$ 0,3217 por mensagem desses provedores, segundo a página de AI Providers. Se a sua empresa usa IA para atender os próprios clientes, nada disso muda o seu caso. Explico os limites com mais calma no post sobre automatizar o atendimento no WhatsApp com IA sem ser banido.

Business Messaging Policy

A política de mensagens agora diz que a empresa só pode contatar quem forneceu o número ou o username e deu consentimento. Ela mantém a exigência de que toda automação tenha um caminho claro para um humano. Bot sem saída para atendente é risco de política, não só de experiência.

O que a Meta ainda não confirmou

Um calendário honesto das mudanças na API do WhatsApp também lista o que não tem data. Até 05/10/2026, estes pontos seguem em aberto na documentação oficial:

• Usernames para usuários finais. As empresas já podem reservar username desde 29/06/2026, mas a Meta só diz que o recurso abre para o público "gradualmente em 2026". Quando abrir, o telefone pode deixar de vir no webhook em alguns casos.
• Tarifas para 01/01/2027. A Meta só altera preço no primeiro dia de cada trimestre e avisa com pelo menos 1 mês de antecedência. Nenhuma mudança de tarifa para janeiro foi publicada até agora. Ainda pode ser anunciada até o começo de dezembro.
• Datas exatas das Fases 2 e 3 do modelo de contas. Por enquanto, só o semestre.

A regra prática: não reescreva sistema por causa de boato sobre mudanças na API do WhatsApp que a Meta ainda não publicou. Prepare a arquitetura (aceitar um ID de usuário alternativo, ler o tipo de cobrança do webhook) e acompanhe o changelog oficial.

Checklist das mudanças na API do WhatsApp por data

Este é o resumo prático das mudanças na API do WhatsApp em formato de tarefa. Marque conforme avançar.

Até 15/10/2026

• Confirmar com a plataforma (ou com o seu time) que o Embedded Signup está na v4.
• Testar a conexão de um número novo, inclusive em modo de coexistência.
• Conferir se toda Messaging account tem forma de pagamento ativa.

Até 31/12/2026

• Trocar paid_messaging_account_id por messaging_account_id.
• Sair da Graph API v21.0 (expira em 21/01/2027) e mirar v25 ou v26.

1º semestre de 2027

• Preparar o código para enviar messaging_account_id quando o token acessa mais de uma conta no mesmo número.
• Assinar o novo webhook whatsapp_account quando ele estiver disponível.
• Sair da v22.0 antes de 20/05/2027.

Até 30/06/2027

• Migrar todas as Messaging accounts para BRL com a Currency Migration API.
• Validar a primeira cobrança em reais.

Até 08/10/2027 e 2028

• Sair da v23.0.
• Planejar a troca do ID do número pelo ID da WhatsApp account nas chamadas (Fase 3).

Sempre

• Revisar a classificação dos templates: marketing classificado como utility pode gerar restrição no portfólio inteiro.

Como a Agathas Web resolve isso

Na Agathas Web, operamos a Voyia, nossa plataforma de atendimento e vendas na API oficial do WhatsApp, integrada direto à Cloud API da Meta. Numa plataforma, quem acompanha as mudanças na API do WhatsApp no código (versão da Graph API, onboarding de número, webhooks) é o fornecedor. A sua equipe continua na caixa de entrada.

O que está incluso na Voyia hoje:

• Inbox multi-atendente com transferência e filas (a partir do Profissional).
• Disparos em massa com templates aprovados pela Meta, segmentação por tags e agendamento.
• Chatbot no-code e integração com IA usando a sua própria chave (Claude, GPT, Gemini, DeepSeek), com transferência para humano. É IA auxiliar de atendimento, o uso que os termos de 23/09/2026 permitem.
• Relatórios de entrega, leitura e tempo de resposta, e app iOS e Android.
• Zero markup nas mensagens da Meta: as tarifas oficiais são repassadas sem margem.
• Mensalidade em reais com NF-e, sem fidelidade. Os planos começam em R$ 149/mês (Starter), R$ 349/mês (Profissional) e R$ 749/mês (Business), cada um com 1 número. Starter e Profissional têm taxa de instalação, que a equipe de vendas informa antes da contratação.
• Segurança: tokens da Meta criptografados, servidores no Brasil e operação compatível com a LGPD.

Como se contrata: você escolhe o plano, nós conectamos o seu número à API oficial e você configura equipes, templates e fluxos com a documentação e os vídeos da plataforma. Suporte em português, em horário comercial. Se o seu número já está em outra plataforma, ajudamos na mudança. No momento da contratação, confira com a gente em que moeda está a Messaging account do seu número, para não chegar em junho de 2027 com pendência.

Se você ainda está decidindo entre ter uma integração própria ou usar uma plataforma, o guia completo da WhatsApp Cloud API mostra o que cada caminho exige. E se quiser ver os planos lado a lado, eles estão na página da Voyia.

Conclusão: cada data tem um dono

As mudanças na API do WhatsApp entre outubro de 2026 e 2028 não são um evento único. São uma fila de prazos, cada um com um responsável. O essencial: o número precisa conectar (Embedded Signup v4), a conta precisa estar em reais até 30/06/2027 e a integração precisa acompanhar a Graph API e o novo modelo de contas.

Se a integração é própria, acompanhe as mudanças na API do WhatsApp com o checklist acima e marque as datas na agenda hoje. Se prefere que esse calendário fique com quem mantém a plataforma, fale com a equipe da Voyia e coloque a sua operação na API oficial, com mensalidade em reais e tarifas da Meta sem markup.