API de Mensagens de Marketing do WhatsApp (MM Lite): guia 2026
API de Mensagens de Marketing do WhatsApp explicada: o que é, diferenças para os modelos de marketing da Cloud API, datas do fim em 2027, elegibilidade e métricas.
Por OmniChannels.ai Editorial Team · Revisado por BroadNet Messaging Solutions Team
Resposta curta
A API de Mensagens de Marketing do WhatsApp é a API da Meta, só para envio, dedicada a modelos de marketing e sucessora do envio de mensagens de marketing pela Cloud API. Ela acrescenta entrega baseada em qualidade, validade da mensagem (TTL), benchmarks e métricas de conversão. A Meta afirma que a Cloud API deixa de aceitar mensagens de marketing em 13 de outubro de 2027, então quem envia promoções precisa usar o novo endpoint. Mensagens de utilidade, autenticação e serviço continuam na Cloud API.
Nesta página
- O que é a API de Mensagens de Marketing do WhatsApp?
- Quais são as datas principais da mudança?
- Como ela difere dos modelos de marketing na Cloud API?
- Ela muda o custo do marketing no WhatsApp?
- Quem pode usar e onde os recursos são limitados?
- Como enviar uma mensagem de marketing com a nova API?
- Por que a reclassificação de modelos importa agora?
- Como medir se funciona?
- Quem deve migrar primeiro?
- Quais erros evitar?
- Como a OmniChannels.ai ajuda
Pontos principais
- A API de Mensagens de Marketing do WhatsApp (muitas vezes chamada de MM Lite) é um endpoint de envio separado para modelos da categoria MARKETING; todo o resto, inclusive as mensagens recebidas, continua na Cloud API.
- A documentação da Meta traz as datas: disponibilidade geral em 19 de novembro de 2025, contas criadas a partir de 13 de abril de 2027 não podem enviar marketing pela Cloud API, e o envio de marketing pela Cloud API termina em 13 de outubro de 2027.
- Entrega baseada em qualidade, validade personalizável da mensagem de 12 horas a 30 dias, benchmarks, recomendações e métricas de conversão são recursos da nova API; formatos básicos de marketing, como mídia, carrossel e modelos com Flow, funcionam nas duas.
- A Meta diz que o modelo de cobrança é o mesmo da Cloud API; a empresa pode definir, se quiser, um preço máximo por mensagem de marketing entregue, e a Meta cobra esse valor ou menos.
- Alguns recursos não estão ativos em todos os lugares. A Meta lista o Espaço Econômico Europeu, o Reino Unido, o Japão, a Coreia do Sul, a Nigéria, a África do Sul e a Tailândia como regiões sem otimizações de entrega, e mensagens de marketing para números dos EUA não são entregues.
Este guia é para líderes de marketing, responsáveis por CRM e desenvolvedores que enviam promoções pelo WhatsApp e ouviram dizer que a Meta está levando as mensagens de marketing para uma nova API. Ele explica o que é a API de Mensagens de Marketing, quais datas importam, como ela difere do envio de modelos de marketing pela Cloud API e o que fazer agora. Segue a documentação para desenvolvedores da Meta em 6 de novembro de 2026; confirme os detalhes lá antes de fechar um plano.
O que é a API de Mensagens de Marketing do WhatsApp?
A API de Mensagens de Marketing do WhatsApp é a API da Meta, somente para envio, voltada a mensagens de modelo de marketing. A Meta a descreve como sucessora das mensagens de marketing na Cloud API, com otimizações pensadas para alcançar as pessoas com maior chance de achar a mensagem relevante.
Ela costuma ser chamada de MM Lite, nome usado por parceiros e em artigos anteriores. Três pontos a definem:
- É um endpoint separado. Os modelos de marketing vão para
/<PHONE_NUMBER_ID>/marketing_messagesem vez de/<PHONE_NUMBER_ID>/messages. - É só para modelos de MARKETING. A Meta diz que as outras categorias vão para o endpoint de mensagens de sempre.
- Funciona ao lado da Cloud API. Você continua usando a Cloud API para receber mensagens dos clientes e webhooks, e para enviar mensagens de serviço, utilidade e autenticação.
Se você está começando a entender as peças, comece por como enviar mensagens de marketing no WhatsApp e pelo nosso guia sobre categorias de modelos do WhatsApp.
Quais são as datas principais da mudança?
A página de visão geral da Meta traz quatro datas: disponibilidade geral em 19 de novembro de 2025, anúncio global em 13 de outubro de 2026, limite para contas novas em 13 de abril de 2027 e fim do marketing na Cloud API em 13 de outubro de 2027.
| Data | O que a Meta diz que acontece |
|---|---|
| 19 de novembro de 2025 | A API de Mensagens de Marketing do WhatsApp passa a ter disponibilidade geral após um beta aberto |
| 13 de outubro de 2026 | Anúncio global de que a Cloud API deixará de aceitar mensagens de marketing |
| 13 de abril de 2027 | Novas contas de mensagens criadas a partir dessa data não podem enviar mensagens de marketing pela Cloud API; as contas anteriores mantêm o acesso até o fim |
| 13 de outubro de 2027 | O envio de uma mensagem de marketing pela Cloud API retorna erro; serviço, autenticação e utilidade não são afetados |
A Meta também observa que a maioria das integrações leva cerca de duas semanas para migrar para o novo endpoint. Considere isso uma estimativa para uma integração simples; reserve mais tempo se houver vários sistemas, etapas de aprovação ou um provedor entre você e a Meta.
Como ela difere dos modelos de marketing na Cloud API?
Os modelos e os números de telefone são os mesmos, mas a nova API acrescenta recursos de entrega e de medição que as mensagens de marketing da Cloud API não têm. A Meta afirma que números e modelos de marketing existentes podem ser reaproveitados.
A tabela de recursos da Meta compara as duas. Estas linhas são as que mudam o dia a dia do marketing:
| Recurso | API de Mensagens de Marketing | Cloud API (marketing) |
|---|---|---|
| Entrega baseada em qualidade | Considera o engajamento com a mensagem nas decisões de entrega | Não; os limites de marketing por usuário não consideram a qualidade da mensagem |
| Validade da mensagem (TTL) | De 12 horas a 30 dias; depois disso, as mensagens não entregues expiram | Limitada a autenticação e utilidade |
| Otimizações de criativo | Piloto: ajustes automáticos de imagem e texto | Não |
| Cabeçalho com GIF animado | Sim | Não |
| Deep links para apps Android | Sim | Não |
| Benchmarks e recomendações | Sim | Não |
| Métricas de conversão | Eventos do app, como adicionar ao carrinho, início de checkout e compra, via SDK da Meta ou API de Eventos do App | Não |
| Formatos básicos (mídia, carrossel, catálogo, Flow, lista, resposta) | Sim | Sim |
| Métricas básicas e de custo (enviadas, entregues, lidas, cliques, erros, gasto) | Sim | Sim |
A Meta cita um único número de desempenho para a entrega baseada em qualidade: até 9% mais mensagens entregues. A própria nota de rodapé da Meta diz que o número veio de um teste A/B com cerca de 12 milhões de mensagens de marketing entregues, enviadas por anunciantes na Índia em janeiro de 2025. Não espere esse número em todos os mercados nem para todas as listas.
Ela muda o custo do marketing no WhatsApp?
A Meta diz que a API de Mensagens de Marketing usa o mesmo modelo de cobrança da Cloud API: você paga por mensagem entregue, e a tarifa depende da categoria e do mercado do destinatário. A página de preços da Meta acrescenta um controle opcional para a nova API.
- Preço máximo. A partir de 2026, a empresa pode definir um preço máximo para cada entrega de mensagem de marketing na API de Mensagens de Marketing. A Meta cobra esse máximo ou menos. Isso não vale para a Cloud API, cujas mensagens de marketing são cobradas pela tarifa publicada.
- Sem faixas de volume em marketing. A Meta aplica faixas de volume apenas a utilidade e autenticação.
- Janela de ponto de entrada gratuito. Mensagens de marketing enviadas dentro de uma janela de ponto de entrada gratuito, aberta quando um usuário responde a um anúncio Click to WhatsApp, não são cobradas.
Não publicamos tarifas em artigos. Use a tabela de preços atual da Meta, nossos preços do WhatsApp por país e a calculadora de preços do WhatsApp. Nossas condições para o WhatsApp são: cobrança pela tarifa da Meta, sem margem adicional. Para uma visão mais ampla de custos, leia preços da API do WhatsApp Business em 2026.
Quem pode usar e onde os recursos são limitados?
A página de primeiros passos da Meta exige uma conta de mensagens ativa em um país elegível, um modelo de marketing aprovado e a assinatura do webhook de mensagens. Algumas otimizações ficam desativadas em várias regiões.
| Região | O que a Meta documenta |
|---|---|
| Espaço Econômico Europeu, Reino Unido, Japão, Coreia do Sul, Nigéria, África do Sul, Tailândia | Sem otimizações de entrega, limites de modelo por usuário inativos e métricas de cliques e conversão indisponíveis |
| Estados Unidos | A Meta não entrega mensagens de marketing a números de WhatsApp dos EUA desde 1º de abril de 2025 (erro 131049); isso vale para todas as APIs de Business Messaging |
| Cuba, Irã, Coreia do Norte, Síria, Venezuela e partes da Ucrânia | As empresas não podem fazer o onboarding e as mensagens não podem ser enviadas a essas regiões |
| Rússia e Belarus | Permitido com exceções; otimizações de entrega e métricas de cliques e conversão não se aplicam |
Na prática, o principal motivo para adotar cedo, a entrega baseada em qualidade, depende de onde estão os seus destinatários. Se a maior parte do seu público está no Golfo, confira a tabela geográfica atual da Meta antes de planejar em torno de um ganho de entrega. A Meta pode alterar a lista.
Como enviar uma mensagem de marketing com a nova API?
Você envia o mesmo modelo para outro endpoint e direciona cada modelo pela sua categoria mais recente. O corpo da requisição segue a estrutura de modelo conhecida.
Os passos da documentação da Meta são:
- No App Dashboard, abra WhatsApp, depois Quickstart, localize o módulo para melhorar o ROI com mensagens de marketing e aceite os termos de serviço.
- Envie um modelo de marketing de teste para o seu próprio número com uma requisição POST ao endpoint
marketing_messagesdo ID do seu número de telefone. - Mantenha em cache um mapeamento com o ID, o nome, o idioma e a categoria mais recente de cada modelo, e envie os modelos
MARKETINGparamarketing_messagese todos os demais paramessages. - Assine o webhook de atualização de categoria de modelo e atualize o mapeamento quando chegar uma notificação de conclusão. Não aja com base em uma notificação de mudança iminente.
- Depois do onboarding, defina
disable_marketing_messages_on_cloud_apicomotrue. A Cloud API passa a rejeitar modelos de marketing com o erro131063, e você atualiza a categoria e tenta novamente pelo endpoint de marketing. - Torne as novas tentativas idempotentes e repita apenas depois de uma falha confirmada.
Os webhooks de status das mensagens enviadas assim trazem marketing_lite no campo pricing.category, e seus relatórios podem separá-las. Use o guia de webhooks do WhatsApp para tratar os eventos e os exemplos de modelos do WhatsApp para a redação dos modelos.
Por que a reclassificação de modelos importa agora?
A Meta pode mudar a categoria de um modelo depois da aprovação, e um modelo de utilidade com conteúdo promocional pode virar marketing. Depois do fim da Cloud API para marketing, esse modelo só poderá ser enviado pelo endpoint de marketing.
A documentação de categorização da Meta diz que modelos de utilidade devem ser não promocionais e ligados a uma ação do usuário ou a uma atualização essencial. Mensagens de pedido e de conta não podem promover, fazer upsell nem cross-sell. Um modelo "seu pedido foi enviado" com um código de desconto no final é o caso clássico. Revise agora a sua biblioteca de utilidade, remova as linhas promocionais e faça o seu código de roteamento ler a categoria atual em vez de presumir uma.
Como medir se funciona?
Faça uma comparação controlada em vez de confiar em um ganho divulgado. Meça com o mesmo público, o mesmo modelo e a mesma janela de tempo.
- Divida. Mantenha um grupo comparável na Cloud API enquanto a rota antiga ainda funciona, ou compare campanhas equivalentes antes e depois da troca.
- Compare a taxa de entrega, não a de aceitação. Divida as mensagens entregues pelas mensagens enviadas para a API.
- Compare as taxas de leitura e de cliques usando os webhooks de status da Meta e as métricas de cliques, quando disponíveis na sua região.
- Calcule o custo por mensagem entregue e o custo por conversão. Use a cobrança da entrega, não o número de envios.
- Use os seus próprios dados de conversão. Se você não consegue enviar eventos do app, marque os links com parâmetros de campanha e conte os resultados no seu CRM.
- Acompanhe a frequência. A entrega baseada em qualidade não elimina a necessidade de opt-in e relevância; um aumento de bloqueios prejudica a qualidade da conta, seja qual for o endpoint.
Exemplo com números sintéticos: uma rede de eletrônicos de Riade envia 100.000 modelos de marketing e a Meta entrega 90.000 pela rota antiga. Outros 100.000 enviados pelo novo endpoint entregam 92.000. A taxa de entrega subiu de 90% para 92%, ou seja, 2.000 mensagens a mais chegaram aos clientes. Se isso vale alguma coisa depende das taxas de cliques e de compra desses destinatários extras, então compare o custo por compra, não apenas a entrega.
Quem deve migrar primeiro?
Todos que enviam modelos de marketing terão de migrar até a data final da Meta, mas a urgência varia.
| Situação | Prioridade sugerida |
|---|---|
| Nova conta de WhatsApp planejada para 2027 | Construir na API de Mensagens de Marketing desde o primeiro dia, já que contas criadas a partir de 13 de abril de 2027 não podem usar a Cloud API para marketing |
| Grande volume promocional em mercados com otimizações ativas | Fazer um piloto cedo e medir |
| Tráfego principalmente de utilidade e autenticação | Urgência baixa, mas auditar o risco de reclassificação |
| Uso intenso de anúncios Click to WhatsApp | Verificar como as janelas de ponto de entrada gratuito e a cobrança aparecem nos seus relatórios |
| Uso de um provedor ou CRM | Perguntar ao provedor a data de migração e o que ele suporta |
Quais erros evitar?
- Presumir um único endpoint para tudo. Direcione por categoria e mantenha-a atualizada.
- Tratar o número de 9% como promessa. É o resultado de um teste regional.
- Esquecer os mercados sem suporte. Números dos EUA não recebem mensagens de marketing, e as otimizações ficam desativadas em várias regiões.
- Deixar texto promocional em modelos de utilidade. A reclassificação os empurra para o endpoint de marketing e para os preços de marketing.
- Ignorar frequência e consentimento. A otimização de entrega não substitui a permissão.
- Esperar o último mês. Planeje testes, aprovações e mudanças de relatórios bem antes de outubro de 2027.
Como a OmniChannels.ai ajuda
A BroadNet é Provedora de Soluções de Negócios oficial da Meta, e a OmniChannels.ai envia modelos de marketing do WhatsApp com mídia, variáveis e botões por meio de campanhas, com relatórios de entrega e exportação em CSV. O WhatsApp é cobrado pela tarifa da Meta, sem margem adicional. Neste artigo, não afirmamos suporte à API de Mensagens de Marketing: fale com a nossa equipe sobre a sua conta e o seu cronograma, e podemos revisar com você as categorias dos seus modelos. Agende uma demonstração para conversar.
Perguntas frequentes
O que é a API de Mensagens de Marketing do WhatsApp?
É a API da Meta para enviar mensagens de modelo de marketing no WhatsApp com otimizações extras. Você envia modelos de marketing aprovados para um endpoint dedicado, o marketing_messages, em vez do endpoint padrão de mensagens. A Meta a descreve como sucessora das mensagens de marketing na Cloud API e diz que ela usa o mesmo modelo de cobrança.
O que é o MM Lite?
MM Lite é a abreviação de Marketing Messages Lite, nome usado na documentação de parceiros e em artigos anteriores para essa API. A documentação atual da Meta chama o produto de API de Mensagens de Marketing do WhatsApp, e os webhooks de status identificam essas mensagens como marketing_lite, ou seja, os dois nomes se referem ao mesmo produto.
Quando a Cloud API deixa de aceitar mensagens de marketing?
A página de visão geral da Meta diz que a Cloud API deixa de aceitar mensagens de marketing em 13 de outubro de 2027, quando o envio de uma mensagem de marketing por ela passa a retornar erro. Contas criadas a partir de 13 de abril de 2027 não podem enviar marketing pela Cloud API de forma alguma. Consulte a página da Meta, porque datas e exceções podem mudar.
Preciso mudar a forma de enviar modelos de utilidade ou de autenticação?
Não. A Meta afirma que mensagens de serviço, autenticação e utilidade continuam na Cloud API. A mudança afeta os modelos da categoria MARKETING. A única armadilha é a reclassificação: se a Meta recategorizar um modelo de utilidade como marketing, ele passa a ser enviado pelo endpoint de marketing.
A API de Mensagens de Marketing é mais barata que a Cloud API?
A Meta diz que ela usa o mesmo modelo de cobrança da Cloud API, e as tarifas vêm da tabela de preços da Meta para o mercado do destinatário. O recurso opcional de preço máximo permite limitar o valor que a Meta cobra por mensagem de marketing entregue. Não presuma economia; compare os resultados entregues e as cobranças das suas próprias campanhas na documentação de preços atual da Meta.
A OmniChannels.ai é compatível com a API de Mensagens de Marketing?
Fale com a nossa equipe. A BroadNet é Provedora de Soluções de Negócios oficial da Meta e hoje envia modelos de marketing do WhatsApp, mas o suporte a essa API específica e às suas otimizações deve ser confirmado conosco para a sua conta antes de você planejar uma migração em torno dela.
Fontes
- Marketing Messages API for WhatsApp: overview, Meta for Developers
- Marketing Messages API for WhatsApp: features, Meta for Developers
- Marketing Messages API for WhatsApp: get started and geographic availability, Meta for Developers
- Route template messages, Meta for Developers
- WhatsApp Business Platform pricing, Meta for Developers
Continue lendo
Mais guiasWhatsApp
Como enviar mensagens de marketing no WhatsApp: o que você precisa
Como enviar mensagens de marketing no WhatsApp do jeito oficial: acesso à API, empresa verificada, modelos aprovados, opt-in, limites e exemplos de modelos.
9 min de leitura
WhatsApp
Modelos de mensagem do WhatsApp: 40+ exemplos para copiar
Modelos de mensagem do WhatsApp de marketing, utilidade e autenticação: mais de 40 textos com variáveis, botões, categorias da Meta e dicas de aprovação.
11 min de leitura
Marketing
WhatsApp para concessionárias: mensagens de vendas e serviço
WhatsApp para concessionárias: retorno a leads, test drive, documentos de financiamento, entrega, revisões, recalls, modelos em árabe e português e métricas.
10 min de leitura
