# Tags de mesclagem

> Personalize os assuntos e o conteúdo das campanhas com tags de mesclagem para nomes, e-mail, campos personalizados e o link de descadastro, e veja como elas diferem do Temple.

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 o link de descadastro pessoal dele. 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](/pt/docs/audiences/unsubscribes/). |
| `{{cf.<key>}}` | O valor de um [campo personalizado](/pt/docs/contacts/custom-fields/), pela chave dele. Por exemplo, `{{cf.company}}` para um campo com a chave `company`. |

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. O link de descadastro fica entre os links especiais.
- **Editor HTML** e campo **Subject:** digite a tag.

## Regras de sintaxe

- **Sem espaços dentro das chaves.** Escreva `{{first_name}}`. Uma tag com espaços, como `{{ first_name }}`, não é substituída e aparece no e-mail como foi digitada. Isso importa principalmente para o link de descadastro: a verificação da etapa **Send** aceita `{{ unsubscribe_url }}`, mas só `{{unsubscribe_url}}` vira um link que funciona.
- **Os nomes das tags não diferenciam maiúsculas de minúsculas**, então `{{First_Name}}` também funciona. 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 campos personalizados precisam do prefixo `cf.`.** `{{company}}` não é uma tag de mesclagem e aparece como foi digitada.
- **Qualquer outra coisa entre chaves duplas fica como foi digitada.** O Emailit só substitui as tags da tabela acima.

## Valores ausentes

Quando um contato não tem valor para uma tag, a tag é substituída por nada. Não há sintaxe de valor alternativo nas campanhas: `{{first_name|"there"}}` não é suportado e aparece como foi digitado.

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

Então, ou escreva um texto que continue fazendo sentido sem o valor, ou garanta que todos tenham um. Na lista de contatos, filtre por **First name** com **is empty** para encontrar os contatos sem nome.

## 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** preenchem `{{email}}` com o endereço de teste e deixam vazios os nomes e os campos personalizados. O link de descadastro de um teste não descadastra ninguém.

Consulte [Testar e agendar](/pt/docs/campaigns/test-and-schedule/).

## Tags de mesclagem e Temple

As campanhas usam as suas próprias tags de mesclagem. Os templates enviados pela [API de e-mail](/pt/docs/email-api/) e os e-mails enviados por [automações](/pt/docs/automations/) usam o [Temple](/pt/docs/templates/temple/), a linguagem de templates do Emailit, que parece semelhante, mas funciona de outro jeito:

| | Tags de mesclagem de campanhas | Temple |
| --- | --- | --- |
| Usadas em | Campanhas | Envios pela API e por SMTP com template, e-mails de automações |
| Dados | O contato destinatário | As `variables` que você passa, ou os dados do contato e do evento da execução da automação |
| Conjunto fixo de tags | Sim, as cinco tags acima | Não, qualquer variável que você passar |
| Valores aninhados | Só `cf.<key>` | Qualquer caminho, como `{{user.name}}` |
| Valores alternativos | Não | Sim |
| Condicionais | Não | Sim, `{{#if ...}}` |
| Link de descadastro | `{{unsubscribe_url}}` | Não fornecido |

No Temple, o valor alternativo vem depois de uma barra vertical, por exemplo `{{first_name|"there"}}`. 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. Nas automações, os campos personalizados do contato ficam disponíveis como `{{custom_fields.<key>}}`, e não como `{{cf.<key>}}`.

## Veja também

  - [Campos personalizados](/pt/docs/contacts/custom-fields/): Defina os campos que você usa nas tags de mesclagem.
  - [Temple](/pt/docs/templates/temple/): Variáveis, valores alternativos e condicionais para envios pela API.

---
Fonte: https://emailit.com/pt/docs/campaigns/merge-tags/
