Templates HSM do WhatsApp: aprovação Meta e variáveis dinâmicas

HSM significa Highly Structured Message e é o formato exigido pela Meta sempre que sua empresa precisa iniciar uma conversa com um cliente no WhatsApp Business — ou retomá-la após 24 horas sem interação. Sem template aprovado, o envio é simplesmente bloqueado pela API.

Este artigo é um deep-dive em templates. Para o passo a passo de conectar WhatsApp, veja Conectar WhatsApp Cloud API ou WhatsApp Business via dispositivo pareado.

Por que os templates existem

A Meta criou a regra para proteger usuários de spam. A lógica é:

• Dentro da janela de 24h após a última mensagem do cliente, você pode mandar qualquer texto livre.
• Fora da janela de 24h, ou para iniciar uma conversa nova, você só pode usar conteúdo previamente aprovado pela Meta.

Isso garante que mensagens proativas tenham contexto claro (lembretes, atualizações, notificações) e não sejam usadas para divulgação massiva sem consentimento.

Categorias de template

Ao submeter, você precisa escolher uma das três categorias:

A Meta reanalisa periodicamente templates aprovados e pode reclassificar um "Utility" para "Marketing" se o conteúdo parecer promocional. Isso muda o custo retroativamente.

Variáveis dinâmicas

Templates aceitam placeholders numerados no formato {{1}}, {{2}}, {{3}}, substituídos no momento do envio. Exemplo:

Olá {{1}}, seu pedido #{{2}} foi confirmado e será entregue até {{3}}.
Acompanhe pelo link: {{4}}

No momento do disparo, você passa os valores:

{
  "template": "confirmacao_pedido",
  "language": "pt_BR",
  "components": [{
    "type": "body",
    "parameters": [
      { "type": "text", "text": "Maria" },
      { "type": "text", "text": "84291" },
      { "type": "text", "text": "29/04 às 14h" },
      { "type": "text", "text": "https://exemplo.com/p/84291" }
    ]
  }]
}

A Meta exige que cada variável tenha um exemplo concreto no momento da submissão — não pode submeter {{1}} solto, precisa fornecer "Maria" como exemplo.

Submetendo um template

No painel SiteUp, vá em Configurações → Caixas de entrada → [seu WhatsApp] → Templates → Novo template:

1. Nome técnico: apenas letras minúsculas, números e underscore (ex: confirmacao_pedido)
2. Idioma: pt_BR para português brasileiro
3. Categoria: Utility, Authentication ou Marketing
4. Cabeçalho (opcional): texto fixo, imagem, vídeo ou documento
5. Corpo: texto principal, com variáveis numeradas
6. Rodapé (opcional): linha curta de assinatura
7. Botões (opcional): até 3 botões de resposta rápida ou 2 de URL/telefone

Ao salvar, o template é submetido à Meta. A análise leva tipicamente de 1 minuto a 24 horas.

Motivos comuns de rejeição

A Meta rejeita por critérios automatizados e manuais. Os mais frequentes:

• Linguagem promocional em categoria Utility ("aproveite", "última chance", "desconto")
• Variáveis sem contexto (corpo termina com {{1}}. sem explicar o que é)
• Erros de português (sim, eles checam)
• URLs encurtadas (bit.ly, tinyurl) — sempre use seu próprio domínio
• Conteúdo repetido entre cabeçalho e corpo
• Promessas vagas sem detalhes ("Notícia importante para você")

Se o template for rejeitado, ajuste e ressubmeta — não há limite, mas histórico recorrente de rejeição pesa na reputação da conta.

Boas práticas

Trate variáveis como obrigatórias. Se {{2}} for opcional no seu fluxo, crie dois templates diferentes em vez de mandar valor vazio (a Meta rejeita parâmetro vazio).

Use cabeçalho com mídia para campanhas. Imagens aumentam taxa de leitura, mas exigem upload prévio do asset.

Não confunda template com mensagem livre. Quando o cliente responder, você entra na janela de 24h e pode mandar texto livre — não precisa nem deve usar template ali.

Versione com sufixos. Se vai testar variações, nomeie confirmacao_pedido_v1, confirmacao_pedido_v2, em vez de sobrescrever o aprovado.

Monitoramento de qualidade

A Meta atribui um rating de qualidade (Verde, Amarelo, Vermelho) a cada template aprovado, baseado em bloqueios e marcações como spam pelos destinatários. Templates em vermelho podem ser pausados automaticamente. Acompanhe em Relatórios → WhatsApp → Templates dentro do SiteUp e refaça templates que entrarem em zona amarela antes que sejam bloqueados.