WhatsApp Marketing Messages API: o que muda nos seus modelos de mensagem de marketing
Os modelos de marketing do WhatsApp estão saindo da Cloud API e indo para a Marketing Messages API da Meta, e o cliente agora pode interromper e retomar as promoções de uma empresa dentro do WhatsApp. Datas, impacto nos seus disparos e o passo a passo no MonoChat.
Equipe MonoChat Atualizado: 7 min de leitura
Nesta página
- O que é a Marketing Messages API
- O cronograma da Meta
- Como ativar
- O cliente agora pode interromper suas promoções
- Erro 131049: o limite de marketing por destinatário
- Tempo de vida dos modelos de marketing
- O que o MonoChat faz desde a versão 3.8.41
- Passo a passo no MonoChat
- Na prática
- Checklist
- Fontes
A Meta está levando os modelos de mensagem de marketing do WhatsApp da Cloud API para a Marketing Messages API for WhatsApp. A Cloud API para de transportar mensagens de marketing em 13 de outubro de 2027, e contas do WhatsApp Business criadas a partir de 13 de abril de 2027 não poderão enviar marketing por ela. Ao mesmo tempo, o cliente já consegue interromper e retomar as promoções de uma empresa dentro do WhatsApp, e a empresa fica sabendo.
Seu número, seus modelos aprovados e a cobrança da Meta continuam iguais. O que muda é o caminho dos modelos de marketing, para quem você ainda pode mandar promoção e alguns ajustes novos que valem a pena antes da Black Friday e do Natal.
O que é a Marketing Messages API
É um segundo caminho de envio para o mesmo número do WhatsApp Business. A Cloud API continua enviando mensagens de serviço, utilidade e autenticação e recebendo as mensagens dos clientes; a Marketing Messages API envia os modelos de marketing pelo mesmo número, “com otimizações”, segundo a Meta:
- Otimização de entrega para quem tem mais chance de achar a mensagem relevante (teste da Meta com cerca de 12 milhões de mensagens de marketing entregues na Índia, em janeiro de 2025).
- Comparativos de leitura e clique com modelos parecidos de outras empresas da sua região.
- Cabeçalho em GIF.
- Tempo de vida (time-to-live) para modelos de marketing.
- Mesmo modelo de cobrança da Cloud API, mesmo número e mesmos modelos.
No EEE (incluindo Portugal) e no Reino Unido, entre outros, a ativação é possível, mas sem otimização de entrega e sem relatórios de clique e conversão. O Brasil não está nessa lista.
O cronograma da Meta
| Data | O que acontece |
|---|---|
| 19 de novembro de 2025 | A Marketing Messages API sai do beta aberto e fica disponível para todos. |
| 13 de outubro de 2026 | A Meta anuncia o fim do marketing na Cloud API. |
| 13 de abril de 2027 | Contas criadas a partir desta data não enviam marketing pela Cloud API. |
| 13 de outubro de 2027 | Marketing pela Cloud API passa a retornar erro. |
A Meta também recomenda revisar modelos que mudaram de categoria: um modelo aprovado como Utility com conteúdo promocional pode virar Marketing e, a partir daí, precisa ser enviado como marketing.
Como ativar
- Alguém com controle total do portfólio empresarial da Meta abre WhatsApp Manager › Overview.
- Na seção Alerts, clica em Accept terms na Marketing Messages API for WhatsApp.
- Segue os passos e assina os termos.
Depois disso, eventos de status (entregue, lida, clicada) são compartilhados com a Meta para otimizar campanhas; dá para desligar nas configurações da conta do WhatsApp Business. Vale registrar isso na sua documentação de LGPD.
O cliente agora pode interromper suas promoções
O WhatsApp tem, para cada empresa, a configuração Offers and announcements (ofertas e novidades). Ali o cliente diz se tem interesse ou não e pode interromper ou retomar suas mensagens de marketing.
- Sem interesse pode reduzir quantos modelos de marketing a pessoa recebe, sem bloquear e sem avisar você.
- Interromper bloqueia seus modelos de marketing; se enviar mesmo assim, falha com o erro 131050.
- Interromper e retomar disparam o webhook user_preferences, com
stopouresume.
Isso não é o mesmo que opt-in. Pela LGPD e pelo Código de Defesa do Consumidor, o cliente pode se opor ao marketing a qualquer momento; interromper no WhatsApp é exatamente isso, só que para promoções. Avisos de pedido e de entrega continuam chegando. Como coletar o consentimento do jeito certo está no nosso guia de opt-in no WhatsApp.
Erro 131049: o limite de marketing por destinatário
O WhatsApp pode limitar quantos modelos de marketing uma pessoa recebe de todas as empresas, conforme a taxa de leitura dela e o movimento da caixa de entrada. A mensagem retida falha com 131049. Espere pelo menos 24 horas: insistir antes pode bloquear os envios para essa pessoa por até um dia. Mensagens dentro de uma janela de atendimento aberta não contam. Outras causas de disparos que não chegam em por que a transmissão do WhatsApp não é entregue.
Tempo de vida dos modelos de marketing
Se o WhatsApp não consegue entregar uma mensagem, ele tenta de novo durante o tempo de vida (TTL) e depois descarta. Nos modelos de marketing da Marketing Messages API, o padrão é 30 dias, ajustável de 12 horas a 30 dias.
| Oferta | Segundos |
|---|---|
| Promoção relâmpago de 12 horas | 43200 |
| Cupom de 24 horas | 86400 |
| Fim de semana da Black Friday (3 dias) | 259200 |
| Convite com uma semana de antecedência | 604800 |
| Sem prazo | deixe em branco (30 dias) |
O que o MonoChat faz desde a versão 3.8.41
MonoChat 3.8.41 (1º de novembro de 2026), nos canais WhatsApp Business (Cloud):
- Envio por categoria: cada modelo vai com sua categoria. Com a conta ativada, modelos de Marketing saem pela Marketing Messages API e o resto pela Cloud API; sem ativação, tudo segue pela Cloud API. O MonoChat confere o status com frequência, então uma conta recém-ativada muda em até uma hora.
- Status visível: as Configurações do perfil do canal mostram a seção Marketing Messages API com o status.
- Interrupção registrada: o campo de perfil Marketing do WhatsApp interrompido vira Sim, separado do Opt-in do cliente, e uma nota interna, visível só para a equipe, entra na última conversa dele. Ao retomar, volta para Não. Dá para filtrar por esse campo no CRM.
- Sem envio desperdiçado: o envio em massa pula esses clientes nos modelos de Marketing e mostra o motivo; o nó Enviar mensagem de modelo não envia e segue pela saída Em caso de falha.
- Erro em linguagem clara: 131049 aparece como “O cliente atingiu o limite de mensagens de marketing do WhatsApp; tente novamente após 24 horas” na caixa de entrada e em Status da mensagem.
- TTL no editor: em contas ativadas, modelos de Marketing têm o campo Tempo de vida da mensagem (segundos), de 43200 a 2592000.
Passo a passo no MonoChat
- Confira o status: Configurações › Chat › Canais, menu ⋮ do canal WhatsApp Business (Cloud), Configurações do perfil, seção Marketing Messages API.
- Aceite os termos no WhatsApp Manager se ainda não estiver ativado; em até uma hora o MonoChat mostra a conta ativada.
- Defina o tempo de vida: em Configurações › Chat › Canais › ⋮ › Mensagens de modelo, crie um modelo Marketing e preencha Tempo de vida da mensagem (segundos). Inclua uma resposta rápida como “Parar promoções” para o cliente não precisar bloquear você.
- Ajuste os segmentos: filtre por Marketing do WhatsApp interrompido no CRM e deixe esses clientes fora do disparo.
- Proteja os fluxos: ligue a saída Em caso de falha em todo Enviar mensagem de modelo com modelo de Marketing.
- Leia os relatórios: em Sistema › Mensagens em massa, o status e o Status da mensagem mostram quem não recebeu e por quê.
Na prática
Modelo de Marketing de uma loja de artigos esportivos em São Paulo, TTL 86400:
Oi {{1}}, só por 24 horas: 25% off em todos os tênis de corrida até amanhã à meia-noite. Seu número no modelo de trilha que você viu ainda está em estoque. Pague no Pix ou em até 6x.
[Ver a oferta] [Parar promoções]
A nota interna quando o cliente interrompe suas promoções:
O cliente interrompeu as mensagens de marketing do WhatsApp.
O aviso de envio (modelo de utilidade) continua indo:
Oi {{1}}, seu pedido {{2}} foi postado nos Correios. Rastreio: {{3}}
Checklist
- Conta ativada nas Configurações do perfil, bem antes de 2027.
- Categorias corretas; modelo que virou Marketing segue as regras de marketing.
- Tempo de vida em toda oferta com prazo.
- Segmentos sem Marketing do WhatsApp interrompido = Sim.
- Saída Em caso de falha ligada em todo envio de modelo de Marketing nos fluxos.
- Custo conferido antes de grandes disparos na calculadora.
Mais estratégia no guia de marketing no WhatsApp, envios seguros em disparo em massa sem bloqueio e a conexão em a WhatsApp Cloud API explicada. O MonoChat é Meta Business Partner oficial; a Meta cobra as mensagens direto de você, sem margem do MonoChat. Comece grátis no plano Basic em app.monochat.ai.
Fontes
- Meta for Developers: Marketing Messages API for WhatsApp, visão geral e cronograma (acessado em 2 de novembro de 2026)
- Meta for Developers: Onboarding (acessado em 2 de novembro de 2026)
- Meta for Developers: Get started, disponibilidade por região (acessado em 2 de novembro de 2026)
- Meta for Developers: Recursos (acessado em 2 de novembro de 2026)
- Meta for Developers: Roteamento de modelos por categoria (acessado em 2 de novembro de 2026)
- Meta for Developers: Modelos de marketing, preferências do usuário (acessado em 2 de novembro de 2026)
- Meta for Developers: Webhook user_preferences (acessado em 2 de novembro de 2026)
- Meta for Developers: Limites de marketing por usuário (acessado em 2 de novembro de 2026)
- Meta for Developers: Tempo de vida das mensagens (acessado em 2 de novembro de 2026)
- Central de ajuda do MonoChat: Template Messages (acessado em 2 de novembro de 2026)
- Central de ajuda do MonoChat: Bulk Messages (acessado em 2 de novembro de 2026)
- Notas de versão do MonoChat 3.8.41 (acessado em 2 de novembro de 2026)
Coloque isso em prática com o MonoChat