Passar para o conteúdo principal

Como criar um Modelo de Mensagem na API Oficial da Meta

Como criar mensagens modelo para envio através da API oficial da Meta, garantindo a conformidade com os Termos e Condições de Uso

Como criar Mensagens Modelo?

  1. Acesse o Painel Martz

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

  3. Em WhatsApp, visualize a aba "Modelos de Mensagem"

  4. Clique em "Criar Um Novo Modelo": Defina um nome para sua mensagem (ex: confirmacao_pedido) e escolha a categoria que melhor se adapta ao seu tipo de mensagem:

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

    • Utilidades: Mensagens que não se encaixam nas outras duas, como campanhas de comunicação, envio de código de rastreio, entre outras.

    • Serviços: Mensagens em resposta a conversas iniciadas pelo cliente (passivo).

  5. Escolha o formato (tipo) da mensagem — veja a seção abaixo com todos os formatos disponíveis.

  6. Crie o conteúdo da mensagem: Preencha os campos disponíveis para o formato escolhido (cabeçalho, corpo e rodapé). Utilize uma linguagem clara, objetiva e profissional.

  7. Adicione variáveis nos campos que precisam de personalização dinâmica — veja a seção de variáveis abaixo.

  8. Adicione botões (opcional) — disponível apenas nos formatos Resposta Rápida, Chamada para Ação e Carrossel.

Envie para aprovação: Após criar sua mensagem, ela será analisada pela Meta. O tempo de aprovação pode variar.


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. É opcional em formatos de texto, mas obrigatório quando o formato é Mídia (pois o próprio arquivo ocupa essa posição).

Características:

  • 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).

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 para aprovação. Sem eles, o template pode ser rejeitado.

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

1. Texto simples

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. Com 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) — máx. 50 MB

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

  • Documento (pdf, doc, docx, xls, xlsx, ppt, pptx, txt) — máx. 50 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. 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 (texto)

✅ Opcional

✅ Sim (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. Chamada para Ação

Mensagem com até 4 botões que redirecionam o cliente para uma ação fora do WhatsApp (link, telefone, etc.).

Campo

Disponível?

Variáveis?

Cabeçalho (texto)

✅ Opcional

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

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

Botões de ação

✅ Obrigatório (máx. 4)

Depende do tipo

Tipos de botão disponíveis:

  • Resposta Rápida: cliente toca e responde com texto pré-definido

  • URL Externa: abre um link fixo no navegador (o link é definido no modelo)

  • URL Dinâmica: abre um link personalizado por cliente (ver detalhes abaixo)

  • Ligação Telefônica: discagem automática para um número fixo

  • Copiar Cupom: copia automaticamente um código de desconto

  • URL de Descadastro: link para o cliente solicitar saída da lista

Como funciona o botão de URL Dinâmica:

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 (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 → URL dinâmica do carrinho do cliente

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

5. Carrossel

Formato com múltiplos cards deslizáveis horizontalmente, cada um com sua própria mídia, texto e botões.

Campos em cada card:

Campo

Obrigatório?

Variáveis?

Mídia (imagem ou vídeo)

✅ Sim

Corpo do card (texto)

Opcional

✅ Sim

Botões do card

✅ Sim (mín. 1)

Depende do tipo

Configurações gerais:

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

  • Todos os cards devem usar o mesmo tipo de mídia (todos imagem ou todos vídeo)

  • O texto de cada card suporta de 3 a 160 caracteres

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

Exemplo (3 produtos):

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

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

  • Card 3: Imagem do produto C | Corpo: *#{{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.

6. Detalhes do Pedido — usado para Pix

Formato estruturado para apresentar informações de pedido e cobrança na mensagem, incluindo os itens e o link de pagamento. Na Martz, este é o formato utilizado para envio de Pix.

Campo

Disponível?

Variáveis?

Cabeçalho (texto)

✅ Opcional

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

Corpo

✅ Obrigatório

✅ Sim

Rodapé

✅ Opcional

❌ Não

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

Para poder utilizar o formato Detalhes do Pedido, é necessário solicitar a habilitação diretamente ao suporte da Meta. Trata-se de um recurso que não é liberado automaticamente 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. Somente após essa habilitação o formato estará disponível para criação de modelos no painel.

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

Resumo: campos disponíveis por formato

Formato

Cabeçalho texto

Cabeçalho mídia

Corpo

Rodapé

Botões

Texto

Mídia

Resposta Rápida

✅ até 3

Chamada p/ Ação

✅ até 4

Carrossel

✅ por card

Detalhes do Pedido / Pix


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

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?