> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates de WhatsApp

> Mensagens reutilizáveis para WhatsApp com variáveis e mídia opcional

Os **Templates de WhatsApp** ficam em **Templates > Biblioteca**, na aba **WhatsApp**. São usados em:

* **Ficha do cliente** — botão **WhatsApp** para envio individual (ver [Clientes](/clients)).
* **Campanhas de WhatsApp** — envio em lote (ver [Campanhas](/campaigns)).

<Info>
  Para enviar você precisa de pelo menos uma conexão **WhatsApp** ativa em [Plugins](/plugins). A plataforma suporta **até 3 números** por organização e o envio é feito via **API não oficial**.
</Info>

## Criando um template

<Steps>
  <Step title="Abra a aba WhatsApp">
    Em **Templates > Biblioteca**, selecione **WhatsApp**.
  </Step>

  <Step title="Clique em Novo Template">
    Isso abre a tela de criação.
  </Step>

  <Step title="Preencha os campos">
    * **Nome** — identificador interno.
    * **Descrição** — texto curto para a equipe.
    * **Mensagem** — corpo da mensagem, com variáveis `{{chave}}`.
    * **Mídia (opcional)** — Imagem, Vídeo, Áudio ou Documento. Informe a **URL** da mídia e, quando for documento, o **nome do arquivo**.
  </Step>

  <Step title="Visualize e salve">
    O **Preview** mostra a mensagem em uma **moldura de celular** com valores de exemplo.
  </Step>
</Steps>

## Campos dinâmicos

A mensagem aceita todas as categorias de variáveis — **Do cliente**, **Customizado**, **Sistema** e **Manual**. Ver [Campos dinâmicos](/files).

Exemplo:

```
Olá {{cliente_nome}}, só confirmando a sua consulta em {{data_amanha}} às {{hora_consulta}}. 🩺
```

Aqui `{{hora_consulta}}` entra como **Manual** e precisa ser informada no envio.

## Mídia no template

| Tipo      | O que informar                               |
| --------- | -------------------------------------------- |
| Imagem    | URL pública do arquivo (jpg, png)            |
| Vídeo     | URL pública do arquivo (mp4)                 |
| Áudio     | URL pública do arquivo (mp3, ogg)            |
| Documento | URL do arquivo + nome de arquivo para exibir |

<Tip>
  Mídia é opcional. Muitos templates só precisam de texto com variáveis. Se usar mídia, confira no **Preview** se a URL está acessível.
</Tip>

## Lista de templates

A aba **WhatsApp** mostra:

| Coluna   | Descrição                |
| -------- | ------------------------ |
| Template | Nome                     |
| Mensagem | Prévia do texto          |
| Mídia    | Tipo, se houver          |
| Campos   | Quantidade de variáveis  |
| Criado   | Data de criação          |
| Ações    | Editar, Preview, Excluir |

## Envio pela ficha do cliente

No botão **WhatsApp** da ficha:

1. Escolha o **template**.
2. Escolha a **integração WhatsApp** (quando houver mais de uma).
3. Selecione o **telefone** do cliente.
4. Preencha variáveis **Manual** e confira o **Preview** em moldura de celular.
5. Envie.

O envio fica registrado em [Atividade](/activity) e na linha do tempo do cliente.

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte o WhatsApp (até 3 números)
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Dispare em lote com este template
  </Card>

  <Card title="Clientes" icon="users" href="/clients">
    Envie individualmente pela ficha do cliente
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Acompanhe status de envio
  </Card>
</CardGroup>