Temple: a linguagem de templates do Emailit, agora documentada

Se você já usou {{first_name}} em um template do Emailit, já usou o Temple, a nossa pequena linguagem de templates para assuntos, HTML e texto. Só que nunca tínhamos publicado uma referência completa. Agora ela está na documentação: Temple.

O Temple não é Liquid nem Handlebars. Ele faz poucas coisas, faz bem e para por aí.

O que você pode escrever

Variáveis, incluindo caminhos aninhados:

Hello {{first_name}}
Item {{order.items.0.sku}}

Valores padrão para quando um valor está faltando:

Hi {{first_name|"there"}}

Condicionais (sem comparações, só verdadeiro / falso):

{{#if plan}}
You are on the {{plan}} plan.
{{else}}
You are on the free plan.
{{/if}}

Sem loops, sem helpers personalizados, sem partials. Variáveis ausentes viram strings vazias.

Onde ele roda de verdade

Esta é a parte que não estava documentada e em que é fácil errar.

• API POST /emails: o Temple roda quando você passa um template e/ou um objeto variables, inclusive com HTML inline.
• Automações, etapa Send Email: o Temple roda sempre. As automações de contatos expõem {{email}}, {{first_name}} e {{custom_fields.*}} na raiz, além de contact, payload e meta.
• Templates no painel: as tags são salvas como estão. A renderização acontece no envio.
• Campanhas: não usam o Temple. Só {{first_name}}, {{last_name}}, {{email}}, {{unsubscribe_url}} e {{cf.field}}.
• SMTP: nenhum template é processado no servidor. O MIME que você envia é exatamente o que nós enviamos.

Os campos personalizados das campanhas usam {{cf.plan}}. Os das automações usam {{custom_fields.plan}}. Os mesmos dados do contato, prefixos diferentes.

Comece agora

Leia a referência completa do Temple, com a tabela de disponibilidade e exemplos, ou envie um template pela API de e-mail com um objeto variables.