<!-- Fonte: https://help.conectaai.io/configuracoes/integracoes/templates-hsm · conecta/ai Central de Ajuda -->
> Crie templates de WhatsApp, submeta à Meta pelo painel e acompanhe a aprovação — variáveis, botões, cabeçalho e a sincronização de status.

# 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](/configuracoes/integracoes/whatsapp-cloud). Criar e editar exige a permissão **`integracoes:edit`**.

> **Nota.**
> 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:

| Status | Significa |
|--------|-----------|
| **approved** | Aprovado — pode enviar |
| **pending** | Em análise pela Meta |
| **rejected** | Recusado (o motivo aparece) |
| **paused** / **disabled** | Pausado / 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).

> **Atençã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](/configuracoes/integracoes/whatsapp-cloud).

## Onde os templates são usados

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

## Veja também

- [WhatsApp Cloud API](/configuracoes/integracoes/whatsapp-cloud) — qualidade e tier do número
- [Campanhas](/operacoes/campanhas)
- [Status e diagnóstico](/configuracoes/integracoes/status)