# Templates

> Desenhe um e-mail uma vez e reutilize-o em envios pela API, automações e campanhas. Aliases, versões, três editores, variáveis do Temple e a API de templates.

Um template guarda o assunto, os dados do remetente e o conteúdo de um e-mail para que você o desenhe uma vez e o reutilize. Crie templates no painel com um editor de arrastar e soltar, de texto formatado ou HTML, ou gerencie-os pela API, e depois envie-os pelo alias, preenchendo os dados pessoais no momento do envio.

## Como funciona

1. **Crie um template** em **Email Marketing → Templates** ou com a API. Dê a ele um nome e um alias, como `welcome-email`.
2. **Desenhe o conteúdo** em um dos três editores, com placeholders como `{{first_name}}` onde entram os dados pessoais.
3. **Publique-o.** O primeiro template com um alias novo é publicado automaticamente. Os templates que você adicionar depois com o mesmo alias viram versões em rascunho, que você publica quando estiverem prontas.
4. **Envie-o.** Chame `POST /emails` com `"template": "welcome-email"` e um objeto `variables`. O Emailit renderiza a versão publicada com o [Temple](/pt/docs/templates/temple/) e a envia.

Como o seu código se refere ao alias, e não a um template específico, você pode alterar o design e publicar uma nova versão sem fazer deploy de código.

## O que um template contém

| Campo | Detalhes |
| --- | --- |
| Nome | Um rótulo para a sua equipe, com até 191 caracteres. |
| Alias | O identificador que o seu código usa, com até 191 caracteres entre `a–z`, `0–9`, `_` e `-`. Todas as versões de um template compartilham um alias. |
| Editor | **Dragit** (arrastar e soltar), **Rich Text** ou **HTML**. |
| Assunto | A linha de assunto padrão, com até 191 caracteres. Pode conter placeholders. |
| From | O remetente padrão, como `Acme <hello@acme.com>`. |
| Reply-To | Um ou mais endereços de resposta opcionais. |
| Conteúdo | O corpo HTML, um corpo em texto simples opcional (pela API) e, nos templates do Dragit, o design como JSON do Dragit. |

## Onde você pode usar templates

| Onde | Como usa o template | Placeholders |
| --- | --- | --- |
| [API de e-mail](/pt/docs/email-api/send-email/#send-with-a-template) | `template` recebe um alias (versão publicada) ou um ID `tem_` (exatamente essa versão). Assunto, HTML, texto e Reply-To vêm do template, a menos que a requisição os substitua. O `from` da requisição é sempre obrigatório. | [Temple](/pt/docs/templates/temple/), preenchido a partir de `variables` |
| [Automações](/pt/docs/automations/steps/) | A etapa **Send email** envia um template. O From, o assunto e o Reply-To do template são usados, a menos que a etapa os substitua. | Temple, preenchido a partir do contato e do gatilho |
| [Campanhas](/pt/docs/campaigns/create/) | **Choose from templates** copia o conteúdo de um template para a campanha como ponto de partida. **Save as template** transforma uma campanha em template. | [Tags de mesclagem de campanhas](/pt/docs/campaigns/merge-tags/) |
| [SMTP relay](/pt/docs/smtp/) | Não disponível. O SMTP envia a mensagem exatamente como você a montou. | Nenhum |

## O que você pode fazer

  - [Editores](/pt/docs/templates/editors/): Crie templates e desenhe-os com o Dragit, o Rich Text ou o HTML.
  - [Linguagem Temple](/pt/docs/templates/temple/): Variáveis, valores padrão e condicionais, e onde eles são renderizados.
  - [Versões](/pt/docs/templates/versions/): Crie uma nova versão em rascunho com o mesmo alias e publique-a quando estiver pronta.
  - [Importar e exportar](/pt/docs/templates/import-export/): Traga JSON do Dragit, HTML ou pacotes ZIP e exporte-os de novo.

## API de templates

Gerencie templates pelo código com a [API de templates](/pt/docs/api-reference/templates/):

| Endpoint | Finalidade |
| --- | --- |
| [Criar um template](/pt/docs/api-reference/templates/create/) | Adicionar um template ou uma nova versão de um alias existente. |
| [Obter um template](/pt/docs/api-reference/templates/get/) | Obter uma versão, incluindo o conteúdo dela e a lista das outras versões. |
| [Atualizar um template](/pt/docs/api-reference/templates/update/) | Alterar os campos ou o conteúdo de uma versão. |
| [Listar templates](/pt/docs/api-reference/templates/list/) | Listar a versão publicada de cada alias. |
| [Publicar um template](/pt/docs/api-reference/templates/publish/) | Tornar uma versão a versão ativa do alias dela. |
| [Excluir um template](/pt/docs/api-reference/templates/delete/) | Excluir uma versão. |

A API exige uma chave **Full Access**. As alterações emitem os eventos de webhook `template.created`, `template.updated` e `template.deleted`. A importação e a exportação de arquivos estão disponíveis apenas no painel.

## Disponibilidade

Os templates estão disponíveis em todos os planos, sem custo adicional. Guardar templates não usa créditos; cada e-mail que você envia com um template é cobrado como qualquer outro envio.

## Primeiros passos

  - [Criar um template](/pt/docs/templates/editors/#create-a-template): Defina o nome, o alias e o editor e desenhe o template.
  - [Enviar com um template](/pt/docs/email-api/send-email/#send-with-a-template): Envie pelo alias com variáveis a partir do seu código.

---
Fonte: https://emailit.com/pt/docs/templates/