Passar para o conteúdo principal

Erro ao criar ou salvar um modelo de mensagem na API Oficial: o que verificar

Erro ao salvar um modelo de mensagem da API Oficial mesmo com os campos preenchidos: variáveis nas pontas ou fora de ordem, exemplo faltando, emoji, botão, imagem, idioma bloqueado e permissão na BM.

Você está no lugar certo se:

  • Toda vez que tenta salvar um novo modelo de mensagem aparece um erro

  • O erro aparece mesmo com todos os campos preenchidos

  • Aparece "o componente do tipo BODY está faltando o exemplo esperado"

  • Precisa cadastrar o modelo para uma campanha e está travado no erro

Visão geral

O modelo de mensagem da API Oficial é aprovado pela Meta: ao clicar em Salvar e enviar para Meta, a Martz envia o que você preencheu para a Meta validar. Quase sempre o motivo do erro é um detalhe de formatação no conteúdo do modelo, e não um problema da sua conta.

Abaixo estão as causas mais comuns, na ordem em que vale a pena verificar. Para erros de nome repetido e modelo que não aparece no painel, veja também Meu modelo de mensagem não salva ou não aparece.

Situação 1: variável no início ou no fim do texto, ou fora de ordem

O que acontece: o modelo não salva e o erro persiste mesmo encurtando ou trocando o texto.

Por que acontece: é uma regra da Meta: a variável não pode ser o primeiro nem o último elemento do texto, e as variáveis precisam seguir uma sequência numérica.

Como resolver:

  1. No início, coloque um texto antes da variável. Ex.: use "Olá, {{1}}" em vez de começar com "{{1}}, ...".

  2. No fim, adicione um texto depois da última variável. Ex.: termine com "Com carinho, equipe da loja" após o {{2}}.

  3. Use as variáveis em ordem: a primeira deve ser {{1}}, a segunda {{2}}, a terceira {{3}}, sem pular números. Se você usa apenas uma variável, ela deve ser {{1}}.

  4. A variável do cabeçalho conta separada das variáveis do corpo. A contagem do corpo começa do {{1}} de forma independente.

Atenção: terminar a mensagem com algo como "Use o cupom: {{2}}" costuma gerar erro. Coloque um texto depois da variável.

Situação 2: "o componente do tipo BODY está faltando o exemplo esperado"

O que acontece: o erro aparece mesmo quando você acha que já preencheu os exemplos.

Por que acontece: o exemplo de alguma variável do corpo não foi reconhecido, porque a numeração está fora de sequência ou o exemplo não é um valor válido.

Como resolver:

  1. Confira a numeração das variáveis do corpo ({{1}}, {{2}}, {{3}}...), sem pular números.

  2. Preencha um exemplo coerente com o que a variável representa, sem as chaves {{ }}. Se a variável for um link, o exemplo precisa ser um link real (ex.: https://sualoja.com/carrinho), e não uma palavra como "Carrinho". Para um cupom, use algo como MTZASD1451.

  3. Salve o modelo novamente.

Situação 3: emoji no cabeçalho ou no rodapé

O que acontece: o modelo não é aceito quando há emoji no título ou na linha final.

Por que acontece: o cabeçalho e o rodapé não podem conter emoji. No corpo da mensagem o emoji é permitido.

Como resolver: remova qualquer emoji do cabeçalho e do rodapé e, se quiser usar, mantenha apenas no corpo.

Situação 4: botão sem texto ou link inválido

O que acontece: o erro aparece ao usar um botão, como o de copiar código da oferta, ou um botão com link.

Por que acontece: o botão precisa de texto (até 25 caracteres), e o link precisa ser válido. No botão Acessar o site (dinâmico), a URL precisa terminar em "/" ou "?".

Como resolver:

  1. Preencha o texto do botão. Por exemplo, escreva "Copiar código" no botão de cupom.

  2. Se usar botão com link, confira o formato e, se for muito longo, encurte o link.

Situação 5: imagem incompatível no modelo

O que acontece: o modelo com imagem no cabeçalho não salva.

Por que acontece: a imagem precisa ser jpg, jpeg ou png com até 5 MB (vídeo mp4 ou 3gp até 16 MB).

Como resolver: redimensione ou comprima a imagem e tente de novo. Se continuar, teste com outra imagem para confirmar que o problema é o arquivo.

Situação 6: "não é possível adicionar conteúdo no mesmo idioma"

O que acontece: ao recriar um modelo aparece um erro indicando que a Meta está excluindo (ou já excluiu) o conteúdo em Português (BR) daquele modelo, e por isso não é possível adicionar um novo conteúdo no mesmo idioma.

Por que acontece: a Meta mantém um bloqueio temporário sobre aquele nome de modelo no mesmo idioma. O bloqueio é do par nome + idioma, não da sua conta.

Como resolver (não precisa esperar semanas):

  1. Copie e guarde o texto do modelo.

  2. Crie o modelo novamente com um nome diferente (por exemplo, troque bazar_setembro_26 por bazar_set_26).

  3. Cole o conteúdo e clique em Salvar e enviar para Meta. Depois de "Aprovado", o modelo já pode ser usado na campanha.

Situação 7: o erro persiste mesmo com tudo certo

Como resolver:

  1. Feche a criação do modelo e recarregue a página para atualizar os dados.

  2. Tente salvar novamente.

  3. Se o erro indicar que o modelo já existe, vá em Modelos de mensagem, clique em sincronizar modelos e verifique se ele já aparece.

Situação 8: erro de permissão na sua conta da Meta (BM)

O que acontece: o erro menciona permissões ou um objeto que não pode ser carregado.

Por que acontece: falta de permissão ou de acesso correto no Business Manager da Meta onde o número está configurado. Quando uma agência cuida da sua conta, isso costuma estar do lado dela.

Como resolver: verifique com quem administra a sua BM se o acesso está correto e ativo e se a conta tem permissão para gerenciar modelos. Se a mensagem for "Conta comercial do WhatsApp impedida de criar um novo modelo", veja Conta comercial do WhatsApp desabilitada pela Meta.

Dúvidas frequentes

O erro é da Martz ou da Meta?
Na maioria dos casos o erro vem da validação da Meta. Por isso o ajuste quase sempre é no conteúdo do modelo, seguindo as regras da Meta.

Posso usar emoji?
Sim, mas apenas no corpo da mensagem.

Dá para revisar o texto antes de enviar?
Sim. Use o botão Analisar com a Martz IA na etapa Conteúdo. Veja Analisar o modelo de WhatsApp com a Martz IA.

Ainda com problema?

Fale com o suporte pelo chat. Para agilizar, envie:

  • Um print da tela completa do modelo, mostrando o erro

  • O texto completo do modelo, com cabeçalho, corpo, rodapé e botões

  • Os exemplos preenchidos para cada variável

  • Se o número é gerenciado por você ou por uma agência

Respondeu à sua pergunta?