Passar para o conteúdo principal

Criando um Modelo de Mensagem na API Oficial

Como criar modelos de mensagem da API Oficial do WhatsApp: etapas, categorias, formatos, limites, botões e variáveis.

Como criar Mensagens Modelo?

  1. Acesse o Painel Martz

  2. No canto superior direito, clique no seu nome, em seguida "Configurações"

  3. Clique em WhatsApp e abra a aba "Modelos de mensagem"

  4. Clique em "criar novo modelo". A criação tem três etapas: Conta do WhatsApp Business, Informações gerais e Conteúdo.

  5. Conta do WhatsApp Business: selecione a conta (número) em que o modelo será criado.

  6. Informações gerais: preencha:

    • Nome do modelo (ex: confirmacao_pedido). Só são aceitos letras minúsculas, números e sublinhado, sem espaços.

    • Idioma do modelo (Português do Brasil ou de Portugal, Espanhol e variações, Inglês e variações).

    • Tipo de mensagem — veja a seção abaixo com todos os formatos disponíveis.

    • Categoria da mensagem:

      • Marketing: mensagens de promoção, cupom, desconto, cashback, propaganda, entre outros.

      • Utilidades: mensagens informativas ligadas a algo que o cliente fez ou pediu, como confirmação de pedido, envio de código de rastreio e avisos de status.

  7. Conteúdo: preencha os campos disponíveis para o formato escolhido (cabeçalho, corpo, rodapé, botões ou cards). Utilize uma linguagem clara, objetiva e profissional.

  8. Adicione variáveis nos campos que precisam de personalização dinâmica e preencha um exemplo para cada uma — veja a seção de variáveis abaixo.

  9. (Opcional) Clique em "Analisar com a Martz IA" para receber nota, pontos de atenção e sugestões antes do envio. Veja Analisar o modelo de WhatsApp com a Martz IA.

  10. Clique em "Salvar e enviar para Meta".

Aprovação: após o envio, o modelo é analisado pela Meta. O tempo de aprovação pode variar. Na lista de modelos, a coluna Status mostra Não enviado, Em análise, Aprovado, Rejeitado ou Excluindo, e a coluna Qualidade mostra a classificação da Meta. Modelos criados direto na Meta aparecem na Martz pelo botão sincronizar modelos.

Estrutura de um modelo: Cabeçalho, Corpo e Rodapé

Todo modelo de mensagem pode ser composto por até três seções de texto, além de mídia e botões. Entender o papel de cada seção é essencial para criar mensagens bem estruturadas e com maior chance de aprovação.

Cabeçalho

O cabeçalho é a primeira linha da mensagem, exibida em destaque (negrito) antes do corpo. No formato Texto ele é de texto. Nos formatos Feedback rápido e Call to Action, você escolhe em Tipo do cabeçalho: Nenhum, Texto ou Amostra de Mídia (imagem, vídeo ou documento). No formato Mídia, o arquivo ocupa o lugar do cabeçalho e é obrigatório.

Características (cabeçalho de texto):

  • Máximo de 60 caracteres

  • Exibido em negrito no WhatsApp

  • Suporta uma única variável: {{1}}

  • Não suporta formatação adicional (itálico, listas, etc.)

Exemplos:

  • Texto fixo: Seu pedido foi aprovado ✅

  • Com variável: Pedido {{1}} confirmado

⚠️ Atenção: O cabeçalho suporta no máximo uma variável, sempre {{1}}. Essa variável é independente das variáveis do corpo — as variáveis do corpo também começam em {{1}}, mesmo que o cabeçalho já tenha usado um {{1}}. Cada campo tem sua própria sequência de numeração.

Corpo

O corpo é o campo principal da mensagem. É o único campo obrigatório em todos os formatos.

Características:

  • Máximo de 1.024 caracteres

  • Suporta múltiplas variáveis: {{1}}, {{2}}, {{3}}... na ordem em que aparecem no texto

  • Suporta formatação do WhatsApp: negrito com *texto*, itálico com _texto_

