Skip to main content
Um template da Meta é uma mensagem pré-aprovada pela Meta, com categoria, variáveis e, se quiser, mídia e botões. Na conexão oficial, é o único jeito de falar com um lead fora da janela de 24h. Follow-up, campanhas, mensagens agendadas e o envio de template pela API usam templates. A Zatten cria o template no painel, envia para a Meta aprovar e acompanha o status sozinha. Só template aprovado é enviado.

​
Onde fica no painel

Menu WhatsApp, aba Templates (admin, editor e gestor). A lista mostra nome, categoria, idioma e status, com os botões Sincronizar, editar e excluir. Na conexão não oficial (QR Code), a mesma aba tem outro tipo de template: texto salvo no painel, com variáveis, sem aprovação e sem categoria, mídia ou botões. Esta página trata dos templates da Meta. Veja WhatsApp não oficial.

​
Como configurar

​
Campos

O botão Copiar Código pede um código de exemplo. A categoria Autenticação não é criada pelo painel; se ela existir na conta (criada fora da Zatten), aparece na lista depois de sincronizar.

​
Variáveis

A Zatten usa variáveis nomeadas: {{nome}}, {{cidade}}, nunca {{1}}. Na hora do envio, cada variável é preenchida com dados do lead: Se o lead tiver uma propriedade com o slug data ou hora, o valor dela vale no lugar da data e da hora do envio. Cliente final em outro fuso: o template mostra a hora de Brasília; escreva isso no texto (por exemplo, “14:30, horário de Brasília”). Se o template pede uma variável que não existe no projeto, o painel avisa ao escolher o template e oferece criar a propriedade com aquele slug.

​
Status

O status, a categoria e a qualidade são atualizados sozinhos quando a Meta avisa a mudança. Não é preciso sincronizar para ver uma aprovação.

​
Como funciona por trás

Criar envia o template para a Meta na hora. Ele aparece como Pendente até a Meta decidir. Editar só é possível em template Aprovado, Rejeitado ou pausado pela Meta. A edição volta para revisão. Nome e idioma não mudam; para isso, crie outro template. Excluir apaga na Meta pelo nome: todos os idiomas daquele nome somem, e somem da conta do WhatsApp inteira, não só deste projeto. Não pode ser desfeito. Sincronizar faz três coisas:
  1. Envia à Meta os templates em Sincronização pendente.
  2. Se um template pendente já existe na conta do WhatsApp com o mesmo nome e idioma, adota o que existe em vez de criar outro (comum ao duplicar um projeto para um número que já tinha os templates).
  3. Traz para a lista templates criados direto na Meta.
Depois de sincronizar, follow-ups que esperavam um template pendente são ligados a ele. Por que a mídia fica guardada na Zatten. A Meta devolve a mídia do cabeçalho como um endereço que expira. Por isso, o arquivo que você sobe no painel fica guardado pela Zatten, num endereço que não expira, e é reenviado à Meta a cada envio. Template criado fora da Zatten (no gerenciador da Meta) chega com o endereço da Meta e, quando ele expira, o envio falha: edite o template no painel e suba a mídia de novo. Envio. Antes de enviar, a Zatten confere se o template está aprovado e preenche as variáveis. Se faltar o valor de alguma variável no lead, o envio não acontece (a mensagem não sai pela metade).

​
Pelo MCP

O bloco meta_templates do template do projeto só é lido. get_template traz todos os templates da Meta do projeto, com categoria, idioma, componentes e formato. Na escrita, nada é criado nem alterado:
  • template que já existe nunca é atualizado: o estado é da Meta;
  • template que falta não é enviado à Meta. A resposta traz uma nota listando quais faltam. O envio é feito por uma pessoa, no painel (criando o template ou usando Sincronizar depois de importar um projeto).
Ao aplicar um template de projeto pelo painel (importar JSON ou duplicar), os templates entram como Sincronização pendente. Clique em Sincronizar em WhatsApp → Templates para enviá-los à Meta.

​
Armadilhas

  • Variável sem valor no lead = envio falha. Uma campanha ou envio pelo chat com {{cidade}} não sai para quem não tem a propriedade preenchida. Use variáveis que todo lead tem, ou filtre (na campanha, pelas propriedades).
  • Follow-up na conexão oficial só preenche nome, telefone, data e hora. Template com variável de propriedade não serve para follow-up. Veja Follow-up.
  • Propriedade de vínculo conversa some ao encerrar. Template que usa essa propriedade falha depois do encerramento.
  • Utilitário com conteúdo promocional vira Marketing. A Meta aprova como Marketing (mais caro) ou rejeita por categoria incorreta. Mensagem mista (aviso de pedido com cupom) é Marketing.
  • Excluir apaga todos os idiomas e em toda a conta. Se dois projetos usam o mesmo número ou a mesma conta do WhatsApp, excluir num afeta o outro.
  • Template pausado aparece como Pendente. Se um template que funcionava parou de sair, confira a qualidade e o status no gerenciador da Meta.
  • Mídia de template criado fora da Zatten expira. Edite e suba o arquivo no painel antes de usar em campanha ou follow-up.
  • Nome e idioma não mudam. Errou? Crie outro e exclua o antigo.
  • Cada envio é cobrado pela Meta conforme a categoria. Veja Quanto custa operar um projeto.

​
Perguntas frequentes

Segundo a Meta, até 24 horas. A lista atualiza sozinha quando a decisão chega.
Clique em Sincronizar. Se ele tiver mídia no cabeçalho, edite e suba o arquivo pelo painel para o endereço não expirar.
Não. A Zatten não usa {{1}}, {{2}}: cria templates com variáveis nomeadas, preenchidas pelos dados do lead. Use {{nome}} ou o slug de uma propriedade.
Não. O assistente pode redigir o texto, a categoria e as variáveis; quem cria e envia para aprovação é uma pessoa, no painel.

​
Vídeo

O vídeo pode mostrar uma versão anterior da tela. Quando houver diferença, vale o texto desta página.

​
Para saber mais