Tag: Mensagens de marketing

Os formatos de modelos de marketing do WhatsApp permitem que uma empresa envie uma mensagem de campanha como vídeo, como uma sequência de cartões de produtos para rolar para o lado ou como uma oferta com contagem regressiva e botões. Os clientes podem comparar produtos, copiar um código de desconto ou abrir a loja direto da conversa, em um só passo. Cada formato é um modelo, uma mensagem que a empresa escreve com antecedência e que a Meta aprova antes do envio. Depois de aprovado, o modelo mantém seus cartões, textos e botões, então uma única peça pode servir a uma campanha inteira.

Principais conclusões

1. Um carrossel de mídia mostra de 2 a 10 cartões para rolar para o lado em uma só mensagem, e o número de cartões fica fixo quando o modelo é aprovado.
2. Um modelo de oferta por tempo limitado acrescenta um código de oferta e uma contagem regressiva em tempo real, e quem abre a mensagem no WhatsApp Web ou no app para computador vê apenas um aviso de que a oferta não é compatível.
3. Os cabeçalhos de vídeo aceitam arquivos MP4 ou 3GPP de até 16 MB, com vídeo H.264 e áudio AAC.
4. Um modelo pode ter até 10 botões e, quando passa de três, dois aparecem na mensagem e os demais ficam atrás de um botão “Ver todas as opções”.
5. A 360Dialog dá às empresas acesso à WhatsApp Business API para criar esses modelos, e a Meta analisa cada um antes do primeiro envio.

O que é um formato de modelo de marketing do WhatsApp?

Um formato de modelo de marketing do WhatsApp é a estrutura de uma mensagem de campanha aprovada: texto simples, um cabeçalho de mídia, um carrossel de cartões, uma oferta com contagem regressiva ou uma combinação desses elementos com botões. Marketing é uma das categorias de modelo definidas pela Meta, e os modelos de marketing costumam servir para engajamento, reconhecimento de marca e vendas.[1] Eles também são o único tipo de modelo que funciona nas duas rotas de envio da Meta, a Cloud API e a API de Mensagens de Marketing.

A Meta agrupa carrosséis, ofertas por tempo limitado e códigos de cupom entre seus modelos de marketing especiais, e cada um tem regras próprias:

Formato	O que a pessoa vê	Ideal para	Limite principal
Modelo com cabeçalho de mídia	Texto com uma imagem, um vídeo ou um documento acima e botões abaixo	Lançamentos, comunicados, demonstrações de produto	Corpo de até 1.024 caracteres
Carrossel de mídia	De 2 a 10 cartões para rolar para o lado, cada um com uma imagem ou um vídeo e até dois botões	Vários produtos ou as etapas de um processo	Número de cartões fixo na aprovação
Oferta por tempo limitado	Um código de oferta, uma contagem regressiva até o vencimento e um botão para a loja	Promoções com data de término	Oculta no WhatsApp Web e no app para computador
Código de cupom	Um botão que copia um código de desconto	Um código sem prazo	Um botão de copiar código por modelo

O envio de qualquer um desses formatos para uma lista grande está sujeito aos limites de mensagens e ao ritmo de envio de modelos da Meta.

Quais partes todo modelo de marketing compartilha?

Todo modelo de marketing é formado por até quatro partes: um corpo obrigatório, além de cabeçalho, rodapé e botões opcionais.[2] Conhecer cada limite antes de redigir permite que o texto caiba no formato já na primeira versão. As variáveis são espaços reservados, como um primeiro nome, que a empresa preenche no momento do envio, e a Meta exige um valor de exemplo para cada uma quando o modelo é criado.

Os exemplos abaixo vêm de um lançamento fictício de coleção de primavera.

Parte	Obrigatória	Limite	Exemplo
Corpo	Sim, um por modelo	1.024 caracteres; várias variáveis permitidas	“Oi, {{1}}, a coleção de primavera já chegou às lojas e ao site.”
Cabeçalho de texto	Não	60 caracteres; uma variável	“Novidades de primavera, {{1}}”
Cabeçalho de mídia	Não	Uma imagem, um vídeo, um GIF ou um documento, como um PDF	Um vídeo curto da nova jaqueta
Cabeçalho de localização	Não	Um mapa de um local definido no envio; localização em tempo real não é compatível	A loja que recebe o lançamento
Rodapé	Não	60 caracteres; só texto	“Válido enquanto durarem os estoques”
Botões	Não	Detalhados na seção de botões abaixo	“Comprar a coleção”

Os cabeçalhos em GIF são arquivos MP4 de até 3,5 MB e funcionam apenas pela API de Mensagens de Marketing. O WhatsApp exibe um arquivo maior como um vídeo comum.