Sobre a numeração das variáveis: As variáveis no corpo começam em {{1}}, independentemente de o cabeçalho já ter utilizado um {{1}}. Cabeçalho e corpo são campos separados, cada um com sua própria contagem.

Exemplo com cabeçalho e corpo usando variáveis:

Cabeçalho: Pedido {{1}} confirmado → dado de amostra: "12345"
Corpo: Olá, {{1}}! Seu pedido será entregue em até {{2}} dias no endereço: {{3}}.

{{1}} = "Maria"
{{2}} = "5"
{{3}} = "Rua das Flores, 123 – São Paulo"

ℹ️ Repare que {{1}} no cabeçalho recebe "12345" (número do pedido) e {{1}} no corpo recebe "Maria" (nome do cliente). São valores distintos porque pertencem a campos distintos.

Rodapé

O rodapé é uma linha de texto opcional exibida abaixo do corpo da mensagem, em tom mais discreto (texto cinza menor). Não está disponível no formato Carrossel.

Características:

  • Máximo de 60 caracteres

  • Não suporta variáveis

  • Não suporta formatação (negrito, itálico, etc.) — texto fixo

Exemplos:

ℹ️ O rodapé aparece com fonte menor e cor cinza no WhatsApp — use-o apenas para informações de apoio, nunca para informações importantes da mensagem.

Resumo: qual campo aceita o quê?

Campo

Obrigatório?

Variáveis

Formatação

Limite

Cabeçalho (texto)

Não

Sim — apenas {{1}}

Não

60 caracteres

Corpo

Sim

Sim — {{1}}, {{2}}, {{3}}...

Sim (negrito, itálico)

1.024 caracteres

Rodapé

Não

Não

Não

60 caracteres

Variáveis: como funcionam

As variáveis permitem que o mesmo template seja enviado para diferentes clientes com informações personalizadas. Elas são escritas no formato {{número}}, onde o número indica a ordem de aparição dentro daquele campo.

Na criação do modelo (para aprovação da Meta)

Ao criar o modelo, você não precisa saber de antemão quais dados serão inseridos em cada variável. Neste momento, você apenas:

  1. Insere as variáveis no texto no formato {{1}}, {{2}}, {{3}}...

  2. Preenche dados de amostra para cada variável — valores fictícios que mostram à Meta como a mensagem ficará com dados reais.

Os dados de amostra são obrigatórios: sem eles, não é possível enviar o modelo para aprovação.

Na utilização do modelo em campanhas (preenchimento automático pela Martz)

Quando o modelo aprovado for usado em uma ação de campanha na Martz, cada variável {{1}}, {{2}} etc. será mapeada para um campo dinâmico da Martz — como nome do cliente, código do bônus, número do pedido, link do carrinho, entre outros. O sistema substitui as variáveis automaticamente no momento do envio para cada cliente.

ℹ️ As variáveis no template são apenas "espaços reservados". O conteúdo real de cada envio é definido na campanha, não no modelo. Ao criar o modelo, insira as variáveis e exemplos apenas para fins de aprovação pela Meta.

Regras importantes:

  • A numeração deve ser sequencial e sem pulos: se existir {{3}}, é necessário que {{1}} e {{2}} também existam.

  • O mesmo número pode aparecer mais de uma vez no corpo se o mesmo valor precisar ser repetido.

  • Cabeçalho e corpo têm numerações independentes. Se o cabeçalho usa {{1}}, o corpo começa novamente em {{1}} — não em {{2}}.

Formatos de Modelos de Mensagem disponíveis

No campo Tipo de mensagem aparecem os formatos: Texto, Mídia, Feedback rápido, Call to Action, Carrossel e, quando habilitado para a conta, Detalhes do pedido.

1. Texto

Mensagem composta apenas por texto. Não há arquivo de mídia no cabeçalho.

Campo

Disponível?

Variáveis?

Cabeçalho (texto)

✅ Opcional

✅ Sim (máx. {{1}})

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botões

❌ Não disponível

—

Exemplo:

Cabeçalho: Loja Exemplo
Corpo: Olá, {{1}}! Seu bônus de {{2}} está disponível. Use o código *{{3}}* até {{4}}.
Rodapé: Esta é uma mensagem automática.

