Templates da Meta na prática: aprovação, variáveis e erros comuns

Se você usa a API oficial (Cloud API), já sabe pelo artigo da janela de 24 horas: fora da janela, só template aprovado pela Meta. Este artigo é o manual de operação da tela Configurações → Templates — onde os templates moram, como as variáveis funcionam de verdade e por que às vezes um envio é bloqueado antes de sair (e isso é bom).

A tela de templates

• Cada template aparece como um card com prévia e status: Aprovado, Em análise, Rejeitado (com o motivo da Meta escrito no card), Pausado ou Desativado.
• Categorias: Utilidade (transacional: pedido, boleto, aviso), Marketing (promoção — custa mais caro por conversa) e Autenticação (códigos).
• O botão "Sincronizar" puxa da Meta o estado atual de tudo — status muda lá, reflete aqui. Mudanças de status também chegam automaticamente via webhook.
• Dá pra criar e submeter templates de texto e botões direto da plataforma; template com mídia no cabeçalho (imagem, vídeo, PDF) precisa ser criado no Meta Business Manager por enquanto.

Variáveis: como o {{1}} vira o nome do cliente

No template aprovado, as variáveis são numeradas: "Oi {{1}}, seu pedido {{2}} foi aprovado". Na plataforma, você mapeia cada posição pra um dado real: {{1}} → primeiro_nome, {{2}} → um campo personalizado com o número do pedido. O mapeamento cobre corpo, cabeçalho de texto e até botões com link dinâmico. E tem validação dupla: o mapeamento não salva enquanto alguma variável ficar sem dado atribuído — e, no disparo, se o contato não tiver o valor, o envio é bloqueado mostrando exatamente qual variável faltou. Melhor uma mensagem retida com motivo do que uma entregue com buraco no texto.

Detalhes que salvam sua pele

• Quebras de linha e tabs no valor de uma variável são convertidos em espaço automaticamente — a Meta rejeita quebras dentro de parâmetro.
• Valor com mais de 1024 caracteres bloqueia o envio (truncar corromperia link ou valor).
• Botão de resposta rápida (quick reply) reabre a janela de 24h quando o lead toca nele; botão de URL ou telefone NÃO reabre — o lead sai da conversa sem gerar mensagem.
• Template apagado direto na Meta é detectado na sincronização e marcado como indisponível aqui — a plataforma para de tentar enviá-lo em vez de acumular falha.

Dica de operador: em template de abertura, termine com pergunta + botão de resposta rápida ("Quer ver as condições? [Sim, quero]"). Um toque do lead reabre a janela de 24h e libera a conversa livre — sem isso, cada resposta sua continua presa a template.

Problemas comuns

• Rejeitado — leia o motivo no card. Causas clássicas: cara de promoção agressiva em categoria Utilidade, variável colada em variável, link encurtado. Corrija e submeta de novo.
• Pausado do nada — a Meta pausa template com muita denúncia/bloqueio. Reveja o texto e a frequência antes de insistir.
• "Envio bloqueado: variável faltando" — o contato não tem o dado mapeado (ex: sem primeiro nome e sem nome completo). Complete o cadastro ou mapeie pra outro campo.
• Submeti e não aparece aprovado — análise da Meta leva de minutos a 24h; o card fica "Em análise" e atualiza sozinho.