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

# Como Criar Templates .docx

> Aprenda a criar templates de documentos Word com placeholders para gerar documentos automaticamente.

## Visão Geral

O Document Templater do Tela permite gerar documentos a partir de templates `.docx`, substituindo placeholders por valores dinâmicos do seu workflow. Você cria o template uma vez e o Tela preenche os dados toda vez que o workflow é executado.

## Como Funcionam os Placeholders

Placeholders são marcadores dentro do seu template `.docx` que indicam ao Tela onde inserir valores. Eles usam chaves com o nome do placeholder:

```
{nome_do_placeholder}
```

Quando o documento é gerado, cada `{nome_do_placeholder}` é substituído pelo valor real que você mapeou no workflow.

### Exemplo

Um template com:

```
Prezado(a) {nome_cliente},

Seu número de fatura é {numero_fatura}, com um total de {valor_total}.

Atenciosamente,
{nome_empresa}
```

Produzirá:

```
Prezado(a) João Silva,

Seu número de fatura é FAT-2026-001, com um total de R$ 1.500,00.

Atenciosamente,
Acme Corp
```

## Criando um Template

<Steps>
  <Step title="Crie um arquivo .docx">
    Abra o Microsoft Word, Google Docs (exporte como .docx) ou qualquer editor que suporte o formato `.docx`.
  </Step>

  <Step title="Escreva o conteúdo">
    Escreva o conteúdo do documento normalmente — formatação, tabelas, cabeçalhos, imagens e estilos são preservados.
  </Step>

  <Step title="Adicione placeholders">
    Onde você deseja valores dinâmicos, digite o nome do placeholder entre chaves: `{nome_do_placeholder}`.

    Use nomes descritivos como `{nome_cliente}`, `{data_contrato}` ou `{valor_total}`.
  </Step>

  <Step title="Salve como .docx">
    Salve o arquivo no formato `.docx`. Outros formatos (`.doc`, `.pdf`, `.odt`) não são suportados.
  </Step>
</Steps>

## Regras para Placeholders

| Regra                         | Exemplo                                         | Observação                                   |
| ----------------------------- | ----------------------------------------------- | -------------------------------------------- |
| Use chaves                    | `{nome}`                                        | Apenas chaves simples                        |
| Sem espaços dentro das chaves | `{nome_cliente}`                                | Use underscores no lugar de espaços          |
| Sensível a maiúsculas         | `{Nome}` e `{nome}` são placeholders diferentes | Seja consistente                             |
| Pode repetir                  | Use `{empresa}` várias vezes                    | O mesmo valor é inserido em todos os lugares |
| Funciona em tabelas           | Coloque `{valor}` dentro de células             | A formatação é preservada                    |

## Usando Templates em Workflows

1. Adicione um nó **Generate Document** ao seu workflow
2. Faça upload do seu template `.docx`
3. O Tela extrai automaticamente todos os placeholders do template
4. Mapeie cada placeholder para uma variável do workflow ou saída de um passo anterior
5. Defina o nome do arquivo de saída
6. Execute o workflow — o documento gerado fica disponível como saída

## Dicas

<CardGroup cols={2}>
  <Card title="Mantenha os placeholders simples" icon="lightbulb">
    Use nomes curtos e descritivos. Evite caracteres especiais além de underscores.
  </Card>

  <Card title="Teste com dados de exemplo" icon="flask">
    Antes de usar em produção, execute o workflow com valores de teste para verificar a formatação.
  </Card>

  <Card title="Preserve a formatação" icon="paintbrush">
    Placeholders herdam a formatação (negrito, itálico, tamanho da fonte) do texto ao redor.
  </Card>

  <Card title="Use tabelas para dados estruturados" icon="table">
    Coloque placeholders dentro de células de tabelas para faturas, relatórios ou formulários.
  </Card>
</CardGroup>