> ## 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 (visão geral)

> Templates de E-mail, Documentos, WhatsApp e SMS com campos dinâmicos reutilizáveis

O módulo **Templates** centraliza tudo que a sua organização **envia** ou **gera** para clientes: **templates** de mensagens e documentos, além da **Atividade** (histórico de envios e gerações). Acesse em **Templates** no menu lateral.

## O que você encontra em Templates

<CardGroup cols={2}>
  <Card title="Templates de E-mail" icon="envelope" href="/templates-email">
    Corpo HTML com variáveis, assunto e preview.
  </Card>

  <Card title="Templates de Documentos" icon="file-lines" href="/templates-documents">
    Gere PDFs, envie para WhatsApp ou mande para assinatura via ClickSign.
  </Card>

  <Card title="Templates de WhatsApp" icon="whatsapp" href="/templates-whatsapp">
    Mensagens com variáveis e mídia opcional (imagem, vídeo, áudio ou documento).
  </Card>

  <Card title="Templates de SMS" icon="message" href="/templates-sms">
    Texto simples com contagem de segmentos e limite de 1600 caracteres.
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Histórico consolidado de envios e gerações por canal.
  </Card>
</CardGroup>

## Página Biblioteca

Em **Templates > Biblioteca** você vê uma página única com abas **E-mail**, **Documentos**, **WhatsApp** e **SMS**. Cada aba mostra uma lista dos templates daquele canal, com ações: **abrir**, **editar**, **preview** e **excluir**.

O botão **Novo Template** abre o criador do canal selecionado na aba.

***

## Campos dinâmicos (variáveis)

Todos os templates usam a mesma notação: `{{chave}}`. No momento do envio ou da geração, a plataforma substitui cada variável por um valor, que pode vir de quatro origens diferentes, identificadas por um **badge**:

* **Do cliente** — dados da ficha do cliente no CRM.
* **Customizado** — campos customizáveis que a sua organização criou no CRM.
* **Sistema** — data, hora e derivados, resolvidos automaticamente.
* **Manual** — qualquer variável que não seja nenhuma das acima e precisa ser preenchida na hora do envio.

<Tip>
  Ao selecionar um template nas ações do cliente ou em uma campanha, a plataforma mostra a lista de variáveis e avisa quais precisam ser preenchidas ou estão faltando na ficha.
</Tip>

### Do cliente (ficha do CRM)

Puxados automaticamente da [ficha do cliente](/clients).

| Variável               | Descrição                              |
| ---------------------- | -------------------------------------- |
| `{{cliente_nome}}`     | Nome do cliente                        |
| `{{cliente_empresa}}`  | Empresa                                |
| `{{cliente_email}}`    | E-mail principal (primeiro cadastrado) |
| `{{cliente_telefone}}` | Telefone principal                     |
| `{{cliente_codigo}}`   | Código do cliente                      |
| `{{cliente_tags}}`     | Tags (lista separada por vírgula)      |

### Customizado (campos do CRM criados pela sua organização)

Use `cliente_<nome_do_campo>`. O nome é gerado a partir do **label** do campo customizado cadastrado no CRM. Exemplos:

| Variável                      | Exemplo de label no CRM |
| ----------------------------- | ----------------------- |
| `{{cliente_cpf}}`             | CPF                     |
| `{{cliente_cnpj}}`            | CNPJ                    |
| `{{cliente_endereco}}`        | Endereço                |
| `{{cliente_numero_contrato}}` | Número do contrato      |

<Info>
  Campos customizáveis aparecem com o badge **Customizado**. Se o campo não existir na ficha daquele cliente, a plataforma avisa e a variável entra como pendente.
</Info>

### Sistema (preenchidos automaticamente)

Não precisa preencher nada — o valor é o do momento do envio/geração.

| Variável          | Descrição                      |
| ----------------- | ------------------------------ |
| `{{data_atual}}`  | Data atual (dd/mm/aaaa)        |
| `{{data_ontem}}`  | Data de ontem                  |
| `{{data_amanha}}` | Data de amanhã                 |
| `{{hora_atual}}`  | Hora atual (hh:mm)             |
| `{{dia_atual}}`   | Dia do mês                     |
| `{{mes_atual}}`   | Mês por extenso (em português) |
| `{{ano_atual}}`   | Ano atual                      |

### Manual (preenchido no envio/geração)

Qualquer `{{chave}}` que não esteja nas categorias acima entra como **Manual**. Esses campos aparecem como uma pergunta extra quando você está **enviando um e-mail/SMS/WhatsApp** ou **gerando um documento** na ficha do cliente, ou quando sobe em lote por uma campanha.

Use Manual para dados que variam em cada envio e não valem a pena virar campo customizado do CRM — por exemplo, um `{{assunto_reuniao}}` ou `{{numero_protocolo}}` específico daquela interação.

***

## Preview e histórico

* **Preview** — botão disponível em cada template e também durante os fluxos de envio/geração; mostra como o conteúdo final vai chegar ao destinatário.
* **Histórico de envios / gerações** — centralizado em [Atividade](/activity), com abas por canal (E-mail, WhatsApp, SMS, Documentos) e busca por destinatário, conteúdo ou template.
* Em **Templates de Documentos**, a lista também exibe a coluna **Gerações** com a contagem de documentos gerados a partir daquele template.

***

## Onde os templates são usados

* **Ficha do cliente** — ações **E-mail**, **SMS**, **WhatsApp** e **Gerar documento** (ver [Clientes](/clients)).
* **Campanhas** — canais E-mail, SMS e WhatsApp exigem um **template ativo** (ver [Campanhas](/campaigns)).
* **Atividade** — todos os envios e gerações feitos a partir de templates aparecem no histórico central.

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Templates de E-mail" icon="envelope" href="/templates-email">
    Criação, variáveis, preview
  </Card>

  <Card title="Templates de Documentos" icon="file-lines" href="/templates-documents">
    HTML, campos, gerações e assinatura
  </Card>

  <Card title="Templates de WhatsApp" icon="whatsapp" href="/templates-whatsapp">
    Mensagens com mídia opcional
  </Card>

  <Card title="Templates de SMS" icon="message" href="/templates-sms">
    Texto simples com contagem de segmentos
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Histórico consolidado por canal
  </Card>

  <Card title="Plugins" icon="plug" href="/plugins">
    Conexões que habilitam o envio (Gmail, Twilio, WhatsApp, ClickSign)
  </Card>
</CardGroup>