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

> Monte e-mails reutilizáveis com corpo HTML, assunto e campos dinâmicos

Os **Templates de E-mail** ficam em **Templates > Biblioteca**, na aba **E-mail**. Eles são usados em:

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

<Info>
  Para disparar os e-mails você precisa ter uma conexão **Gmail** ativa em [Plugins](/plugins). O template em si pode ser criado a qualquer momento.
</Info>

## Criando um template

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

  <Step title="Clique em Novo Template">
    Você vai para a tela **Novo template de e-mail**.
  </Step>

  <Step title="Preencha os campos">
    * **Nome** — identificador interno (ex: `boas-vindas`).
    * **Descrição** — texto curto para ajudar a equipe.
    * **Assunto** — pode usar variáveis (ex: `Olá {{cliente_nome}}, seu pedido está pronto`).
    * **Corpo** — editor HTML com variáveis `{{chave}}`.
  </Step>

  <Step title="Visualize e salve">
    Use o **Preview** para validar e depois clique em salvar.
  </Step>
</Steps>

<Tip>
  Use o painel de variáveis do editor para inserir `{{cliente_nome}}`, `{{data_atual}}` e demais campos com um clique. Veja o catálogo completo em [Campos dinâmicos](/files).
</Tip>

## Campos dinâmicos

Assunto e corpo aceitam as mesmas variáveis de todos os templates — **Do cliente**, **Customizado**, **Sistema** e **Manual**. Consulte a [lista completa em Templates](/files).

Exemplo de corpo:

```html theme={null}
<p>Olá {{cliente_nome}},</p>
<p>Confirmamos o agendamento para {{data_amanha}} às {{hora_agendada}}.</p>
<p>Qualquer dúvida, estamos à disposição.</p>
```

Nesse exemplo:

* `{{cliente_nome}}` vem da ficha (**Do cliente**).
* `{{data_amanha}}` é resolvido automaticamente (**Sistema**).
* `{{hora_agendada}}` será pedido como **Manual** no envio.

## Preview

O botão **Preview** abre um diálogo que mostra:

* **Nome** e **Assunto** do template.
* **Descrição**, **Campos** detectados e **Data de criação**.
* Corpo renderizado em um iframe, exatamente como o destinatário verá.

Durante o envio ou na campanha, a plataforma também mostra o preview com os valores resolvidos.

## Lista de templates

A aba **E-mail** mostra as colunas:

| Coluna    | Descrição                      |
| --------- | ------------------------------ |
| Template  | Nome do template               |
| Assunto   | Assunto configurado            |
| Descrição | Texto auxiliar                 |
| Campos    | Quantidade de variáveis usadas |
| Criado    | Data de criação                |
| Ações     | Editar, Preview, Excluir       |

## Uso fora da página de templates

* **Ficha do cliente > E-mail** — escolha o template, preencha variáveis **Manual**, confira o preview e envie. Exige Gmail conectado.
* **Campanhas de E-mail** — a etapa **Template** pede um template **ativo**; destinatários sem dados para variáveis são **pulados**.

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte o Gmail para habilitar envios
  </Card>

  <Card title="Campos dinâmicos" icon="code" href="/files">
    Veja o catálogo completo de variáveis
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Use o template em campanhas em lote
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Acompanhe os envios feitos
  </Card>
</CardGroup>