# Criar e editar templates

> Crie um template, escolha o editor Dragit, Rich Text ou HTML, insira variáveis e gerencie os templates pela lista de templates e pela página do template.

Esta página mostra como criar um template no painel ou com a API, como cada um dos três editores funciona e como gerenciar os templates pela lista de templates. Ela é para quem desenha e-mails, trabalhe você com código ou não.

## Criar um template

1. **Abra Templates.** Acesse **Email Marketing → Templates** e selecione **Add template**.

2. **Dê um nome a ele.** Em **Name**, digite um nome, como `Welcome email`. O Emailit preenche o **Alias** a partir do nome, por exemplo `welcome-email`.

3. **Confira o alias.** O alias é como o seu código e as suas automações se referem ao template. Ele pode usar letras minúsculas, dígitos, `_` e `-`, com até 191 caracteres. Se o alias já existir, a caixa de diálogo mostra **Alias already exists**, e o novo template vira uma [versão](/pt/docs/templates/versions/) não publicada do existente.

4. **Escolha um editor.** Escolha **Dragit Editor** (o padrão), **HTML Editor** ou **Rich Text Editor**. Não é possível mudar o editor de um template existente no painel, então escolha o que você quer manter.

5. **Defina os padrões.** Opcionalmente, digite um **Subject**, que pode conter placeholders do [Temple](/pt/docs/templates/temple/), e um endereço **From**, como `Acme <hello@acme.com>`. Os dois são padrões que um envio pode substituir.

6. **Crie e desenhe.** Selecione **Create**. O template abre no editor dele. Desenhe o conteúdo e salve.

Para definir um endereço Reply-To ou um corpo em texto simples separado, use a API.

### Criar um template com a API

Chame [Criar um template](/pt/docs/api-reference/templates/create/) com uma chave **Full Access**. `editor` pode ser `dragit`, `tiptap` (Rich Text), `html` ou `text`, e o padrão é `html`.

```bash
curl https://api.emailit.com/v2/templates \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome email",
    "alias": "welcome-email",
    "editor": "html",
    "from": "Acme <hello@acme.com>",
    "reply_to": "support@acme.com",
    "subject": "Welcome to Acme, {{first_name|\"there\"}}",
    "html": "<p>Hi {{first_name|\"there\"}}, thanks for joining.</p>",
    "text": "Hi {{first_name|\"there\"}}, thanks for joining."
  }'
```

A resposta tem o status `201` e o template em `data`. Se o alias for novo, o template é publicado na hora.

## Escolher um editor

| Editor | Ideal para | O que você tem |
| --- | --- | --- |
| **Dragit** | E-mails com design, colunas, imagens e botões, criados sem código | Blocos de arrastar e soltar, um gerenciador de imagens e um menu de variáveis. Salva o HTML e o design do Dragit como JSON. |
| **Rich Text** | E-mails simples, focados em texto, com cara de mensagem pessoal | Uma barra de ferramentas de processador de texto, um menu **Variables** e um campo **Preview text**. Salva o HTML. |
| **HTML** | HTML escrito à mão ou importado, com controle total da marcação | Um editor de código com números de linha e uma prévia ao vivo para desktop e celular. Salva o seu HTML como você o escreveu. |

### Editor Dragit

O Dragit é um editor de e-mails de arrastar e soltar que abre em tela cheia.

- Arraste blocos como textos, imagens e botões para o layout e ajuste o conteúdo e os estilos deles.
- Envie imagens com o gerenciador de arquivos integrado. Elas ficam guardadas no seu workspace e são servidas a partir de uma URL hospedada.
- Insira variáveis pelo menu de campos de mesclagem: **First name**, **Last name**, **Email** e os [campos personalizados](/pt/docs/contacts/custom-fields/) dos seus contatos em **Custom fields**. O link de descadastro está disponível como um tipo de link especial.
- O seu trabalho é salvo automaticamente enquanto você edita. Feche o editor para voltar à página do template.

Os templates do Dragit guardam o design como JSON do Dragit, além do HTML, então você pode exportar o JSON e importá-lo em outro workspace. Consulte [Importar e exportar](/pt/docs/templates/import-export/).

### Editor de texto formatado

O editor Rich Text abre em tela cheia com uma barra de ferramentas de formatação: desfazer e refazer, títulos de 1 a 3, listas com marcadores e numeradas, citações em bloco, negrito, itálico, sublinhado, tachado, links e alinhamento de texto.

