Pular para o conteúdo
Docs

Referência

Personalize os assuntos e o conteúdo das campanhas com tags de mesclagem para nomes, e-mail, campos personalizados, o link de descadastro e o link de gerenciamento de inscrições, com valores alternativos e condicionais do Temple.

Atualizado em 20 de out. de 2026

As tags de mesclagem inserem os dados de cada destinatário em uma campanha: o nome dele no assunto, um campo personalizado no corpo e os links pessoais de descadastro e de gerenciamento de inscrições dele. As campanhas as renderizam com o Temple, a linguagem de templates do Emailit, então você também pode adicionar valores alternativos e blocos condicionais. Esta página lista todas as tags, as regras de sintaxe e como pré-visualizar o resultado.

Tags disponíveis

Tag Substituída por
{{first_name}} O nome do contato.
{{last_name}} O sobrenome do contato.
{{email}} O endereço de e-mail do contato.
{{unsubscribe_url}} O link de descadastro pessoal do destinatário. Consulte Descadastros.
{{manage_subscriptions_url}} O link do destinatário para a página de gerenciamento de inscrições, onde ele escolhe as listas dele. Fica vazio nos envios de teste.
{{cf.<key>}} O valor de um campo personalizado, pela chave dele. Por exemplo, {{cf.company}} para um campo com a chave company.
{{global.<key>}} Um valor global do workspace, como {{global.offer_url}}. É o mesmo para todos os destinatários.
{{tags}} As tags do contato, como vip, customer. {{#if tags}}…{{/if}} verifica se o contato tem alguma.
{{score}} A pontuação de lead do contato.
{{webview_url}} Um link para a versão web do e-mail, renderizada para esse destinatário.

Com o e-commerce, em alfa para a equipe do Emailit, as campanhas também têm tags para produtos, códigos de cupom, o carrinho e dados de compra. Consulte Produtos, cupons e o carrinho.

Os campos personalizados também funcionam como {{custom_fields.<key>}}, a forma usada pelas automações, e todas as tags também ficam disponíveis em contact, por exemplo {{contact.first_name}}.

As tags de mesclagem funcionam no Subject da campanha, no conteúdo HTML e na versão em texto simples. Elas não são substituídas em From name, From email nem Reply to.

HTML
<p>Hi {{first_name}},</p>
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
<p><a href="{{unsubscribe_url}}">Unsubscribe</a> from Acme emails sent to {{email}}.</p>

Inserir tags nos editores

  • Editor de texto formatado: digite @ e escolha uma variável, ou um campo personalizado pelo nome.
  • Editor Dragit: use o menu de campos de mesclagem, que lista First name, Last name, Email e os seus campos personalizados. Os links de descadastro e de gerenciamento de inscrições ficam entre os links especiais.
  • Editor HTML e campo Subject: digite a tag.

Regras de sintaxe

  • Os espaços em volta do nome de uma tag são ignorados, então {{ first_name }} funciona como {{first_name}}. Os blocos condicionais são mais rígidos: escreva {{else}} e {{/if}} exatamente como mostrado e comece uma condição com {{#if, sem espaço depois das chaves.
  • Os nomes das tags não diferenciam maiúsculas de minúsculas, então {{First_Name}} também funciona. Isso vale para as seis tags da tabela e para o prefixo cf.. As chaves dos campos personalizados devem ser exatamente iguais à chave armazenada, e as chaves são sempre em minúsculas, então escreva {{cf.company}}, e não {{cf.Company}}. Os caminhos em contact e custom_fields diferenciam maiúsculas de minúsculas.
  • Os campos personalizados precisam de um prefixo. Escreva {{cf.company}}: {{company}} não é uma tag de mesclagem, então é renderizada como vazio.
  • Qualquer outra coisa entre chaves duplas é removida. O Temple trata todo {{…}} como um placeholder, e um placeholder sem valor é renderizado como vazio. Não existe sintaxe de escape: para mostrar chaves duplas literais no HTML, escreva-as como &#123;&#123;.

Valores ausentes

Quando um contato não tem valor para uma tag, a tag é substituída por nada. Para usar outro texto no lugar, adicione um valor alternativo depois de uma barra vertical. Um campo vazio conta como ausente, então também recebe o valor alternativo.

Conteúdo Contato com nome Contato sem nome
Hi {{first_name}}, Hi Ada, Hi ,
Hi {{first_name|"there"}}, Hi Ada, Hi there,

Aspas duplas, aspas simples ou nenhuma aspa funcionam em volta do valor alternativo. Na lista de contatos, filtre por First name com is empty para encontrar os contatos sem nome.

Conteúdo condicional

Mostre um bloco apenas para os contatos que têm um valor, com um {{else}} opcional para todos os outros:

HTML
{{#if cf.plan}}
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
{{else}}
<p>Upgrade to get scheduled sending.</p>
{{/if}}

Uma condição é falsa quando o campo está ausente ou vazio, ou quando é false ou 0, e é verdadeira em qualquer outro caso. Não há comparações como cf.plan == "Pro": para direcionar um bloco a um valor específico, guarde esse valor em um campo próprio, por exemplo um booleano is_pro. Os blocos podem ser aninhados. Consulte Condicionais para ver as regras completas.

Como os valores são renderizados

Tipo de campo Renderizado como
Texto, número O valor armazenado, por exemplo Acme ou 42.
Data YYYY-MM-DD, por exemplo 1990-04-12.
Booleano true ou false.
Seleção A opção selecionada.
Seleção múltipla As opções separadas por vírgulas, sem espaços, por exemplo news,offers.

Os valores são inseridos exatamente como estão armazenados, sem escape de HTML. Se as pessoas podem digitar o próprio nome, por exemplo em um formulário de inscrição público, confira esses valores antes de usá-los em HTML.

Pré-visualizar as tags de mesclagem

  • Preview as contact, na etapa Preview and test, renderiza o assunto e o conteúdo com os dados de um contato real. Use-o para conferir nomes, campos personalizados e valores vazios.
  • Os envios de teste para um endereço que pertence a um contato deste workspace usam os dados desse contato. Nos outros endereços, {{email}} é preenchido com o endereço de teste e os nomes e os campos personalizados ficam vazios, então os valores alternativos e os blocos {{else}} aparecem. O link de descadastro de um teste não descadastra ninguém.

Consulte Testar e agendar.

Tags de mesclagem e Temple

As tags de mesclagem de campanhas são placeholders do Temple preenchidos com os dados do contato destinatário. Os templates enviados pela API de e-mail e os e-mails enviados por automações também usam o Temple, com outros dados:

Campanhas Envios pela API E-mails de automações
Dados O contato destinatário As variables que você passa O contato, os dados do evento e os metadados da execução
Campos personalizados {{cf.<key>}} ou {{custom_fields.<key>}} O que você passar, por exemplo um objeto cf {{cf.<key>}} ou {{custom_fields.<key>}}
Links de descadastro e de gerenciamento {{unsubscribe_url}}, {{manage_subscriptions_url}} Não fornecidos {{unsubscribe_url}}, {{manage_subscriptions_url}} nas automações do contexto Contact
Maiúsculas e minúsculas nos nomes das tags Qualquer combinação, nas seis tags acima Exatas Exatas

Assim, um template que usa {{cf.<key>}}, valores alternativos e condicionais é renderizado da mesma forma em uma campanha e em uma automação de contatos. Se você salvar uma campanha como template e enviá-la pela API, o Temple preenche as tags dela com as variables que você passar. Passe first_name para {{first_name}}, um objeto cf para {{cf.company}} e o seu próprio unsubscribe_url, se o conteúdo tiver um link para ele.

Defina os campos que você usa nas tags de mesclagem.
A linguagem de templates completa: variáveis, valores alternativos e condicionais.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.