Marketing Messages API: como migrar os disparos de marketing antes de outubro de 2027

Atualizado em 28/10/2026

A Marketing Messages API para o WhatsApp é a API da Meta dedicada a templates de marketing, chamada antes de MM Lite. Em 13 de outubro de 2026 a Meta anunciou que a Cloud API deixa de aceitar mensagens de marketing em 13 de outubro de 2027; contas de mensagens criadas a partir de 13 de abril de 2027 já nascem sem essa opção. Migrar significa enviar seus templates de marketing pelo endpoint /marketing_messages, continuar recebendo respostas pela Cloud API e ajustar o roteamento por categoria.

O que é a Marketing Messages API

Segundo a visão geral da Meta, é uma API para enviar mensagens de marketing que otimiza a entrega para alcançar as pessoas com mais chance de achar a mensagem relevante. Ela tem um esquema técnico parecido com o da Cloud API, usa o mesmo modelo de cobrança e aceita os números e os templates de marketing que você já tem.

O nome mudou ao longo do caminho. A documentação antiga falava em Marketing Messages Lite API (MM Lite), e esse nome ainda aparece em alguns lugares, como no webhook de status (marketing_lite) e na configuração do Cadastro Incorporado. Hoje o produto se chama Marketing Messages API for WhatsApp. A disponibilidade geral foi em 19 de novembro de 2025.

O que ela não faz: receber mensagens. A Meta descreve a MM API como só de envio. As respostas dos clientes continuam chegando pela Cloud API, no mesmo número, pelos mesmos webhooks.

O cronograma oficial

Data	O que acontece
19/11/2025	Disponibilidade geral da Marketing Messages API
06/04/2026	Empresas integradas podem desligar o marketing na Cloud API (erro 131063)
13/10/2026	Anúncio global do fim do marketing na Cloud API
13/04/2027	Contas de mensagens criadas a partir desta data não enviam marketing pela Cloud API
13/10/2027	Fim global: enviar marketing pela Cloud API retorna erro

Contas criadas antes de 13/04/2027 continuam enviando marketing pela Cloud API até 13/10/2027. A Meta explica que o marco de abril existe para que empresas novas não comecem no produto antigo por engano. Serviço, autenticação e utilidade continuam na Cloud API, sem mudança.

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

O que muda no código

O endpoint

O envio usa a mesma sintaxe de payload da Cloud API e as mesmas permissões. Muda o caminho:

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

Pontos que a página de envio deixa claros:

• Só aceita template de marketing. Texto livre, autenticação, serviço e utilidade em /marketing_messages dão erro.
• product_policy. Com CLOUD_API_FALLBACK (padrão), se a conta não cumpriu os requisitos de integração, a mensagem sai pela Cloud API. Com STRICT, não há fallback.
• message_activity_sharing. Parâmetro opcional que liga ou desliga o compartilhamento de atividade da mensagem (por exemplo, leitura) com a Meta para otimização. Sem ele, vale a configuração da conta.
• BSUID. Desde 5 de maio de 2026 o campo recipient aceita o identificador de usuário criado para os usernames do WhatsApp. Envios por BSUID não recebem otimização de entrega.

Os webhooks de status

A MM API dispara os webhooks de status normais (sent, delivered, read). Quando a mensagem saiu por ela, pricing.category e conversation.origin.type vêm como marketing_lite. Se caiu no fallback da Cloud API, vem marketing:

{
  "conversation": { "id": "<CONVERSATION_ID>", "origin": { "type": "marketing_lite" } },
  "pricing": { "billable": true, "pricing_model": "PMP", "category": "marketing_lite" }
}

A Meta recomenda guardar, para cada wamid, qual API foi usada. Se o seu código hoje filtra category === "marketing" para relatórios de custo, inclua marketing_lite. O formato geral desses eventos está em status de mensagem via webhook.

O erro 131063 e o desligamento do marketing na Cloud API

Desde 6 de abril de 2026, quem concluiu a integração com a MM API pode bloquear templates de marketing no /messages:

curl -X POST 'https://graph.facebook.com/<API_VERSION>/<WABA_ID>' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "disable_marketing_messages_on_cloud_api": true }'

Com isso ativo, um template de marketing enviado pela Cloud API volta com:

{
  "error": {
    "message": "(#131063) Marketing templates disabled for Cloud API",
    "type": "OAuthException",
    "code": 131063
  }
}

Cuidado com a ordem. Se a conta começou a integração mas não aceitou os termos da MM API, o fallback do /marketing_messages para a Cloud API também é rejeitado com 131063. Ou seja: ligar essa opção antes de concluir a integração derruba todos os seus disparos de marketing. Para desfazer, envie o mesmo campo como false.

Esse erro vai ficar comum em 2027. Trate 131063 como sinal de que o template foi parar no endpoint errado, não como falha temporária: nada de retry no mesmo endpoint.

Roteamento por categoria: o detalhe que quebra integrações

A migração não é só trocar a URL dos disparos. A Meta pode reclassificar um template de utilidade como marketing, e a orientação oficial é que mensagens reclassificadas sejam enviadas pela MM API. Na prática, seu sistema precisa:

