ConfiguraçõesIntegraçõesTemplates HSM

Templates HSM (WhatsApp)

Templates HSM são mensagens aprovadas pela Meta para iniciar conversa fora da janela de 24 horas — cobrança proativa, confirmação de visita, lembretes, campanhas. Sem um template aprovado, você não consegue escrever para um cliente que não te respondeu nas últimas 24h.

Onde fica

Menu Configuração › Integrações › Templates HSM — rota /config/integracoes/whatsapp-templates. Também aparece como a aba Templates do WhatsApp Cloud API. Criar e editar exige a permissão integracoes:edit.

Você cria e submete os templates aqui mesmo, pelo painel — não precisa montá-los no Business Manager. O painel envia para a Meta e recebe a aprovação por webhook.

A lista

No topo, os botões Sincronizar (puxa o status atual de todos os templates direto da Meta) e Novo template.

Cada template mostra o nome, o idioma, a categoria, um badge de status, o corpo e as variáveis ({{1}}, {{2}}…). Os status possíveis:

StatusSignifica
approvedAprovado — pode enviar
pendingEm análise pela Meta
rejectedRecusado (o motivo aparece)
paused / disabledPausado / desabilitado

Ações por template: Testar (só quando approved — pede um número de destino e os valores das variáveis, e envia de verdade), Editar e Excluir.

Criar e submeter um template

  1. Novo template. Um editor com preview ao vivo abre. Defina:

    • Nome (slug) (ex. boleto_atrasado_v1), Idioma (BCP47, ex. pt_BR) e Categoria: UTILITY (utilidade — aprova mais rápido, custa menos), MARKETING (promoção) ou AUTHENTICATION (códigos OTP).

  2. Cabeçalho (opcional). Nenhum, texto, ou mídia (imagem, vídeo, documento — o upload gera um identificador opaco que a Meta usa).

  3. Corpo. O texto da mensagem, com variáveis {{1}}, {{2}}… nos trechos que mudam a cada envio (nome, data, valor, link). Se houver variáveis, você precisa dar um exemplo para cada uma — é obrigatório para submeter.

  4. Rodapé (opcional, até 60 caracteres) e Botões (resposta rápida, link/URL etc.).

  5. Salvar ou submeter. Salvar rascunho guarda sem enviar. Submeter à Meta só habilita se a organização tem WhatsApp Cloud configurado e valida os exemplos antes. A aprovação chega depois, por webhook — acompanhe pelo badge de status (use Sincronizar se quiser forçar a atualização).

Se um template for rejeitado, o motivo da Meta aparece no topo do editor. Ajuste o texto e submeta de novo — o nome + idioma precisam bater exatamente com o que a Meta espera.

Boas práticas

  • Prefira UTILITY sempre que der — aprova mais rápido e custa menos.
  • Coloque as variáveis no fim da frase — facilita aprovação e leitura.
  • Não misture promoção com transacional no mesmo template.
  • Envie só para quem deu opt-in e permita opt-out — protege a qualidade do seu número, que define o limite diário de envios.

Onde os templates são usados

  • No atendimento — quando a conversa precisa reabrir fora das 24h.
  • Em campanhas — disparos para listas (cobrança, confirmação, satisfação).
  • Pela IA — automaticamente, quando ela precisa iniciar contato proativo.

Veja também

Servidores MCPStatus e diagnóstico