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
htmlpela 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 /templatesrecebename,htmle, opcionalmente,subject,textealias.GET /templateslista 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 ounulllimpasubjectoutext. Escreverhtmloutexttransforma um template do editor de blocos em um template em HTML.DELETE /templates/{id}o exclui.POST /templates/{id}/duplicatecria 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_toevariablesem um template respondem422. 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 /emailsnem emPOST /broadcasts. Enviehtmloutextvocê mesmo. O seletor de templates do compositor de transmissões copia o conteúdo.