Quais arquivos de imagem e vídeo funcionam no cabeçalho de um modelo?

Os cabeçalhos de modelo aceitam imagens JPEG e PNG de até 5 MB e vídeos MP4 ou 3GPP de até 16 MB.[3] Para rodar em qualquer celular, o vídeo também precisa da codificação certa.

Mídia	Tipos de arquivo	Tamanho máximo	Codificação	Exemplo
Imagem	JPEG, PNG	5 MB	8 bits, RGB ou RGBA	Uma foto do produto em um fundo neutro
Vídeo	MP4, 3GPP	16 MB	Vídeo H.264 e áudio AAC, com uma faixa de áudio ou nenhuma	Uma demonstração curta do produto em uso

Alguns celulares Android não conseguem reproduzir vídeos salvos com configurações avançadas de compressão. Exporte o vídeo em H.264 com o perfil Main ou Baseline e a opção “fast start” ativada, configurações que a maioria dos editores de vídeo oferece na exportação. Um arquivo cujo tipo não corresponde à extensão falha com o erro 131053, um tipo MIME incompatível.

Sugerimos vídeos de campanha curtos, compreensíveis sem som e enquadrados para que o produto fique visível na tela do celular.

Como funcionam os modelos de carrossel de mídia?

Um modelo de carrossel de mídia envia uma única mensagem de modelo de marketing com 2 a 10 cartões que a pessoa rola para o lado, cada um com sua própria imagem ou vídeo e até dois botões.[4] Com ele, uma empresa mostra uma linha de produtos, ou as etapas de um processo, em uma só mensagem. Só modelos de marketing podem incluir cartões de carrossel. A empresa define o número exato de cartões ao criar o modelo, e um modelo aprovado sempre envia esse mesmo número. Por isso, uma campanha com cinco cartões exige um modelo próprio de cinco cartões.

Os exemplos abaixo mostram três novos tênis de corrida em trilha.

Campo	Limite	Exemplo
Corpo da mensagem acima dos cartões	Obrigatório; 1.024 caracteres; variáveis permitidas	“Oi, {{1}}, chegaram três novos tênis de trilha.”
Cartões	De 2 a 10, fixos na criação	3 cartões, um por tênis
Cabeçalho do cartão	Uma imagem ou um vídeo em cada cartão, recortado automaticamente em formato largo para cada aparelho	Vista lateral de cada tênis
Texto do cartão	Opcional, mas quando um cartão tem texto, todos precisam ter; 160 caracteres, incluindo variáveis	“Cabedal impermeável, do 38 ao 47”
Botões do cartão	Até dois por cartão, combinando botões de resposta rápida, de número de telefone e de URL; todos os cartões têm os mesmos componentes	“Comprar agora” e “Me lembre”

Os botões de URL abrem o navegador padrão do celular, e a compra acontece fora do WhatsApp. Um pedido feito ali não dispara nenhum webhook, o aviso automático que o WhatsApp envia ao servidor da empresa. Para compras que ficam dentro do WhatsApp, a Meta indica os modelos de carrossel de produtos.[5] Os cartões desses modelos vêm de um catálogo de produtos e mostram imagem, título e preço do produto, além de um único botão Ver ou de URL.

Os botões de resposta rápida podem levar um valor oculto, o payload, que a empresa define no envio. Quando alguém seleciona o botão, o payload volta no webhook de mensagens em messages.button.payload. Com um payload diferente em cada cartão, a empresa sabe qual produto a pessoa escolheu.

Sugerimos dedicar cada cartão a um ângulo do produto ou a uma etapa, com fotos em um estilo consistente para que os cartões formem um conjunto. Carrosséis enviados como resposta dentro de uma conversa aberta são outro tipo de mensagem, explicado no nosso guia de mensagens interativas.

Como funcionam os modelos de oferta por tempo limitado?

Um modelo de oferta por tempo limitado é um modelo de marketing que mostra um código de oferta com uma contagem regressiva até o vencimento.[6] Com ele, uma empresa faz uma promoção com data marcada a partir de uma única mensagem, com o código e o prazo lado a lado. O formato não permite rodapé. Quem abre a mensagem no WhatsApp Web ou no app para computador vê apenas um aviso de que a oferta não é compatível ali.

Os exemplos abaixo vêm de uma promoção de fim de semana.

