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

> Gere PDFs personalizados e envie para WhatsApp ou assinatura via ClickSign

Os **Templates de Documentos** ficam em **Templates > Biblioteca**, na aba **Documentos**. Eles transformam um **corpo HTML** em um **PDF final** com os dados do cliente preenchidos, pronto para:

* **Baixar** na hora.
* **Enviar por WhatsApp** diretamente da ficha do cliente.
* **Enviar para assinatura** via **ClickSign**.

## Criando um template

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

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

  <Step title="Preencha os dados">
    * **Nome** — identificador interno.
    * **Descrição** — texto curto para a equipe.
    * **Conteúdo (HTML)** — modelo do documento, com variáveis `{{chave}}`.
    * **Campos do template** — definição dos campos que o usuário preenche na geração (label, obrigatoriedade, tipo).
  </Step>

  <Step title="Visualize e salve">
    O **Preview** mostra o documento com valores de exemplo.
  </Step>
</Steps>

<Tip>
  Os **Campos do template** são o que aparecem como perguntas quando alguém usa **Gerar documento** na ficha do cliente. Marque como obrigatório tudo que não pode faltar no PDF.
</Tip>

## Campos dinâmicos

O conteúdo HTML aceita todas as categorias descritas em [Templates](/files):

* **Do cliente** — nome, empresa, telefone, e-mail, código, tags.
* **Customizado** — CPF, CNPJ, endereço e outros campos do CRM.
* **Sistema** — datas e horários.
* **Manual** — campos preenchidos no momento da geração.

## Preview

O botão **Preview** mostra o HTML renderizado com valores de exemplo. Alguns formatos de documento podem aparecer como **Preview indisponível** — nesse caso, gere um documento de teste na ficha de um cliente para validar.

## Lista de templates

A aba **Documentos** mostra:

| Coluna       | Descrição                                           |
| ------------ | --------------------------------------------------- |
| Template     | Nome                                                |
| Descrição    | Texto auxiliar                                      |
| Campos       | Quantidade de variáveis/campos                      |
| **Gerações** | Total de documentos gerados a partir desse template |
| Criado       | Data de criação                                     |
| Ações        | Editar, Preview, Excluir                            |

## Gerando um documento pela ficha do cliente

<Steps>
  <Step title="Abra o cliente">
    Em **CRM > Clientes**, selecione o cliente desejado.
  </Step>

  <Step title="Clique em Gerar documento">
    Escolha o template na lista.
  </Step>

  <Step title="Preencha os campos">
    Cada campo exibe um **badge** indicando a origem: **Do cliente**, **Sistema**, **Customizado** ou **Manual**. Campos obrigatórios são marcados. A plataforma mostra a contagem **Campos preenchidos: X de Y**.
  </Step>

  <Step title="Confira e decida o destino">
    Antes de gerar, escolha entre as abas **Baixar**, **WhatsApp** ou **Assinatura**.
  </Step>

  <Step title="Gere">
    O PDF é criado. Dependendo da aba escolhida, a plataforma também envia ou abre a próxima etapa.
  </Step>
</Steps>

### Aba Baixar

Gera o PDF e baixa no navegador. A ação fica registrada em [Atividade](/activity).

### Aba WhatsApp

Envia o PDF pelo WhatsApp do cliente. Exige uma conexão **WhatsApp** ativa em [Plugins](/plugins). Você escolhe a **integração**, o **telefone de destino** e uma **legenda** opcional.

### Aba Assinatura (ClickSign)

Envia o documento para assinatura digital via ClickSign. Requer conexão **ClickSign** ativa em [Plugins](/plugins). Você configura:

* **Signatários do cliente** — e-mails cadastrados na ficha (checkboxes).
* **Signatários adicionais** — insira nome completo e e-mail avulsos.
* **Signatários da empresa** — usa os signatários padrão cadastrados no ClickSign em **Plugins**.
* **Ordem** — **sequencial** (um de cada vez) ou **paralela** (todos ao mesmo tempo).

Ao enviar, você recebe a confirmação **"Documento enviado para assinatura!"**. O status da assinatura aparece na [Atividade](/activity) e também na **linha do tempo** do cliente como **Documento p/ assinatura** e, depois, **Documento assinado**.

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte ClickSign e WhatsApp para habilitar envio do PDF
  </Card>

  <Card title="Clientes" icon="users" href="/clients">
    Use Gerar documento na ficha
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Acompanhe gerações e status de assinatura
  </Card>

  <Card title="Templates" icon="folder" href="/files">
    Revise o catálogo de campos dinâmicos
  </Card>
</CardGroup>