---
title: "Referência sobre a personalização de mensagens"
description: "Saiba como usar as tags do modelo da Klaviyo para personalizar a experiência dos seus clientes."
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/4408802648731"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/4408802648731.md"
locale: "pt-br"
category: "Conteúdo"
section: "Use sintaxe e tags de variáveis"
updated: "2026-03-30"
---

# Referência sobre a personalização de mensagens

Saiba como usar as tags do modelo da Klaviyo para personalizar a experiência dos seus clientes.

As tags de personalização podem ser usadas em e-mails (incluindo o campo de assunto), mensagens SMS/MMS, notificações push e no Customer Hub. Este artigo descreve algumas tags, suas estruturas e formas, e como personalizá-las. Para mais informações, consulte o artigo sobre como [adicionar personalizações às suas mensagens](https://help.klaviyo.com/hc/pt-br/articles/18986347580827.md). 

**📝 Note:** Antigamente, as tags de personalização eram chamadas de tags do modelo e sintaxe variável.

## Sobre as tags de personalização

As tags inseridas no campo de texto são semelhantes à frase à esquerda na tabela abaixo. Depois que a mensagem é exibida, as tags são substituídas por informações do perfil do destinatário ou do evento, e aparecem como a frase à direita.

| Oi, `{{ first_name }} {{ last_name }}`, sua cor favorita é `{{ person\|lookup:'Favorite Color' }}` | *Oi, George Washington, sua cor favorita é verde* |
| --- | --- |

A personalização do perfil geralmente começa com `person`, exceto em algumas tags especiais, como `first_name` e `last_name`. As variáveis de evento, que podem ser usadas em fluxos disparados por métricas, começam com `event`. As tags de organização (como o nome e o endereço da sua empresa) começam com `organization`. 

**📝 Note:** Todas as tags de personalização diferenciam maiúsculas de minúsculas e devem corresponder exatamente aos nomes das propriedades a que se referem. Certifique-se de que suas tags sejam digitadas corretamente e usem maiúsculas/minúsculas exatamente como aparecem nos perfis.

## Personalização do perfil

A personalização do perfil permite que você exiba propriedades especiais da Klaviyo nas suas mensagens. A lista abaixo abrange toda a personalização de perfil (propriedades incorporadas da Klaviyo). As tags de personalização de perfil selecionadas estão disponíveis no menu **Personalização** do editor de e-mail ou na visualização de mensagens SMS e push. 

Se quiser adicionar propriedades personalizadas às suas mensagens, pule para a seção sobre [personalização](#h_01HBRGTJ3H2M4N326FXPBSA4AN). 

| **Tag** | **Propriedade do perfil** |
| --- | --- |
| `{{ email }}` | E-mail |
| `{{ first_name }}` | Nome |
| `{{ last_name }}` | Sobrenome |
| `{{ person.organization }}` | Organização do destinatário |
| `{{ person\|lookup:"$address1" }}` | Endereço 1 |
| `{{ person.id }}` | ID única ($id/external ID) |
| `{{ person\|lookup:"$latitude" }}` | Latitude |
| `{{ person\|lookup:"$longitude" }}` | Longitude |
| `{{ person.KlaviyoID }}` | ID da Klaviyo |
| `{{ person.full_name }}` | Nome completo |
| `{{ person.title }}` | Cargo |
| `{{ person.phone_number }}` | Telefone |
| `{{ person\|lookup:'$address2' }}` | Endereço 2 |
| `{{ person.City }}` | Cidade |
| `{{ person.Region }}` | Estado/Região |
| `{{ person.Country }}` | País |
| `{{ person.Zipcode }}` | CEP |
| `{{ person\|lookup:"$source" }}` | Fonte |
| `{{ person\|lookup:"$consent" }}` | Consentimento |
| `{{ person\|lookup:'$consent_form_id' }}` | $consent_form_id |
| `{{ person\|lookup:'$consent_form_version' }}` | $consent_form_version |
| `{{ person\|lookup:'$consent_method' }}` | $consent_method |
| `{{ person\|lookup:"$timezone" }}` | Recipient timezone |
| `{{ person\|lookup:'$consent_timestamp' }}` | $consent_timestamp |
| `{{ person\|lookup:'$phone_number_region' }}` | $phone_number_region |
| `{{ person.ViewedItems }}` | Itens visualizados recentemente |
| `{{ person\|lookup:"Expected Date Of Next Order" }} ` | Data prevista do próximo pedido |

## Tags de objeto personalizado

As tags de [objeto personalizado](https://help.klaviyo.com/hc/pt-br/articles/35105337172123.md) permitem que você use dados de objeto em envios de fluxo e de campanha. 

Consulte [as referências de tag ](https://help.klaviyo.com/hc/pt-br/articles/35146367972763.md#h_01JPTH5R889GMM7XPNS3FSB4SE) para ver exemplos específicos de como usar a tag para obter uma ID de objeto ou retornar uma contagem. 

**📋 Requirements:** Antes de usar dados de objetos personalizados no modelo, você precisa criar um objeto. A tag `{{ object }}` só está disponível quando um objeto dispara um fluxo.

| **Tag** | **Resultado** |
| --- | --- |
| `{{ object.object_property }}` | Apresenta o objeto que acionou um fluxo |
| `{{ object \| lookup:'object_property' }}` |  |
| `{{ object_filter.object_filter_name.object_property}}` | Apresenta um único objeto de um [filtro de objetos ](https://help.klaviyo.com/hc/pt-br/articles/35146367972763.md#h_01JPTH5R8840K0Q3XWH2CFYWRY) |
| `{{ object_filter.object_filter_name \| lookup: 'object_property' }}` |  |
| `{{ object_filter.object_filter_name }}` | Apresenta uma contagem de um [filtro de objeto](https://help.klaviyo.com/hc/pt-br/articles/35146367972763.md#h_01JPTH5R8840K0Q3XWH2CFYWRY) |
| `{% customobject id={{ event.object_id }} as alias %}` | Recuperar um objeto por ID |
| `{% customobjects object_type_title=“Title” as alias %} ` `{% for object_instance in alias %} ` `{{ object_instance.record }} ` `{% endfor %} ` `{% endcustomobjects %}` | Recuperar todos os registros de um objeto de um perfil |

## Tags de organização

As tags de organização permitem que você inclua informações sobre sua empresa ou organização nas suas mensagens. É possível gerenciar essas informações clicando no nome da sua organização no canto inferior esquerdo e, em seguida, selecionando **Configurações > Organização > Informações de contato**. Todas as tags de organização começam com `organization`. Consulte a tabela abaixo para ver a lista de tags de organização.

| **Tag de organização** | **Descrição** |
| --- | --- |
| `{{ organization.name }}` | Nome da organização |
| `{{ organization.url }}` | Site da organização |
| `{{ organization.full_address }}` | Endereço completo da organização, incluindo cidade, estado/região e CEP |
| `{{ organization.street_address }}` | Endereço da organização |
| `{{ organization.street_address2 }}` | Continuação do endereço da organização (por exemplo, número do apartamento ou da unidade) |
| `{{ organization.city }}` | Cidade da organização |
| `{{ organization.region }}` | Estado, município ou região da organização |
| `{{ organization.zip_code }}` | CEP da organização |

## Tags de link e visualização

As tags de link e visualização permitem que os destinatários gerenciem preferências de inscrição e visualizem mensagens no navegador. Isso inclui: 

- [Cancelar inscrição](#h_01HBRGTJ3G4V514CV5YZSCS6PC)

- [Gerenciar preferências](#h_01HBRGTJ3HMN8N33EC4XF8M04C)

- [Visualizar na web](#h_01HBRGTJ3H39MT5259FW7ENKWA)

- [Prévia do texto](#h_01HBRGTJ3H3PCEGB19NW374KDV)



Essas tags só são compatíveis com modelos de e-mail. Os links em um e-mail de visualização direcionam para uma página provisória, em vez de uma página de consentimento ativa ou de visualização. 

### Cancelar inscrição

A Klaviyo exige um link de cancelamento de inscrição em todos os e-mails. Use uma tag simples dizendo "Cancelar inscrição" ou adicione seu próprio texto entre aspas. 

| **Tag** | **Resultado** |
| --- | --- |
| `{% unsubscribe %}` | *Cancelar inscrição* |
| Se não quiser mais receber e-mails, `{% unsubscribe 'click here' %}`. | *Se não quiser mais receber e-mails, clique aqui.* |

Você também pode usar a tag `{% unsubscribe_link %}` para gerar um URL de cancelamento de inscrição. Em vez de um link com uma palavra ou frase, essa tag cria apenas o URL de cancelamento de inscrição. Use-a se quiser exibir o link em uma cor diferente da definida nos estilos do modelo ou se quiser usar um botão/imagem em vez de um link de texto. 

| **Tag** | **Resultado** |
| --- | --- |
| `Este é um link sofisticado de <a href="{% unsubscribe_link %}">cancelamento de inscrição</a>.` | *Este é um link sofisticado de cancelamento de inscrição.* |

Ao clicar no link de cancelamento de inscrição, o destinatário é direcionado a uma [página de confirmação personalizável](https://help.klaviyo.com/hc/pt-br/articles/115005251848.md).

### Gerenciar preferências

As páginas de preferências permitem que os usuários atualizem suas preferências e que você segmente mensagens de forma mais eficaz. Para incluir um link para essa página, use a tag "gerenciar preferências".

Você pode criar páginas de gerenciamento gerais e específicas para listas. As páginas específicas são usadas quando você envia uma mensagem para apenas uma lista. A página de gerenciamento geral de preferências é usada quando você envia para um segmento, uma combinação de listas ou fluxos que não são disparados por listas. Saiba mais sobre [as páginas de gerenciamento de preferências](https://help.klaviyo.com/hc/pt-br/articles/115005251848.md). 

Use uma tag simples de gerenciamento de preferências em um link que diga "Gerenciar preferências" ou adicione seu próprio texto entre aspas. 

| **Tag** | **Resultado** |
| --- | --- |
| `{% manage_preferences %}` | *Gerenciar preferências* |
| Deseja atualizar suas preferências? `{% manage_preferences 'Click here' %}`. | *Deseja atualizar suas preferências? Clique aqui.* |

Como alternativa, você pode usar a tag `{% manage_preferences_link %}` para gerar um URL de gerenciamento de preferências. Em vez de gerar um link com uma palavra ou frase, essa tag cria apenas o URL da página de preferência do destinatário. Use-a se quiser exibir o link em uma cor diferente da definida nos estilos do modelo ou se quiser usar um botão/imagem em vez de um link de texto. 

| **Tag** | **Resultado** |
| --- | --- |
| `Este é um link sofisticado para <a href="{% manage_preferences_link %}">gerenciar preferências</a>.` | *Este é um link sofisticado para gerenciar preferências.* |

### Visualizar na web

Para que os destinatários possam visualizar um e-mail em um navegador, use a tag de visualização na web. 

| **Tag** | **Resultado** |
| --- | --- |
| `{% web_view %}` | *Exibir no seu navegador* |
| Não consegue ver este e-mail? `{% web_view 'Open in your browser' %}`. | *Não consegue ver este e-mail? Abra o e-mail no seu navegador.* |
| `Este é um link sofisticado de <a href="{% web_view_link %}">visualização na web</a>.` | *Este é um link sofisticado de visualização na web.* |

### Prévia do texto

Em alguns casos, pode ser útil exibir o texto de visualização no corpo do modelo. Você pode fazer referência a qualquer texto de visualização definido na tela de visualização/configuração do e-mail usando a tag `{% render_variable preview_text %}`.

Se atualizar o texto na tela de visualização do e-mail, essa tag exibirá o texto atualizado.

## Tags de personalização e de eventos

As tags personalizadas referem-se a propriedades de perfil personalizadas, ou seja, dados que não sejam propriedades e eventos especiais da Klaviyo (por exemplo, aniversário ou preferências de contato). As tags de evento referem-se a dados de um evento específico (por exemplo, pedido realizado) e só podem ser usadas em fluxos disparados por esse evento. 

Para adicionar uma tag personalizada, clique em **Personalização** em um campo de texto de e-mail e localize a tag. Para adicionar uma tag de evento, visualize sua mensagem e copie a tag da variável dos dados de visualização. Como alternativa, use os formatos abaixo para adicionar manualmente tags personalizadas aos seus modelos. 

| **Formato da tag** | **Descrição** | **Exemplo** |
| --- | --- | --- |
| `{{ person.property_name }}` | Tag simples de personalização de perfil | `{{ person.Birthday }}` |
| `{{ person\|lookup:'property name' }}` | Tag de personalização de perfil, se o nome da propriedade tiver espaços ou caracteres especiais | `{{ person\|lookup:'Favorite Color' }}` |
| `{{ event.property_name }}` | Tag simples de variável de evento | `{{ event.URL }}` |
| `{{ event\|lookup:'property name' }}` | Tag de variável de evento, se o nome da variável tiver espaços ou caracteres especiais | `{{ event\|lookup:'$value' }}` |
| `{{ event.property.nested_variable }}` | Tag de variável de evento, se a variável estiver aninhada nos dados do evento | `{{ event.extra.checkout_url }}` |
| `{{ event\|lookup:'property name'\|lookup:'nested variable name' }}` | Tag de variável de evento, se a variável estiver aninhada em outra variável com um nome que contenha um espaço ou caractere especial | `{{ event\|lookup:'Coupon Codes'\|lookup:'0' }}` |

Use a notação (.) para tags sem espaços ou caracteres especiais. Se os nomes das propriedades tiverem espaços ou caracteres especiais (por exemplo, $), use a notação de pesquisa. 

**📝 Note:** Com propriedades aninhadas, se um nome de propriedade usar a notação de pesquisa, todas as propriedades posteriores também deverão usar a notação de pesquisa. Ou seja: `event|lookup:'Collection Names'|lookup:'0'` está correto, mas `event|lookup:'Collection Names'.0` não está.

## Personalização de tags com filtros

Para personalizar a exibição das suas tags, aplique filtros de modelo. Eles podem ser usados para aplicar iniciais em letras maiúsculas, definir casas decimais de um número e muito mais. Dois dos filtros mais comuns são `default` e `title`. 

O filtro `default` define um valor padrão a ser exibido se o destinatário não tiver essa propriedade definida. No exemplo abaixo, "friend" (amigo) e "tasty treats" (quitutes) são definidos como valores padrão, caso o nome ou a comida favorita do destinatário não esteja definido no perfil da Klaviyo. 

| **Texto com tags de personalização** | **Resultado** |
| --- | --- |
| Olá, `{{ first_name\|default:'friend' }}`, você tem interesse em algum `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`? | *Olá, amigo, você tem interesse em alguns quitutes?* |

O filtro `title` permite que você aplique iniciais maiúsculas a qualquer tag de texto para garantir consistência. Por exemplo, alguns assinantes podem usar todas as letras maiúsculas ou minúsculas ao preencher o formulário de registro. Sem um filtro, o nome da pessoa apareceria como digitado originalmente. O filtro de título corrige isso para que o nome seja exibido corretamente. 

| **Texto com tags de personalização** | **Resultado** |
| --- | --- |
| Olá, `{{ first_name\|title }}`, já viu nosso último lançamento? | *Olá, Elisa, já viu nosso último lançamento?* |

Há dezenas de outros filtros disponíveis para suas mensagens. Saiba mais sobre como [usar filtros para personalizar tags](https://help.klaviyo.com/hc/pt-br/articles/360058907911.md). 

## Tags de data 

As tags de data são uma maneira rápida de inserir esse tipo de informação em um e-mail. A data está no fuso horário da sua conta e reflete o dia ou a hora em que a mensagem foi enviada. 

A tag `{{ today }}` é uma das tags de data mais comuns e registra a data e a hora de envio da mensagem. Para usar a tag "today", cole a seguinte linha de código no seu modelo: 

`{% today "%Y-%m-%d" as today %} {{ today }}`

Se você usar a tag `{{ today }}` sem o código anterior, nada será renderizado. É necessário usar a linha completa de código. 

Para saber como usar ou personalizar as tags de data, consulte o artigo sobre [tags de data em modelos](https://help.klaviyo.com/hc/pt-br/articles/115005257788.md). 

## Tags de moeda 

Dados de eventos, como *"Pedido Realizado"* ou *"Adicionado ao Carrinho"*, costumam ter um valor financeiro associado (por exemplo, o preço de um produto ou o valor do carrinho de um cliente). Use a tag {% currency_format ... %} para aplicar a formatação da moeda local a esse valor.

Por exemplo, considere o campo $value na métrica *Checkout Iniciado* abaixo: 

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/613a96ece881016159239bced8dd7f17e905d14f-778x204.png?auto=format)

Com a variável {{ event|lookup:"$value" }}, a propriedade será exibida com apenas uma casa decimal e sem o símbolo de moeda no e-mail: 

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/d09656cb6637e9d55e3a6818d9c290322e19b71b-140x76.png?auto=format)

Com a tag de formato de moeda, {% currency_format event|lookup:"$value" %}, o número é renderizado com um símbolo de moeda e o número correto de casas decimais: 

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/d9f9cdf74d1644291a29c35d8b01fd3a3726a01d-190x88.png?auto=format)

Para usar a tag de formato de moeda, substitua o texto provisório em {% currency_format PLACEHOLDER %} pela sua variável.

Por exemplo, se sua variável fosse {{ event.item.price }}, a tag de formato de moeda seria {% currency_format event.item.price %}. Se sua tag incluir filtros (por exemplo, um valor padrão caso a propriedade esteja vazia), inclua-os também na tag: {% currency_format event.item.price|default:”0” %}. 

#### Como selecionar um país 

Você pode definir o formato da moeda em suas mensagens de duas maneiras: 

- **Para toda a sua conta**
Acesse **Configurações > Organização > Idioma da organização e formato regional** e selecione o *idioma da organização*.

- **Para uma mensagem específica**
Selecione um formato de moeda diferente para uma única mensagem na aba **Estilos** do modelo, na seção *Moeda*. 



#### Como resolver problemas na tag currency_format

Esta tag só é compatível com variáveis numéricas (por exemplo, 10, 24,56). As propriedades com o símbolo de moeda incluído (por exemplo, R$40, $76.30) são strings; a tag currency_format não pode alterá-las. 

## Declarações condicionais

Com as tags condicionais, você pode incluir conteúdos somente para destinatários que atendam a determinados critérios. É uma ótima maneira de personalizar suas mensagens para cada destinatário.

### Declarações "If"

As declarações "If" permitem que você controle o conteúdo que alguém recebe com base em dados de perfil ou de eventos. 

No exemplo abaixo, uma pessoa verá a primeira linha de texto se tiver mais de 150 pontos de fidelidade. Se tiver menos de 150 pontos, mas mais do que 0, ela verá a segunda linha. Se não tiver pontos de fidelidade, verá a terceira mensagem. 

```text
{% if person|lookup:'Loyalty Points' > 150 %}
Olá, VIP! Você tem frete e devoluções grátis
{% elif person|lookup:'Loyalty Points' > 0 %}
Você tem {{ person|lookup:'Loyalty Points' }} pontos. Só faltam 150 para se tornar VIP! 
{% else %}
Já ouviu falar do nosso programa VIP? Cadastre-se hoje mesmo no nosso site para começar a ganhar prêmios.
{% endif %}

```

Em uma instrução "If", é preciso incluir uma condição inicial `{% if ... %}` e uma tag de fechamento `{% endif %}`. Os outros elementos (tags `{% elif %}` e `{% else %}` ) são opcionais. Você pode usar uma quantidade ilimitada de tags `{% elif %}`, seguidas de no máximo uma tag `{% else %}`. Cada destinatário verá apenas a primeira mensagem com a qual se qualificar. 

### Declarações "For"

Os blocos “For” permitem iterar sobre cada elemento de uma variável que armazena uma lista e renderizá-los individualmente. Veja abaixo um exemplo de declaração: 

| `{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}` | *Manta de praia grande × 1*   *Cadeiras de praia × 4*   *Protetor solar com FPS × 2*   *Cooler de plástico × 1* |
| --- | --- |

Cada declaração *For* deve conter o seguinte: 

- Uma tag `{% for ... %}` de abertura, contendo um alias de linha *(item* no exemplo acima) e uma coleção de linhas *(event.shopping_cart_items* no exemplo acima).

- Uma tag de fechamento `{% endfor %}`.



Entre as duas tags obrigatórias, você pode incluir qualquer texto. Para incluir variáveis aninhadas na coleção de linhas, substitua o início do nome da variável (coleção de linhas mais o número subsequente) pelo alias da linha. Por exemplo, a variável `{{ event.shopping_cart_items.0.name }}` se torna `{{ item.name }}`. 

### Declarações condicionais e editor de texto integrado

Quando você adiciona instruções condicionais a um bloco de texto, elas podem desaparecer do editor de texto integrado. O código ainda está presente, porém oculto. Para visualizar e editar instruções condicionais, abra o campo *Código-fonte* do bloco de texto. 

As seguintes tags só ficam visíveis no campo *Código-fonte* de um bloco de texto: 

- {% for ... %}

- {% endfor %}

- {% if ... %}

- {% elif ... %}

- {% else %}

- {% endif %}

- {% with ... %}

- {% endwith %}

## Recursos adicionais

- [Como criar e enviar uma campanha de e-mail](https://help.klaviyo.com/hc/pt-br/articles/115005054847.md)
  Conheça os conceitos básicos de campanhas de e-mail e aprenda a enviá-las na Klaviyo.
- [Como usar o painel de visualização para personalizar mensagens](https://help.klaviyo.com/hc/pt-br/articles/27843522951707.md)
  Saiba como usar o painel de visualização para entender os dados de personalização disponíveis para suas mensagens e como acessar tags de modelo. Use o modal de visualização como sua fonte de verdade para opções de personalização. 
- [Como criar blocos dinâmicos em um e-mail de fluxo](https://help.klaviyo.com/hc/pt-br/articles/4408802597659.md)
  Saiba como usar blocos de tabela dinâmica para adicionar informações de produtos e outros eventos aos seus fluxos acionados por métrica. Neste artigo, você vai aprender a criar um bloco dinâmico usando o exemplo de um lembrete de carrinho abandonado que mostra os produtos que foram deixados para trás.
- [Como resolver mensagens de erro em modelos de e-mail](https://help.klaviyo.com/hc/pt-br/articles/4402386684187.md)
  Se você encontrar erros ou avisos em um modelo de e-mail, talvez seja necessário resolvê-los antes de enviar sua mensagem. Pesquise neste recurso a mensagem de erro ou o aviso que você está encontrando para ver dicas de como resolver o problema. 
- [Como criar blocos de conteúdo para o Customer Hub](https://help.klaviyo.com/hc/pt-br/articles/33660517680795.md)
  Saiba como criar blocos de conteúdo para o Klaviyo Customer Hub. Os blocos de conteúdo são blocos altamente personalizáveis e personalizáveis que têm acesso aos dados de perfil da Klaviyo, o que permite exibir integrações (por exemplo, saldo de pontos de fidelidade), ofertas personalizadas e muito mais. 