Campo	Limite	Exemplo
Cabeçalho	Opcional; uma imagem ou um vídeo	Foto dos itens em promoção
Corpo	600 caracteres; as variáveis contam para o limite	“Oi, {{1}}, os casacos estão com desconto até domingo à noite.”
Texto da oferta	Obrigatório; 16 caracteres	“Fim de semana”
Código da oferta	Exemplo obrigatório na criação; 15 caracteres	“FIMDESEMANA”
Botão de URL	Obrigatório; rótulo de 25 caracteres com uma variável; URL de 2.000 caracteres com uma variável no final	“Ver a promoção”
Botão de copiar código	Obrigatório e primeiro na ordem dos botões quando o vencimento aparece	Copia “FIMDESEMANA”

A contagem regressiva aparece quando o modelo define has_expiration como true. O botão de copiar código passa então a ser obrigatório e precisa vir primeiro na lista de botões.[7] O texto da contagem regressiva não pode ser personalizado e fica vermelho quando alguém vê a mensagem na última hora antes do vencimento do código. No envio, a empresa informa o código real e o vencimento, escrito como timestamp UNIX em milissegundos no campo expiration_time_ms.

Empresas sediadas no Brasil também podem combinar o formato com botões de solicitação de pagamento para Pix, Boleto ou link de pagamento. Para um código sem prazo, um modelo de código de cupom usa um único botão de copiar código, que coloca o código na área de transferência da pessoa.[8]

Quais botões um modelo de marketing pode usar?

Um modelo de marketing pode ter até 10 botões no total, distribuídos entre cinco tipos com limites próprios. Escolher os tipos com esses limites em mente mantém a ação principal visível e a mensagem legível no computador.

Botão	O que faz	Máximo por modelo	Limite do rótulo	Exemplo
Resposta rápida	Envia o próprio rótulo de volta à empresa como resposta	10	25 caracteres	“Parar promoções”
URL	Abre uma página no navegador do celular	2	25 caracteres; URL de 2.000 caracteres com uma variável no final	“Comprar agora”
Número de telefone	Liga para o número da empresa	1	25 caracteres; número de 20 caracteres	“Ligar para a loja”
Copiar código	Copia um código para a área de transferência	1	Código de 20 caracteres, ou 15 em uma oferta por tempo limitado	“PRIMAVERA”
Chamada de voz	Inicia uma ligação pelo WhatsApp com a empresa	Não especificado	20 caracteres	“Call Now”

Três regras de exibição definem o que a pessoa vê:

• Os botões de resposta rápida precisam ficar juntos. Duas respostas rápidas seguidas de um botão de URL são permitidas, mas um botão de URL entre duas respostas rápidas não é.
• Com mais de três botões, a mensagem mostra dois e coloca os demais atrás de um botão “Ver todas as opções”.
• O WhatsApp para computador não exibe modelos com quatro ou mais botões, ou com uma resposta rápida combinada a qualquer outro tipo de botão, e pede que a pessoa abra a mensagem no celular.

O rótulo do botão de chamada de voz tem “Call Now” como padrão, e o botão fica ativo de 1 a 30 dias. A documentação de chamadas da Meta explica como adicioná-lo a um modelo.[9]

Sugerimos menos botões, com rótulos de ação curtos como “Comprar agora”. Com três botões ou menos, todos ficam visíveis na mensagem.

Qual formato combina com cada objetivo de campanha?

O objetivo da campanha define o formato: um carrossel serve para vários produtos, uma oferta por tempo limitado serve para um prazo e um cabeçalho de vídeo serve para uma demonstração. Alinhar os dois antes de escrever evita refazer um modelo depois da aprovação.

• Vários produtos, ou as etapas de um processo: um carrossel de mídia.
• Uma promoção com data de término fixa: um modelo de oferta por tempo limitado.
• Um código de desconto sem prazo: um modelo de código de cupom.
• Uma demonstração de produto: um modelo com cabeçalho de vídeo.
• Uma compra que fica dentro do WhatsApp: um carrossel de produtos ou outro modelo de catálogo, explicado no nosso guia sobre como vender no WhatsApp.
• Dados como um tamanho ou um horário de agendamento coletados na conversa: WhatsApp Flows.

Como criar um modelo de marketing com a 360Dialog?

Uma empresa cria um modelo de marketing pela WhatsApp Business API, ou no 360Dialog Hub para os formatos que o Hub aceita, e a Meta analisa o modelo antes do primeiro envio.[10] A 360Dialog é um Official Meta Solution Partner que fornece o acesso à WhatsApp Business API em que esses modelos funcionam. O Hub permite que um profissional de marketing monte cabeçalhos, corpo do texto, rodapés, botões e ofertas por tempo limitado sem escrever código. Os desenvolvedores enviam um modelo com uma requisição POST para https://waba-v2.360dialog.io/v1/configs/templates, autenticada com o cabeçalho D360-API-KEY.

