## 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

1. Em uma **campanha de WhatsApp** (ou ao enviar uma mensagem que exige template), selecione a
   **caixa de entrada** e escolha o **template**.
2. Selecione o **idioma** do template (e confira a **categoria**, definida na aprovação).
3. 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.
4. Revise a **pré-visualização** do template já com os valores preenchidos.
5. 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.
- **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.

## Veja também

- [Campanha de WhatsApp para listas de contatos](/hc/ajuda/articles/campaigns-whatsapp-campaign-pt-br)
- [Visão geral de Campanhas](/hc/ajuda/articles/campaigns-overview-pt-br)
- [Campanhas no site](/hc/ajuda/articles/campaigns-campanhas-site-pt-br)