A Marketing Messages API for WhatsApp, antiga MM Lite, é a API da Meta para mensagens com modelos de marketing, e é a única API da Meta em que você pode definir um preço máximo para elas. Com o preço máximo, você limita o custo de cada entrega. Ele está em beta aberto desde 1º de outubro de 2026 e, com a disponibilidade geral no segundo trimestre de 2027, passa a ser obrigatório nos países elegíveis, enquanto as tarifas fixas e publicadas para marketing ficam apenas na Cloud API. Ao migrar, você mantém seus modelos e seu número de telefone atuais e muda só um endpoint. Você também ganha uma entrega ajustada ao engajamento (no teste da Meta, até 9% mais mensagens de alto engajamento entregues do que na Cloud API), além de métricas de conversão, tempo de vida e deep links para Android, que a Cloud API não oferece para marketing.
Principais conclusões
- A Marketing Messages API envia seus modelos de marketing aprovados a partir do número que você já usa, com entrega ajustada ao engajamento.
- A migração exige um passo por portfólio empresarial, a conta da Meta que reúne as contas do WhatsApp e de anúncios da sua empresa. Um administrador aceita os termos da Meta uma única vez, sem novos modelos nem novos números de telefone.
- A Meta cobra apenas pelas mensagens entregues, com os preços padrão da tabela de tarifas, e um preço máximo opcional permite limitar o custo de cada entrega.
- Métricas de conversão, tempo de vida de 12 horas a 30 dias, cabeçalhos em GIF e deep links para Android são recursos de marketing que só esta API oferece.
- A otimização de entrega funciona fora de uma lista curta de países que inclui o Espaço Econômico Europeu e o Reino Unido, e nenhuma API da Meta entrega mensagens de marketing a usuários nos EUA.
O que é a Marketing Messages API for WhatsApp?
A Marketing Messages API for WhatsApp é a API da Meta para enviar mensagens de marketing no WhatsApp, e ela otimiza a entrega para alcançar mais pessoas com maior probabilidade de achar suas mensagens relevantes.[1] Ela faz parte da Plataforma do WhatsApp Business da Meta e funciona ao lado da WhatsApp Cloud API, a API hospedada pela Meta para enviar e receber mensagens do WhatsApp.
As duas APIs compartilham o mesmo número de telefone, e a Marketing Messages API apenas envia; as mensagens recebidas e todos os outros tipos de mensagem continuam na Cloud API.[2] Um modelo de marketing é uma mensagem da categoria de marketing da Meta que precisa passar pela aprovação de modelos antes do envio, e os mesmos modelos aprovados funcionam nas duas APIs.
A Meta chamava a API de Marketing Messages Lite API, ou MM Lite, até a disponibilidade geral em 19 de novembro de 2025.[3]
Com a otimização automática de entrega, a Meta considera se uma mensagem é de alto engajamento nas decisões de entrega. A Meta informa que, assim, entregou até 9% mais mensagens do que a Cloud API em um teste A/B com cerca de 12 milhões de mensagens de marketing entregues, enviadas por anunciantes na Índia em janeiro de 2025 e mensuradas apenas nas mensagens de alto engajamento.[4]
Na 360Dialog, nossa equipe de Performance Messaging ajuda marcas e agências a planejar envios em massa, anúncios de clique para o WhatsApp e fluxos de reengajamento no WhatsApp.
Se você está planejando campanhas que ganhariam com a entrega otimizada, fale conosco sobre Performance Messaging.
Qual é a diferença em relação ao envio de modelos de marketing na Cloud API?
A Marketing Messages API usa os mesmos modelos, o mesmo número de telefone e o mesmo formato de requisição da Cloud API, e acrescenta a otimização de entrega e recursos exclusivos para marketing; assim, a migração muda para onde você envia e o que você consegue mensurar. A comparação de recursos da Meta mostra as diferenças para modelos de marketing:
| Recurso | Marketing Messages API | Cloud API (modelos de marketing) |
|---|---|---|
| Endpoint de envio | /<PHONE_NUMBER_ID>/marketing_messages | /<PHONE_NUMBER_ID>/messages |
| Tipos de mensagem | Apenas modelos de marketing | Todos os modelos e mensagens de formato livre |
| Modelos e número de telefone | Os que você já tem | Os que você já tem |
| Otimização de entrega | Considera o engajamento na entrega | Não |
| Tempo de vida | 12 horas a 30 dias | Apenas autenticação e utilidade |
| Cabeçalho em GIF | Sim | Não |
| Deep links para Android | Sim | Não |
| Métricas de enviadas, entregues, lidas e clicadas | Sim | Sim |
| Métricas de conversão, benchmarks e recomendações | Sim | Não |
| Webhooks de eventos de clique | Sim, com disponibilidade limitada | Não |
Se você está avaliando o que significa levar os envios de marketing para esta API no seu plano e nas tarifas da Meta, fale conosco sobre preços.
Endpoint e corpo da requisição
Só o endereço de envio muda; seu sistema envia o mesmo payload de modelo. Um endpoint é o endereço web para o qual seu sistema envia as requisições da API. O endpoint da Meta para esta API aceita apenas modelos de marketing, e mensagens de formato livre, de autenticação, de serviço ou de utilidade enviadas a ele retornam um erro.[5]
A requisição usa os mesmos campos de um envio de modelo na Cloud API: messaging_product, recipient_type, o número do cliente em to, type definido como template e um objeto template com o nome e o idioma.[6] O campo opcional product_policy define o comportamento de fallback.
Configuração de fallback para a Cloud API
O campo product_policy define o que acontece com uma mensagem de marketing quando a empresa ainda não cumpriu todos os requisitos de onboarding. Com o valor padrão, CLOUD_API_FALLBACK, essas mensagens são enviadas mesmo assim pela Cloud API. Com STRICT, a API nunca as repassa à Cloud API.
Recursos configurados no modelo
O tempo de vida e os deep links pertencem ao modelo, então você os configura ao criar ou atualizar o modelo. O tempo de vida (TTL) é o período em que o WhatsApp continua tentando entregar uma mensagem antes de descartá-la. Para modelos de marketing, o campo message_send_ttl_seconds aceita de 43200 a 2592000 segundos, ou seja, de 12 horas a 30 dias, e o padrão é 30 dias.[7]
Um deep link abre seu app no dispositivo Android do cliente a partir do botão de URL de um modelo. Outros dispositivos abrem a URL do site, e adicionar um botão de deep link a um modelo existente faz com que ele passe de novo pela revisão de modelos.[8]
Quanto custa?
Nesta API, a Meta cobra pelas mensagens de marketing apenas quando elas são entregues, com o mesmo modelo de cobrança da Cloud API, e um preço máximo opcional permite limitar o custo de cada entrega.[9] Sem preço máximo, um modelo de marketing nesta API usa os preços padrão da tabela de tarifas. Com ele, você define o valor máximo que vai pagar por entrega, e a Meta cobra esse valor ou menos.
O preço máximo entrou em beta aberto em 1º de outubro de 2026, e qualquer parceiro já pode ativá-lo para seus clientes. A Meta planeja a disponibilidade geral para o segundo trimestre de 2027, quando o preço máximo passa a ser obrigatório nas regiões elegíveis e as tarifas fixas e publicadas para mensagens de marketing passam a valer apenas na Cloud API.[10]
As tarifas por mercado estão nas tabelas de tarifas da Meta, e nosso guia sobre preços da WhatsApp Business API explica como as cobranças por mensagem se somam.
Onde está disponível e quais são os limites?
Empresas que cumprem as regras de elegibilidade da Meta podem usar a Marketing Messages API, e a localização da empresa e do cliente define quais recursos se aplicam.[11] A Meta agrupa as exceções por país:
- Recursos limitados: no Espaço Econômico Europeu, no Reino Unido, no Japão, na Coreia do Sul, na Nigéria, na África do Sul e na Tailândia, as mensagens enviadas desses países ou para eles ficam sem otimização de entrega e sem relatórios de cliques ou conversões. Os limites de mensagens de marketing por usuário também ficam inativos nesses países, então a entrega não é afetada.
- Estados Unidos: desde 1º de abril de 2025, nenhuma API de mensagens comerciais da Meta entrega mensagens de marketing a usuários do WhatsApp nos EUA (erro 131049). Números comerciais dos EUA ainda podem enviar mensagens a usuários em outros países.
- Rússia e Belarus: a API funciona, mas empresas com perfil comercial da Meta ou endereço de pagamento nesses países ficam sem otimização de entrega, e as métricas de cliques e conversões não ficam disponíveis.
- Regiões excluídas: empresas em Cuba, Irã, Coreia do Norte, Síria, Venezuela, Crimeia, Donetsk e Luhansk não podem fazer o onboarding, e as mensagens não chegam a usuários nessas regiões.
A plataforma da Meta agora usa dois tipos de conta no lugar da conhecida conta do WhatsApp Business (WABA): uma WhatsApp account, que reúne um número de telefone comercial, e uma Messaging account, que reúne seus modelos e seus dados de cobrança.[12] Para ser elegível, você precisa de uma WhatsApp account ativa e sem restrição de envio por violação de políticas, de um país fiscal da Messaging account e de uma empresa proprietária fora de regiões sancionadas, e de um número de telefone registrado na Cloud API. Para saber mais sobre os limites diários de envio e sobre como a Meta libera novos modelos, veja nosso artigo sobre limites de mensagens e ritmo de modelos.
Como migrar? Onboarding e primeiro envio
Para migrar, um administrador aceita os termos da Meta uma única vez para o seu portfólio empresarial, e depois você envia os modelos de marketing para o novo endpoint. A 360Dialog, Official Meta Solution Partner com a confiança de mais de 100.000 empresas, oferece suporte às duas etapas pela sua WhatsApp Business API.[13]
- Verifique a elegibilidade. Confirme que sua configuração pode enviar modelos de marketing: você precisa de um número de telefone comercial registrado na Cloud API, de um modelo de marketing aprovado e de uma assinatura do webhook messages. Um webhook é o endereço web para o qual o WhatsApp envia eventos de mensagens e de status ao seu sistema.
- Aceite os termos. Uma pessoa com controle total do portfólio empresarial aceita os termos da Meta uma única vez. No WhatsApp Manager, abra Overview, clique em Accept terms na seção Alerts e conclua a assinatura. Na 360Dialog, o Client Hub mostra um banner com o botão Accept MM API terms: conecte sua conta do Facebook e conclua o cadastro. Os termos cobrem todas as Messaging accounts do portfólio, e empresas com vários portfólios repetem esta etapa para cada um.[14]
- Confirme o onboarding. A Meta avisa seu sistema quando os termos são assinados. Você recebe um webhook account_update com o evento MM_LITE_TERMS_SIGNED para cada Messaging account, e o campo marketing_messages_onboarding_status da Messaging account mostra ONBOARDED.
- Envie sua primeira mensagem. Direcione os envios de marketing para o novo endpoint com o mesmo payload de modelo. Na 360Dialog, o endereço é https://waba-v2.360dialog.io/marketing_messages, e você se autentica com sua chave de API no cabeçalho D360-API-KEY.[15]
A requisição abaixo envia um modelo aprovado com o fallback para a Cloud API ativado:
POST https://waba-v2.360dialog.io/marketing_messages
D360-API-KEY: <YOUR_API_KEY>
Content-Type: application/json
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<CUSTOMER_PHONE_NUMBER>",
"type": "template",
"template": {
"name": "<TEMPLATE_NAME>",
"language": { "code": "en_US" }
},
"product_policy": "CLOUD_API_FALLBACK"
}Plataformas que fazem o onboarding dos próprios clientes podem incluir a Marketing Messages API no Embedded Signup v4, que oferece suporte a ela desde 8 de outubro de 2025.
Como mensurar os resultados?
As duas APIs informam as contagens de mensagens enviadas, entregues, lidas e clicadas, e esta API acrescenta métricas de conversão, benchmarks e webhooks de eventos de clique. As métricas de conversão mostram com que frequência uma mensagem de marketing leva a uma ação, como uma compra no seu site ou app, e quanto custa cada conversão.[16]
As conversões usam os mesmos eventos dos anúncios da Meta: um Pixel da Meta ou a API de Conversões para sites, e o SDK da Meta para Android, a API de Conversões ou um parceiro de mensuração mobile para apps. A mensuração de apps iOS ainda não tem suporte. Modelos que já existiam antes do onboarding não têm métricas de conversão.
Você vê esses números no WhatsApp Manager. Os benchmarks comparam suas taxas de leitura e de cliques com o percentil 75 de empresas semelhantes no seu país ou região e no seu setor nos últimos 30 dias.[17]
Os webhooks de status funcionam como na Cloud API, com uma marcação: as mensagens enviadas por esta API trazem a categoria de preço marketing_lite, e as mensagens que passaram pelo fallback para a Cloud API trazem marketing. Os webhooks de eventos de clique informam cada clique no corpo de uma mensagem ou no botão de chamada para ação. O recurso tem disponibilidade limitada e cobre mensagens enviadas nos últimos 7 dias.[18]
A migração em si exige um aceite de termos e um novo endpoint. A questão em aberto para cada campanha é se os dados de conversão que você ganha mudam quais modelos você continua enviando.
Se seus modelos de marketing estão aprovados e o administrador do seu portfólio está pronto para aceitar os termos, comece a usar a API e envie sua primeira mensagem pelo endpoint da Marketing Messages API.
Perguntas frequentes
O que é a MM Lite?
MM Lite é o nome antigo da Marketing Messages API for WhatsApp, a API da Meta para enviar mensagens com modelos de marketing com otimização automática de entrega. A Meta a chamava de Marketing Messages Lite API até a disponibilidade geral, em 19 de novembro de 2025. Alguns identificadores técnicos ainda usam o nome antigo, como a categoria de preço marketing_lite e o evento de webhook MM_LITE_TERMS_SIGNED.
A Marketing Messages API é mais barata que a Cloud API?
A Marketing Messages API usa o mesmo modelo de cobrança da Cloud API, e a Meta cobra apenas pelas mensagens entregues. Sem preço máximo, os modelos de marketing usam os preços padrão da tabela de tarifas. Com o preço máximo opcional, em beta aberto desde 1º de outubro de 2026, você limita o custo de cada entrega, e a Meta cobra esse valor ou menos.
Preciso de novos modelos para usar a Marketing Messages API?
Seus modelos de marketing aprovados funcionam na Marketing Messages API, e o onboarding não exige recriar modelos nem registrar um novo número de telefone. Há duas exceções: modelos criados antes do onboarding não têm métricas de conversão, e adicionar um botão de deep link para Android a um modelo existente faz com que ele passe de novo pela revisão de modelos.
Posso continuar enviando mensagens de marketing pela Cloud API?
Sim, a Cloud API continua aceitando modelos de marketing no endpoint messages até você desativar essa opção. Depois do onboarding completo, definir disable_marketing_messages_on_cloud_api como true faz a Cloud API rejeitar modelos de marketing com o erro 131063, e assim todo envio de marketing passa pela Marketing Messages API. O valor padrão dessa configuração é false.
Posso usar a Marketing Messages API pela 360Dialog?
Sim, a 360Dialog oferece a Marketing Messages API em https://waba-v2.360dialog.io/marketing_messages, com autenticação pela sua chave de API no cabeçalho D360-API-KEY. Um administrador do portfólio empresarial aceita os termos uma única vez, pelo WhatsApp Manager ou pelo banner Accept MM API terms no Client Hub da 360Dialog, e o corpo da requisição segue o da Meta, incluindo a configuração de fallback product_policy.
Fontes
[1] Meta for Developers, “Marketing Messages API for WhatsApp” (overview). https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/overview (accessed October 7, 2026)
[2] Meta for Developers, “Marketing Messages API for WhatsApp: Onboard.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/onboarding/ (accessed October 7, 2026)
[3] Meta for Developers, “Marketing Messages API for WhatsApp: Changelog.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/changelog/ (accessed October 7, 2026)
[4] Meta for Developers, “Marketing Messages API for WhatsApp: Features.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/features/ (accessed October 7, 2026)
[5] Meta for Developers, “Send Marketing Messages.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/send-marketing-messages/ (accessed October 7, 2026)
[6] Meta for Developers, “Marketing Messages API for WhatsApp” (API reference). https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/marketing-messages-api-for-whatsapp (accessed October 7, 2026)
[7] Meta for Developers, “Configure message time-to-live.” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live/ (accessed October 7, 2026)
[8] Meta for Developers, “Marketing Messages API for WhatsApp: Deep links.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/deep-links/ (accessed October 7, 2026)
[9] Meta for Developers, “Pricing on the WhatsApp Business Platform.” https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/ (accessed October 7, 2026)
[10] Meta for Developers, “Set a max price (BETA).” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/pricing/ (accessed October 7, 2026)
[11] Meta for Developers, “Marketing Messages API for WhatsApp: Get started.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/get-started/ (accessed October 7, 2026)
[12] Meta for Developers, “WhatsApp accounts and Messaging accounts.” https://developers.facebook.com/documentation/business-messaging/whatsapp/whatsapp-business-accounts/ (accessed October 7, 2026)
[13] 360Dialog, “Performance Messaging.” https://360dialog.com/performance-messaging (accessed October 7, 2026)
[14] 360Dialog documentation, “Onboarding and sending messages.” https://docs.360dialog.com/docs/resources/marketing-messages/onboarding-and-sending-messages (accessed October 7, 2026)
[15] 360Dialog documentation, “Marketing Messages” (API reference). https://docs.360dialog.com/docs/messaging-api/api-reference/marketing-messages (accessed October 7, 2026)
[16] Meta for Developers, “Marketing Messages API for WhatsApp: Measure conversion.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/measure-conversion/ (accessed October 7, 2026)
[17] Meta for Developers, “Marketing Messages API for WhatsApp: Viewing metrics.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/view-metrics/ (accessed October 7, 2026)
[18] Meta for Developers, “Marketing Messages API for WhatsApp: Track click events.” https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/track-click-events/ (accessed October 7, 2026)
