Visão geral
Os templates HSM (Highly Structured Messages) são modelos de mensagem do WhatsApp aprovados pela Meta. Eles são obrigatórios para iniciar uma conversa fora da janela de 24 horas — por exemplo, em uma campanha para uma lista de contatos.
Muitos templates têm variáveis (marcadores no formato {{1}}, {{2}} ou nomeados como
{{nome}}) que são preenchidas com dados de cada contato. Na ConversaLabs, você preenche essas
variáveis com o seletor de variáveis ({{var}}), e o valor é resolvido para cada destinatário no
momento do envio.
Pré-requisitos
- Uma caixa de entrada de WhatsApp conectada.
- Templates HSM aprovados na caixa de entrada (a aprovação é feita junto à Meta).
- Contatos com os dados que você pretende usar nas variáveis (por exemplo, nome).
Passo a passo
- Em uma campanha de WhatsApp (ou ao enviar uma mensagem que exige template), selecione a caixa de entrada e escolha o template.
- Selecione o idioma do template (e confira a categoria, definida na aprovação).
- Se o template tiver um cabeçalho de mídia, selecione a imagem, o vídeo ou o documento que será enviado. A plataforma guarda esse arquivo no histórico da conversa, inclusive quando o WhatsApp usa uma referência temporária de mídia para fazer o envio.
- Para cada variável do template, informe o valor:
- digite um texto fixo; ou
- use o seletor de variáveis (
{{var}}) para inserir um campo dinâmico (como o nome do contato), que será substituído por destinatário.
- Revise a pré-visualização do template já com os valores preenchidos.
- Conclua o envio (ou agende a campanha). A plataforma resolve as variáveis por contato no momento do disparo.
Configurações & opções
- Template: o modelo aprovado que será enviado.
- Idioma: a versão de idioma do template.
- Categoria: a finalidade do template, definida na aprovação (por exemplo, marketing ou utilidade).
- Variáveis: os marcadores
{{...}}do template, preenchidos com texto fixo ou com o seletor de variáveis. - Cabeçalho de mídia: a imagem, o vídeo ou o documento específico daquele envio. O arquivo exibido no histórico corresponde ao que foi enviado, e não à mídia de exemplo usada na aprovação do template.
- Seletor de variáveis ({{var}}): insere campos dinâmicos (contato, conta etc.) que são resolvidos individualmente para cada destinatário.
- Pré-visualização: mostra como a mensagem ficará com os valores aplicados.
Casos de uso
- Personalizar a saudação com o nome do contato em um disparo em massa.
- Enviar um código ou link específico por contato dentro de um template.
- Reaproveitar o mesmo template em várias campanhas, mudando apenas os valores das variáveis.
Dicas, limites e boas práticas
- Preencha todas as variáveis do template — campos vazios podem impedir o envio para aquele contato.
- Use variáveis dinâmicas com dados confiáveis; se um contato não tiver o dado, prefira um valor fixo de reserva para não deixar a mensagem incompleta.
- Lembre-se de que o conteúdo do template é fixo (aprovado pela Meta) — você altera apenas os valores das variáveis, não o texto do modelo.
- As variáveis são resolvidas no servidor, por destinatário — você não precisa montar uma mensagem diferente para cada contato.
Solução de problemas
- O template não aparece: confirme que ele está aprovado e na caixa de entrada correta.
- O envio falha para alguns contatos: verifique se alguma variável ficou sem valor para esses contatos.
- O nome (ou outro dado) não aparece: confirme que o campo existe no contato e que a variável certa foi selecionada no seletor.
- O cabeçalho aparece sem mídia: confirme que o arquivo foi selecionado antes do envio e que o formato corresponde ao cabeçalho aprovado. A plataforma não substitui um arquivo desconhecido pela mídia de exemplo da Meta.