---
title: Templates
description: Conteúdo de e-mail reutilizável para transmissões, gerenciado no painel ou pela API.
ai:
  exclude: true
---

Um template é conteúdo de e-mail reutilizável: um assunto, HTML e uma parte opcional em texto simples. Deixe um pronto para a sua próxima [transmissão](/docs/pt-br/concepts/broadcasts). No painel, **Templates** permite criar um no editor de blocos ou escrever o HTML você mesmo.

No compositor de transmissões, escolher um template copia o conteúdo dele como ponto de partida. Editar ou excluir o template depois não muda as transmissões que você já criou.

## Campos de mesclagem

Os templates podem carregar valores por contato:

```html
<p>Hi {{{FIRST_NAME|there}}},</p>
```

- `{{{FIRST_NAME}}}`, `{{{LAST_NAME}}}` e `{{{EMAIL}}}` já existem. Qualquer outro nome lê uma [propriedade de contato](/docs/pt-br/concepts/contacts) com esse nome.
- `{{{NAME|fallback}}}` usa o texto de reserva quando o contato não tem valor.
- `{{{UNSUBSCRIBE_URL}}}` vira o link de descadastro de cada destinatário. Veja [Marcas e descadastros](/docs/pt-br/concepts/unsubscribes).

## Editor de blocos e HTML

- Um template feito no editor de blocos pode ser passado para HTML com **Editar como HTML**. Você recebe uma cópia ou altera o mesmo template. Até você salvar, **Voltar aos blocos** restaura os blocos.
- Um template criado com `html` pela API abre no modo HTML, e seu HTML é mantido exatamente como foi escrito. Convertê-lo em blocos é uma escolha sua, em uma cópia ou no próprio template, e isso achata layouts baseados em tabelas.
- No modo HTML, uma parte em texto simples gerada a partir do HTML continua acompanhando suas edições. Uma parte em texto simples que você definiu pela API é enviada como está guardada.

## Sem rascunhos e sem versões

Todo salvamento vale na hora. O template não tem etapa de rascunho ou publicação nem histórico de versões. `status` sempre aparece como `published`, e `POST /templates/{id}/publish` não faz nada e responde com sucesso.

## API

Os SDKs chamam os endpoints de templates como `templates.*`.

```bash
curl -X POST https://api.billionsend.com/templates \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome",
    "subject": "Welcome to Acme",
    "html": "<p>Hi {{{FIRST_NAME|there}}}</p>",
    "alias": "welcome"
  }'
```

- `POST /templates` recebe `name`, `html` e, opcionalmente, `subject`, `text` e `alias`.
- `GET /templates` lista os templates, do mais novo ao mais antigo. `GET /templates/{id}` devolve o conteúdo completo.
- `PATCH /templates/{id}` muda qualquer um dos campos. Uma string vazia ou `null` limpa `subject` ou `text`. Escrever `html` ou `text` transforma um template do editor de blocos em um template em HTML.
- `DELETE /templates/{id}` o exclui.
- `POST /templates/{id}/duplicate` cria uma cópia chamada `<name> (copy)`, sem o alias.

Um `alias` é feito de letras, dígitos, `.`, `_` e `-`, com até 100 caracteres, e é único na sua equipe. Todas as rotas acima aceitam o alias no lugar do id. Um alias já usado responde `409`. Um alias com cara de UUID não é permitido.

## Não suportado

- `from`, `reply_to` e `variables` em um template respondem `422`. Defina o remetente e o reply-to na transmissão e use os campos de mesclagem diretamente: propriedades de contato não precisam ser declaradas.
- Um id de template não pode ser enviado em `POST /emails` nem em `POST /broadcasts`. Envie `html` ou `text` você mesmo. O seletor de templates do compositor de transmissões copia o conteúdo.