1. Manter um mapa template → categoria atualizado (a Meta publicou em 24/09/2026 um guia de roteamento de templates justamente para isso).
2. Escolher o endpoint pela categoria no momento do envio, não pelo tipo de campanha.
3. Tratar mudanças de categoria: se um template virou marketing, as próximas chamadas vão para /marketing_messages.

Se você ainda tem dúvida sobre o que a Meta considera marketing, veja como a Meta classifica seu template.

Recursos que só existem na MM API

A Meta lista recursos que não estão disponíveis para templates de marketing na Cloud API:

• Otimização de entrega. A Meta direciona a entrega para quem tem mais chance de interagir. Há restrições geográficas para alguns recursos.
• Otimizações automáticas de criativo. Filtros de imagem, extração de título, formatação de texto e outros. No nível do template vêm ligadas por padrão; no nível da conta, desde 21 de abril de 2026, vêm desligadas e você opta por ativar.
• Tempo de vida (TTL) para marketing. Defina até quando a Meta tenta entregar, útil para ofertas com hora para acabar.
• GIFs e outros formatos de mídia.
• Métricas. Benchmarks contra empresas semelhantes, recomendações e métricas de conversão fora do WhatsApp (que exigem Pixel da Meta ou API de Conversões; veja API de Conversões para WhatsApp).
• Preço máximo. Desde 1º de outubro de 2026 em beta aberto: você define o valor máximo por entrega e a Meta cobra esse valor ou menos. Envios com preço máximo para países sem suporte retornam o erro 131065.

Um detalhe operacional: depois de criar um template de marketing (ou usar um parado há mais de 7 dias), a Meta pede para esperar 10 minutos antes de enviar, por causa da sincronização com a conta de anúncios.

E o preço?

A Meta diz apenas que a MM API usa o mesmo modelo de cobrança da Cloud API, por mensagem entregue. Ela não publica uma tarifa diferente para quem migra. Para destinatários no Brasil, a tarifa de marketing na tabela oficial é R$ 0,3217 por mensagem desde 1º de outubro de 2026. Com o preço máximo ativado, o valor cobrado passa a ser o teto que você definiu ou menos. Para estimar uma campanha, use quanto custa uma campanha no WhatsApp.

Checklist de migração

1. Aceite os termos da Marketing Messages API.
2. Confirme os requisitos de integração. A Meta estima cerca de duas semanas para a maioria das integrações.
3. Separe o envio por categoria com o mapa de templates descrito acima.
4. Comece com CLOUD_API_FALLBACK e monitore pricing.category: se aparece marketing, o fallback está acontecendo.
5. Passe para STRICT quando todos os envios saírem como marketing_lite.
6. Ajuste relatórios e custos para reconhecer marketing_lite.
7. Ative disable_marketing_messages_on_cloud_api só no fim, para pegar qualquer chamada esquecida no /messages com o erro 131063 antes do prazo da Meta.
8. Faça isso antes da sua alta temporada. Se a sua Black Friday de 2027 cair depois de 13 de outubro, ela já roda só na MM API.

Para as outras mudanças do ano, veja novidades da API do WhatsApp em 2026.

Como fica na Vectalk

A Vectalk é um proxy da API oficial do WhatsApp: você usa os payloads da Meta, paga a Vectalk e a Vectalk paga a Meta. Hoje a documentação da Vectalk descreve o envio de templates por POST /api/messages, o equivalente ao /messages da Cloud API, que continua válido para marketing até os prazos acima. As respostas dos clientes continuam chegando pelos webhooks que você registrou. Para começar, crie sua conta em apps.vectalk.com.br/register.

Perguntas frequentes

A Marketing Messages API é a mesma coisa que MM Lite?

Sim. MM Lite (Marketing Messages Lite API) era o nome anterior. O produto atual é a Marketing Messages API for WhatsApp, e o termo marketing_lite ainda aparece nos webhooks de status.

Preciso trocar de número para usar a MM API?

Não. A Meta informa que dá para usar os números e os templates de marketing existentes. O mesmo número envia marketing pela MM API e recebe mensagens pela Cloud API.

Templates de utilidade e autenticação também mudam de endpoint?

Não. Serviço, autenticação e utilidade continuam na Cloud API. O /marketing_messages recusa qualquer coisa que não seja template de marketing.

O que acontece se eu não migrar até 13/10/2027?

Pela documentação, depois dessa data o envio de marketing pela Cloud API retorna erro. Se a sua conta de mensagens for criada a partir de 13/04/2027, isso já vale desde o início.

Como recebo as respostas de uma campanha enviada pela MM API?

Pela Cloud API, no mesmo número comercial e nos mesmos webhooks. A MM API só envia.

---

Fontes oficiais consultadas em 28/10/2026: Marketing Messages API for WhatsApp: visão geral (atualizada em 13/10/2026), Enviar mensagens de marketing (atualizada em 21/05/2026), Changelog da Marketing Messages API, Changelog da plataforma do WhatsApp, Preços da plataforma do WhatsApp Business (atualizada em 30/09/2026).