Passar para o conteúdo principal

Meu modelo de mensagem da API Oficial não salva ou não aparece: como resolver

O que fazer quando dá erro ao salvar um modelo de mensagem do WhatsApp API Oficial, quando o erro reclama de nome já usado ou fora do formato, ou quando o modelo aprovado pela Meta não aparece no painel.

Você está no lugar certo se:

  • Você tenta salvar um modelo de mensagem e aparece uma mensagem de erro, mesmo trocando o texto

  • Seu modelo já foi aprovado pela Meta, mas ele não aparece para selecionar na campanha

  • O erro fala que o nome do modelo já existe ou já foi usado

Visão geral

Os modelos de mensagem do WhatsApp API Oficial passam por aprovação da Meta antes de poderem ser usados. Na maior parte dos casos, quando o modelo não salva ou não aparece, a causa é uma regra simples da Meta ou uma sincronização que ainda não foi feita. Os cenários abaixo cobrem as situações mais comuns. Para erros ligados ao conteúdo (variáveis, exemplos, emoji, botões e imagem), veja Erro ao criar ou salvar um modelo de mensagem na API Oficial.

Situação 1: deu erro ao salvar e o aviso fala de nome já usado

O que acontece: ao clicar em Salvar e enviar para Meta, aparece uma mensagem de erro mesmo quando você muda o conteúdo da mensagem.

Por que acontece: não é possível ter dois modelos com o mesmo nome na loja (letras maiúsculas e minúsculas contam como iguais), e a Meta também não aceita repetir nomes. Se você já criou ou excluiu um modelo com aquele nome antes, o nome continua reservado e o novo é recusado.

Como resolver:

  1. Abra a criação do modelo novamente

  2. Troque o nome do modelo para um que você nunca usou antes

  3. Mantenha o mesmo conteúdo e salve de novo

Atenção: trocar apenas o texto da mensagem não resolve. O que precisa mudar é o nome do modelo.

Situação 2: o nome do modelo tem espaço, acento ou letra maiúscula

O que acontece: o modelo não avança ou é recusado logo na etapa de informações gerais.

Por que acontece: o nome do modelo só pode ter letras minúsculas, números e sublinhado (_). Espaços, acentos, hífens e outros caracteres não são aceitos.

Como resolver: use um nome como carrinho_abandonado_v2.

Situação 3: deu erro e o título do modelo tem variável no início ou no fim

O que acontece: o erro aparece ao salvar um modelo cujo título (cabeçalho) começa ou termina com a variável.

Por que acontece: a Meta não aceita variável como primeiro ou último elemento do texto, nem no título nem no corpo.

Como resolver: coloque texto fixo antes e depois da variável (ex.: "Pedido {{1}} confirmado") ou use um título só com texto. Lembre que o título tem no máximo 60 caracteres e não aceita emoji.

Situação 4: o modelo já foi aprovado, mas não aparece no painel

O que acontece: a Meta aprovou o modelo, mas ele não aparece na lista para você selecionar na campanha.

Por que acontece: quando o modelo é criado direto no Business Manager da Meta, ele pode ainda não ter sido sincronizado com o painel da Martz.

Como resolver:

  1. Acesse Configurações e depois WhatsApp

  2. Abra a aba Modelos de mensagem

  3. Clique em sincronizar modelos e aguarde a lista atualizar

  4. Se ainda assim não aparecer, crie o modelo direto no painel da Martz, com o mesmo conteúdo e um nome diferente

Dúvidas frequentes

Onde vejo meus modelos já salvos?
Em Configurações › WhatsApp › aba Modelos de mensagem. A lista mostra o status de cada modelo (Não enviado, Em análise, Aprovado, Rejeitado ou Excluindo) e permite buscar por nome e filtrar por tipo e categoria.

Quanto tempo a Meta leva para aprovar?
O tempo varia. Se o modelo estiver parado em análise por muitas horas, veja Meu modelo de mensagem está parado em análise.

Criei direto no Business Manager. Preciso fazer algo na Martz?
Sim. Use sincronizar modelos para o painel reconhecer o modelo aprovado na Meta.

Ainda com problema?

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

  • Um print da tela com a mensagem de erro completa

  • O nome exato do modelo que você está tentando salvar

  • Se o modelo foi criado no painel da Martz ou direto no Business Manager da Meta

  • O nome da sua loja

Respondeu à sua pergunta?