Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Templates

Conteúdo de e-mail reutilizável para transmissões, gerenciado no painel ou pela API.

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. 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:

<p>Hi {{{FIRST_NAME|there}}},</p>
  • {{{FIRST_NAME}}}, {{{LAST_NAME}}} e {{{EMAIL}}} já existem. Qualquer outro nome lê uma propriedade de contato 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.

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.*.

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.

Esta página foi útil?