Nossa documentação explica, campo por campo, os modelos de oferta por tempo limitado e os modelos de carrossel de produtos. Nosso artigo sobre por que os modelos do WhatsApp são rejeitados trata da análise da Meta. Crie um primeiro modelo de carrossel ou de oferta por tempo limitado e envie-o ao seu próprio celular como teste: Começar a usar a API.

Planejar o formato antes do texto faz cada mensagem de campanha caber nos limites da Meta desde o primeiro rascunho. Assim, os clientes comparam produtos, copiam um código ou chegam à loja direto da conversa, em um só passo. A equipe passa menos tempo refazendo modelos depois da análise. Envie esse primeiro formato de campanha pela 360Dialog: Começar a usar a API.

Perguntas frequentes

Quantos cartões um modelo de carrossel do WhatsApp pode ter?

Um modelo de carrossel de mídia do WhatsApp comporta de 2 a 10 cartões. A empresa define o número exato ao criar o modelo, e todo envio desse modelo aprovado leva a mesma quantidade de cartões. Uma campanha que precisa de outro número de cartões exige um modelo separado, criado e aprovado com essa quantidade.

Que cabeçalho um cartão de carrossel pode usar?

O cabeçalho de um cartão de carrossel é uma imagem ou um vídeo, e todos os cartões do carrossel precisam de um. O WhatsApp recorta a mídia automaticamente em um formato largo que se ajusta ao aparelho de quem lê. As imagens podem ser arquivos JPEG ou PNG de até 5 MB, e os vídeos, arquivos MP4 ou 3GPP de até 16 MB.

Por que algumas pessoas não veem minha oferta por tempo limitado?

Um modelo de oferta por tempo limitado não exibe a oferta no WhatsApp Web nem no app para computador. Quem abre a mensagem ali vê um aviso de que a oferta não é compatível, sem o código e sem a contagem regressiva. Os modelos de código de cupom têm uma lacuna parecida, já que a Meta não oferece suporte a eles no WhatsApp Web.

Qual pode ser o tamanho de um código de oferta por tempo limitado?

Um código de oferta por tempo limitado pode ter até 15 caracteres. O modelo precisa de um código de exemplo dentro desse limite na criação, e a empresa informa o código real no momento do envio. Em um modelo de código de cupom padrão, o botão de copiar código aceita um código de até 20 caracteres.

Quantos botões um modelo do WhatsApp pode ter?

Um modelo do WhatsApp pode ter até 10 botões no total. Dentro desse total, cabem até 10 botões de resposta rápida, dois botões de URL, um botão de número de telefone e um botão de copiar código. Quando um modelo tem mais de três botões, dois aparecem na mensagem e os demais ficam atrás de um botão “Ver todas as opções”.

Que formato de vídeo o WhatsApp aceita em modelos?

Os cabeçalhos de modelos do WhatsApp aceitam arquivos de vídeo MP4 e 3GPP de até 16 MB. O vídeo precisa usar o codec H.264 com áudio AAC e ter uma faixa de áudio ou nenhuma. Para celulares Android, a Meta recomenda o perfil Main do H.264 sem B-frames, ou o perfil Baseline.

Fontes

[1] Meta for Developers, “Marketing templates,” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates (accessed October 28, 2026).

[2] Meta for Developers, “Template components,” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (accessed October 28, 2026).

[3] Meta for Developers, “Media,” https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media (accessed October 28, 2026).

[4] Meta for Developers, “Media card carousel templates,” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates (accessed October 28, 2026).

[5] Meta for Developers, “Product card carousel templates,” https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/product-card-carousel-template-messages (accessed October 28, 2026).

[6] Meta for Developers, “Limited-time offer templates,” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/limited-time-offer-templates (accessed October 28, 2026).

[7] 360Dialog documentation, “Limited-Time Offer Templates,” https://docs.360dialog.com/docs/resources/templates/limited-time-offer-templates (accessed October 28, 2026).

[8] Meta for Developers, “Coupon code templates,” https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates (accessed October 28, 2026).

[9] Meta for Developers, “Send WhatsApp Call Button Messages and Deep Links,” https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/call-button-messages-deep-links/ (accessed October 28, 2026).

[10] 360Dialog documentation, “Templates,” https://docs.360dialog.com/docs/hub/template-management-ui (accessed October 28, 2026).

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

1. A Marketing Messages API envia seus modelos de marketing aprovados a partir do número que você já usa, com entrega ajustada ao engajamento.
2. 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.
3. 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.
4. 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.
5. 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]

1. 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.
2. 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]
3. 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.
4. 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)