- Selecione o botão **Variables** (o ícone `@`) na barra de ferramentas para inserir uma variável na posição do cursor.
- Digite o **Preview text** no topo para definir a linha que as caixas de entrada mostram depois do assunto. O Emailit o adiciona como texto oculto no início do e-mail.
- Selecione **Save** para manter as suas alterações. Ao salvar, o Emailit aplica uma fonte sem serifa a todos os elementos, para que o e-mail tenha uma aparência consistente nos clientes de e-mail.

### Editor HTML

O editor HTML mostra o seu código, com números de linha e destaque de sintaxe, junto com uma prévia ao vivo. Alterne a prévia entre **Desktop** e **Mobile**. Abaixo da prévia, **Available variables** lista os placeholders que você pode digitar no seu HTML. Selecione **Save** para manter as suas alterações.

A prévia mostra os placeholders como foram escritos. Ela não renderiza as condicionais do Temple nem preenche os valores.

## Variáveis nos editores

Os três editores oferecem as mesmas variáveis:

| Variável | Placeholder |
| --- | --- |
| Nome | `{{first_name}}` |
| Sobrenome | `{{last_name}}` |
| E-mail | `{{email}}` |
| URL de descadastro | `{{unsubscribe_url}}` |
| Um campo personalizado do contato | `{{cf.<key>}}`, por exemplo `{{cf.plan}}` |

Quem as preenche depende de como o template é enviado:

- **As campanhas** preenchem todas a partir do registro de contato do destinatário, e `{{unsubscribe_url}}` com o link de descadastro dele. Consulte [Tags de mesclagem de campanhas](/pt/docs/campaigns/merge-tags/).
- **Os envios pela API** preenchem apenas o que você passa em `variables`, usando os mesmos nomes. Para `{{cf.plan}}`, passe `"variables": { "cf": { "plan": "Pro" } }`. O que você não passar fica vazio.
- **As automações de contatos** preenchem `{{first_name}}`, `{{last_name}}` e `{{email}}` a partir do contato. Os campos personalizados ficam disponíveis como `{{custom_fields.<key>}}`, e `{{unsubscribe_url}}` não é preenchido.

Consulte [Temple](/pt/docs/templates/temple/) para as regras completas.

## Gerenciar templates

**Email Marketing → Templates** mostra um card por alias, com uma prévia, o nome, o alias, um selo do editor e o número de versões. Apenas a versão publicada de cada alias aparece na grade. Encontre os rascunhos no painel **Versions** da página do template.

- **Pesquise** por nome ou alias.
- **Ordene** por **Newest first**, **Oldest first**, **Recently updated**, **Recently published**, **Name A-Z** ou **Name Z-A**.
- **Filtre** por editor.
- Selecione **Import** para adicionar um template a partir de um arquivo. Consulte [Importar e exportar](/pt/docs/templates/import-export/).

O menu de cada card tem estas ações:

| Ação | O que faz |
| --- | --- |
| **View** | Abre a página do template. |
| **Open Editor** | Abre o template no editor dele. |
| **Duplicate Template** | Cria uma cópia com um novo nome e um novo alias. Consulte [Duplicar um template](/pt/docs/templates/import-export/#duplicate-a-template). |
| **Export Dragit JSON** | Baixa o design do Dragit. Aparece apenas nos templates do Dragit. |
| **Export HTML** | Baixa o HTML. |
| **Export ZIP** | Baixa um pacote com o HTML, o JSON do Dragit e as imagens. |
| **Delete** | Exclui esta versão permanentemente. |

### A página do template

Selecione um card para abrir a página do template. Ela mostra o status (**Published** ou **Draft**), o alias, o editor, a data de criação, o nome, o assunto, o From, o Reply-To e o ID, uma prévia e o painel **Versions**.

- **Publish** aparece nas versões em rascunho e torna esta versão a versão ativa do alias.
- **Open Editor** abre o conteúdo no editor do template.
- O menu tem **Edit** (alterar o nome, o alias, o assunto e o From), **Duplicate Template**, as opções de exportação e **Delete**.
- **New Version**, no painel **Versions**, copia uma versão existente para um novo rascunho. Consulte [Versões de templates](/pt/docs/templates/versions/).

## Veja também

- [Versões de templates](/pt/docs/templates/versions/)
- [Linguagem de templates Temple](/pt/docs/templates/temple/)
- [Referência da API de templates](/pt/docs/api-reference/templates/)
- [Campos personalizados](/pt/docs/contacts/custom-fields/)

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