Quando usar: Comunicações diretas como lembretes de vencimento de bônus, avisos de status de pedido, comunicações gerais.

2. Mídia

Mensagem com um arquivo de mídia (imagem, vídeo ou documento) exibido no topo, no lugar do cabeçalho de texto.

Campo

Disponível?

Variáveis?

Cabeçalho (mídia)

✅ Obrigatório

— (arquivo, não texto)

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botões

❌ Não disponível

—

Tipos de mídia aceitos:

  • Imagem (jpg, jpeg, png) — máx. 5 MB

  • Vídeo (mp4, 3gp) — máx. 16 MB

  • Documento (pdf, doc, docx, xls, xlsx, ppt, pptx, txt) — PDF até 100 MB

ℹ️ Como a mídia ocupa o cabeçalho, não é possível ter um cabeçalho de texto neste formato. As variáveis começam diretamente no corpo. Para imagens, o tamanho recomendado é 1.125 × 600 px.

Exemplo:

  • Imagem: banner da promoção (1.125 × 600 px)

  • Corpo: Olá, {{1}}! Preparamos uma oferta especial: {{2}}% de desconto. Use o código *{{3}}*.

  • Rodapé: Válido somente hoje.

Quando usar: Promoções com imagem de produto, vídeos demonstrativos, envio de documentos como notas fiscais.

3. Feedback rápido (resposta rápida)

Mensagem com botões de resposta rápida que o cliente toca para responder com um texto pré-definido.

Campo

Disponível?

Variáveis?

Cabeçalho (nenhum, texto ou mídia)

✅ Opcional

✅ Sim, no texto (máx. {{1}})

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botões de resposta rápida

✅ Obrigatório (mín. 1, máx. 3)

—

Cada botão pode ter até 25 caracteres de texto. Ao ser tocado pelo cliente, envia uma resposta automática com o texto do botão.

Exemplo:

Cabeçalho: Pesquisa de satisfação
Corpo: Olá, {{1}}! Como foi sua experiência com o pedido {{2}}? Sua opinião é muito importante para nós. 😊
Botão 1: 😃 Ótima | Botão 2: 😐 Regular | Botão 3: 😞 Ruim

Quando usar: Pesquisas de NPS ou CSAT, confirmações de presença, opções simples de atendimento.

4. Call to Action (chamada para ação)

Mensagem com até 4 botões que levam o cliente a uma ação (abrir um link, ligar, copiar um código etc.).

Campo

Disponível?

Variáveis?

Cabeçalho (nenhum, texto ou mídia)

✅ Opcional

✅ Sim, no texto (máx. {{1}})

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botões de ação

✅ Obrigatório (mín. 1, máx. 4)

Depende do tipo

Tipos de botão disponíveis:

  • Acessar o site: abre um link fixo no navegador (o link é definido no modelo)

  • Acessar o site (dinâmico): abre um link personalizado por cliente (ver detalhes abaixo)

  • Ligar: discagem para um número fixo

  • Copiar código da oferta: copia automaticamente um código de desconto

  • Desinscrever-se: link para o cliente solicitar saída da lista

  • Solicitar contato: pede ao cliente que compartilhe os dados de contato. Só pode ser usado quando é o único botão do modelo.

Regras dos botões: o texto de cada botão tem até 25 caracteres; no máximo 2 botões de site (fixo ou dinâmico) e no máximo 1 botão de cada um dos demais tipos.

Como funciona o botão "Acessar o site (dinâmico)":

