Templates HSM no WhatsApp Cloud API
Quando você utiliza a integração oficial da Meta (WhatsApp Cloud API), existe uma regra importante: não é possível enviar mensagens livres fora da janela de 24 horas.
Nesses casos, você precisa usar templates HSM (Highly Structured Messages), que são mensagens previamente aprovadas pela Meta.
Para que servem os templates HSM
Os templates são usados principalmente para:
Iniciar conversas com leads que ainda não responderam
Retomar contato com clientes após inatividade
Enviar lembretes e notificações automáticas
Disparar códigos de verificação
Confirmar pedidos, consultas ou agendamentos
Quando os templates são obrigatórios
Os templates são obrigatórios quando:
O cliente não respondeu nas últimas 24 horas
A conversa está fora da janela de atendimento
Você está usando WhatsApp Cloud API
Se você utiliza conexão via QR Code (WAHA), essa regra não se aplica.
Pré-requisitos
Para utilizar templates HSM, você precisa:
Ter pelo menos um número conectado via Cloud API
Ter permissão de admin ou manager
Ter a funcionalidade habilitada na conta
Categorias de templates
A Meta classifica os templates em três categorias principais.
Marketing: usado para promoções, campanhas e ofertas comerciais. Possui critérios de aprovação mais rígidos.
Utilidade: usado para confirmações, lembretes e atualizações. Geralmente tem aprovação mais rápida.
Autenticação: usado para envio de códigos de verificação (OTP). Possui formato mais restrito.
A Meta pode alterar automaticamente a categoria do seu template durante a análise.
Como criar um template HSM
Acesse Configurações → Templates WhatsApp.
Clique em Criar template.
Preencha as informações básicas:
Nome do template (sem espaços ou acentos)
Idioma
Categoria
Escreva o conteúdo da mensagem.
Utilize variáveis como:
{{1}},{{2}},{{3}}
Preencha exemplos para cada variável.
Opcionalmente, adicione:
Cabeçalho com mídia ou texto
Rodapé
Botões de ação
Revise o conteúdo.
Clique em Enviar para análise da Meta.
Após o envio, o template será analisado.
Como funciona a aprovação
Depois de enviado, o template pode ter três status.
Em análise: ainda não revisado pela Meta.
Aprovado: pronto para uso.
Rejeitado: precisa ser ajustado e reenviado.
O tempo de análise geralmente varia entre 24 e 72 horas.
Como sincronizar templates com a Meta
O Syncro sincroniza automaticamente os templates uma vez por dia.
Se quiser atualizar manualmente:
Acesse Configurações → Templates WhatsApp.
Clique em Sincronizar com Meta.
Aguarde a atualização dos status.
Como enviar um template
Depois que o template estiver aprovado:
Acesse o Chat.
Abra a conversa desejada.
Clique em Enviar template se a janela estiver fechada.
Ou clique no botão de ações e selecione Template.
Escolha o template desejado.
Preencha as variáveis.
Anexe mídia, se necessário.
Clique em Enviar.
A mensagem será enviada como template oficial da Meta.
Por que um template pode ser rejeitado
Alguns motivos comuns de rejeição incluem:
Conteúdo promocional inadequado
Variáveis mal estruturadas
Linguagem vaga ou considerada spam
Erros de escrita ou excesso de caracteres especiais
Se um template for rejeitado:
Ajuste o conteúdo com base no motivo
Crie um novo template
Envie novamente para análise
Custos de envio
O envio de templates é cobrado pela Meta, não pelo Syncro.
O valor varia conforme:
Categoria do template
País do destinatário
Tipo de conversa
A cobrança é feita diretamente na sua conta do WhatsApp Business.
Boas práticas
Crie templates com antecedência para não travar operações importantes.
Use linguagem clara, objetiva e sem exageros promocionais.
Preencha corretamente os exemplos das variáveis.
Evite usar muitas variáveis desnecessárias.
Revise ortografia e clareza antes de enviar para análise.
Conclusão
Os templates HSM são essenciais para operações que utilizam WhatsApp Cloud API.
Eles permitem manter a comunicação ativa mesmo fora da janela de 24 horas, garantindo conformidade com as regras da Meta e continuidade no relacionamento com o cliente.