ConfiguraçõesLojaTemplates 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 Loja › 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, sem precisar montá-los no Business Manager. O painel envia para a Meta e recebe a aprovação por webhook.

A lista

A aba abre com uma frase que conta os templates e os aprovados e diz, quando há, quantos foram recusados, estão pausados ou estão em análise. Logo abaixo, os botões Novo template e Sincronizar com a Meta (puxa o estado atual de todos os templates direto da Meta).

Os templates vêm agrupados por número. Cada linha mostra o nome, o corpo, a categoria e o idioma, quantas variáveis ele tem ({{1}}, {{2}}…) e o estado em palavra:

EstadoSignifica
AprovadoPode enviar
Em análiseA Meta ainda está avaliando
RecusadoA Meta recusou (o motivo aparece)
Pausado / DesativadoA Meta pausou ou desativou, e ele não é enviado

Recusado e pausado ganham uma barra âmbar na margem da linha: pedem revisão.

Clique na linha para abrir o painel do template, com o que o estado quer dizer (e o motivo da recusa, quando houver), a prévia de como ele chega ao cliente e as ações Editar e Excluir. Excluir pede confirmação na própria tela. Em template aprovado, o painel também tem Enviar um teste: você informa o número que recebe e o valor de cada variável. O teste é uma mensagem de verdade, e a Meta cobra por ela como por qualquer template.

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 estado na lista (use Sincronizar com a Meta 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: pela tabela da Meta, UTILITY sai a R$ 0,035 por mensagem entregue contra R$ 0,3217 do MARKETING, cerca de 9× mais caro. Veja o custo por mensagem.
  • 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. Isso 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

Conexões com assistentesStatus e diagnóstico