Este é o botão mais usado em campanhas de recuperação de carrinho, pois gera um link exclusivo por cliente. Na Martz, o preenchimento funciona assim:

  1. Você informa a URL base do site, terminando em / ou ? (ex: https://minhaloja.com.br/carrinho/)

  2. Você informa um exemplo da parte dinâmica — o trecho que varia por cliente (ex: abc123), apenas para fins de aprovação pela Meta

  3. A Martz cuida automaticamente de complementar a URL com o dado correto de cada cliente no momento do envio — você não precisa inserir nem gerenciar a variável {{1}} manualmente

Exemplo (carrinho abandonado):

  • Cabeçalho: Seu carrinho está esperando 🛒

  • Corpo: Olá, {{1}}! Você deixou alguns itens no carrinho. Finalize e ganhe *{{2}} de desconto* com o código *{{3}}*!

  • Rodapé: Oferta por tempo limitado.

  • Botão: Voltar ao carrinho → Acessar o site (dinâmico), com o carrinho do cliente

Quando usar: Recuperação de carrinho, envio de cupom para copiar, rastreamento de pedido, redirecionamento para pagamento.

5. Carrossel

Formato com um texto principal (corpo) e múltiplos cards deslizáveis horizontalmente, cada um com sua própria mídia, texto e botões. O carrossel não tem cabeçalho nem rodapé.

Campos em cada card:

Campo

Obrigatório?

Variáveis?

Mídia (imagem ou vídeo)

✅ Sim

—

Texto do card

✅ Sim

✅ Sim

Botões do card

✅ Sim (mín. 1, máx. 2)

Depende do tipo

Configurações gerais:

  • Mínimo de 2 cards e máximo de 10 cards

  • Mídia do card: imagem (jpg, jpeg, png, até 5 MB) ou vídeo (mp4, 3gp, até 16 MB). Todos os cards devem usar o mesmo tipo de mídia (todos imagem ou todos vídeo)

  • O texto de cada card tem até 160 caracteres

  • As variáveis de cada card são independentes entre os cards — cada card tem sua própria sequência {{1}}, {{2}}...

⚠️ No carrossel não existe botão de copiar código. Não é possível usar o botão de copiar o código do bônus ou da oferta nos cards. Se precisar que o cliente copie um cupom, use o formato Call to Action com o botão Copiar código da oferta, ou escreva o código no texto do card.

Exemplo (3 produtos):

  • Card 1: Imagem do produto A | Texto: *{{1}}* — R$ {{2}} — {{3}}% de desconto hoje! | Botão: Ver produto

  • Card 2: Imagem do produto B | Texto: *{{1}}* — R$ {{2}} — Frete grátis! | Botão: Ver produto

  • Card 3: Imagem do produto C | Texto: *{{1}}* — R$ {{2}} — Últimas unidades! | Botão: Ver produto

ℹ️ {{1}} e {{2}} se repetem em cada card, mas recebem valores diferentes por card (nome e preço de cada produto).

Quando usar: Apresentação de múltiplos produtos, coleções ou promoções em uma única mensagem. Se o carrossel não salvar, veja Erro ao salvar modelo de carrossel.

6. Detalhes do pedido — usado para Pix

Formato estruturado para apresentar informações de pedido e cobrança na mensagem. Na Martz, este é o formato utilizado para envio de Pix. Ele tem um único botão de ação, com texto padrão Copiar código Pix.

Campo

Disponível?

Variáveis?

Cabeçalho (nenhum, texto ou mídia)

✅ Opcional

✅ Sim, no texto (máx. {{1}})

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botão de ação

✅ 1 botão

—

⚠️ Atenção — requisito especial para este formato:

O formato Detalhes do pedido só aparece no campo Tipo de mensagem quando a conta do WhatsApp tem pagamentos habilitados. Esse recurso não é liberado automaticamente pela Meta para todas as contas.

Passo a passo:

  1. Entre em contato com o suporte da Meta solicitando a habilitação do tipo de template "Order Details" para a sua conta WABA.

  2. Após a confirmação da Meta, informe o time da Martz para que possamos habilitar este formato para a sua loja.

  3. Com a habilitação, o campo Pagamentos no WhatsApp habilitado aparece como ativo nos detalhes do número, e o formato fica disponível para criação de modelos no painel.

Quando usar: Envio de cobrança via Pix com detalhamento do pedido.

Resumo: campos disponíveis por formato

Formato

Cabeçalho texto

Cabeçalho mídia

Corpo

Rodapé

Botões

Texto

✅

❌

✅

✅

❌

Mídia

❌

✅ obrigatório

✅

✅

❌

Feedback rápido

✅

✅

✅

✅

✅ até 3

Call to Action

✅

✅

✅

✅

✅ até 4

Carrossel

❌

❌ (mídia fica em cada card)

✅

❌

✅ até 2 por card

Detalhes do pedido / Pix

✅

✅

✅

✅

✅ 1

Dicas Importantes

  • Revise os Termos e Condições de Uso do WhatsApp Business: Certifique-se de que suas mensagens estejam em conformidade com as políticas da Meta.

  • Seja claro e objetivo: Evite mensagens longas e confusas.

  • Personalize suas mensagens: Utilize as variáveis para tornar a comunicação mais pessoal e relevante para o cliente.

  • Teste suas mensagens: Envie mensagens de teste para garantir que tudo funcione corretamente.

  • Mantenha suas mensagens atualizadas: Adapte seus modelos sempre que houver alterações nas políticas da Meta ou nas suas necessidades de comunicação.

Exemplos de Mensagens Modelo:

  • Confirmação de Pedido: Olá, {{1}}! Seu pedido número {{2}} foi confirmado e será enviado em {{3}}. Obrigado pela sua compra!

  • Notificação de Envio: Olá, {{1}}! Seu pedido número {{2}} foi enviado e você pode acompanhar a entrega em: {{3}}.

Recursos Adicionais:

Dicas para modelos de mensagens do tipo Utilidades

Guideline oficial da Meta

IA para auxiliar na criação de templates de utilidades

Dentro da própria criação do modelo, use o botão Analisar com a Martz IA para receber nota, pontos de atenção e sugestões antes de enviar para a Meta.

O link abaixo é de uma versão customizada do Chat GPT, treinado para gerar templates de disparo para WhatsApp. É uma ferramenta voltada para ajudar a formular mensagens que se encaixem melhor na categoria de utilidades, embora algumas vezes possa não ser preciso (pode ser necessário ficar tentando mesmo, pois o robô de classificação da Meta mesmo não tem critérios tão claros).

Como usar a IA de criação de templates

  • Contextualizar o motivo da mensagem

  • Inserir o template que foi reclassificado para marketing e pedir para ele reescrever de forma que seja aprovado como utilidade, de acordo com as normas do arquivo pdf com o guideline oficial da Meta

  • O chat vai te dar feedbacks e sugestões (nem todas vão ser boas, por isso pode ser necessário voltar no mesmo chat algumas vezes)

    • Se mesmo após a recomendação dele a Meta reclassificar para Marketing, volte no prompt e informe que não deu certo, pedindo para ele reescrever novamente.

    • Dependendo do contexto da mensagem, pode precisar tentar várias vezes (algumas podem nem ser possíveis, caso seja um uso mais claro de marketing mesmo)

Dicas para o nome e conteúdo da mensagem

  • Remover templates que estão sem uso ou foram rejeitados

    • Essa "duplicidade" pode impactar na análise da Meta

  • Atenção ao nome do template

    • No GPT de templates, explicar o que precisa ter no nome do template e pedir para ele melhorar para se encaixar mais em utilidades

  • Não incluir frases com tom de pergunta no template, manter o texto mais informativo

    • Evitar palavras e expressões como: "gostaríamos", "convidamos", "aproveite", "lembrando que..." ou "tem interesse?", pois gatilham reclassificação para marketing

  • Evitar o nome da loja no final do template, preferir sempre no meio da mensagem

    • Ex.:

❌ xxxxxxxxxx xxxxx xxxx Equipe Loja X

✅ XXXXXXXXX Ficamos muito felizes por ter escolhido a loja X… xxxxxxxxxx xxxxxxxx
  • Evitar o uso de emojis quando possível

Ainda precisa de ajuda?

Se você tiver alguma dúvida ou precisar de ajuda para criar suas mensagens modelo, entre em contato conosco. Nossa equipe está pronta para te auxiliar!

Observação: Este artigo é apenas um guia geral. As políticas do WhatsApp Business podem ser atualizadas periodicamente, por isso, é importante consultar a documentação oficial da Meta para obter informações mais recentes e detalhadas.

Respondeu à sua pergunta?