[Manual] Personalizar suas mensagens com conteúdo dinâmico (linguagem de modelo Brevo)

Este artigo aborda o método manual de inserir variáveis. Se preferir usar o seletor Adicionar variável, consulte nosso artigo dedicado Personalizar suas mensagens com conteúdo dinâmico (linguagem de modelo Brevo).

Use a linguagem de modelo Brevo para personalizar suas mensagens com dados de contato ou eventos específicos, ocultar ou exibir conteúdo para um destinatário específico e ajustar como os valores são formatados em suas mensagens.

💬 Variáveis

Variáveis, também conhecidas como etiquetas de placeholder ou de mesclagem, são etiquetas que você pode inserir em suas mensagens para personalizá-las. Quando você envia uma mensagem, cada variável é automaticamente substituída pelas informações do contato correspondente.

As variáveis devem ser colocadas entre chaves duplas, como {{ ... }} ou {{...}}. Elas podem ser usadas para inserções simples ou combinadas com instruções condicionais e filtro para personalização avançada.

Tipo de variável Caso de uso
👤 Variáveis de contato Atributos de contato estáticos (nome, e-mail…)
Variáveis de evento Dados de uma ação de gatilho
🛢️ Variáveis de feed de dados Dados em tempo real de uma fonte externa
🛒 Variáveis de feed de produtos Listagens dinâmicas de produtos
📦 Variáveis de objeto Atributos de objeto personalizado
📅 Variáveis de data Enviar carimbo de data/hora
🔗 Link de e-mail e variáveis de pré-visualização Links de espelhamento, descadastro, atualização de perfil e double opt-in

👤 Variáveis de contato

Disponível para: ✅ E-mail ✅ SMS ✅ WhatsApp ✅ Push

A sintaxe é {{ contact.ATTRIBUTE }}, onde você deve substituir ATTRIBUTE pelo nome exato do atributo de contato, conforme ele aparece na página Contact attributes (Atributos de contato). Há suporte para atributos padrão e atributos personalizados.

Por exemplo:

Entrada Descrição Saída
{{ contact.EMAIL }} Endereço de e-mail (padrão) abby@the-green-yoga.com
{{ contact.FIRSTNAME }} Nome (padrão) Abby
{{ contact.SMS }} Número de telefone (padrão) +12152688872
{{ contact.LANGUAGE }} Idioma (personalizado) Inglês

➡️ Para saber mais, consulte nossos artigos dedicados:

⚡ Variáveis de evento

Disponível para: ✅ E-mail
(somente gatilho)
✅ SMS
(somente gatilho)
✅ WhatsApp
(somente gatilho)
✖️ Push

Variáveis de evento permitem exibir dados de eventos específicos ativados pelas ações de um contato, como o preço do último item comprado ou o nome da reunião que reservou.

Para identificar as variáveis disponíveis, verifique sua chamada API ou log de eventos na Brevo. Os exemplos abaixo se baseiam na seguinte estrutura JSON:

email_event-variables_json-example_en-us.png

data é o objeto raiz que contém as seguintes propriedades:

  • id → o ID do carrinho
  • total → valor total do carrinho
  • currency → tipo de moeda
  • url → URL do carrinho
  • items é uma matriz de produtos no carrinho, cada um contendo as seguintes propriedades:
    • name → nome do produto
    • price → preço do produto
    • url → URL da página do produto
    • image → URL da imagem do produto
💡 É bom saber

O objeto raiz (data acima) é obrigatório. Todas as outras propriedades são opcionais e podem ser nomeadas conforme o necessário.

Dependendo de onde seus dados estão armazenados na estrutura JSON, a sintaxe varia: 

⏫ Dados armazenados diretamente sob o objeto raiz

Os dados armazenados diretamente no objeto raiz normalmente contêm detalhes importantes do evento, como informações do carrinho, e podem ser recuperados sem a necessidade de percorrer matrizes.

A sintaxe é {{ params.property }}, em que você deve substituir property pelo nome exato da propriedade sob o objeto raiz na sua estrutura JSON.

Dada a estrutura JSON acima:

Entrada Descrição Saída
{{ params.id }} ID do carrinho cart:1234
{{ params.total }} Total do carrinho 280
{{ params.currency }} Moeda do carrinho USD
{{ params.url }} URL do carrinho http://www.example.com
↪️ Dados acessíveis de uma matriz sob o objeto raiz

Matrizes armazenadas no objeto raiz, como a matriz items acima, podem conter vários elementos, cada um com suas próprias propriedades. Use a indexação para fazer referência a elementos específicos ou um loop for para iterar sobre todos eles.

Use indexação para referenciar elementos específicos

A sintaxe para indexação é {{ params.array.index.property }}, em que você deve substituir cada placeholder da seguinte forma:

  • array pelo nome exato do array sob o objeto raiz na sua estrutura JSON.
  • index com a posição do elemento que você quer referenciar, começando em 0 para o primeiro elemento.
  • property pelo nome exato da propriedade dentro do elemento do array na sua estrutura JSON.

Dada a estrutura JSON acima:

Entrada Descrição Saída
{{ params.items.0.name }} Nome do primeiro item Sapatos pretos
{{ params.items.1.name }} Nome do segundo item Camisa branca

Use um loop for para iterar sobre todos os elementos

💡 É bom saber
Isso é especialmente útil quando o número de itens na matriz é desconhecido, como uma lista de postagens semanais de blog ou um recibo de produtos comprados.

A sintaxe com um loop for é {% for item in params.array %} {{ item.property }} {% endfor %}, em que você deve substituir cada placeholder da seguinte forma:

  • array pelo nome exato do array sob o objeto raiz na sua estrutura JSON.
  • property pelo nome exato da propriedade dentro do elemento do array na sua estrutura JSON.

Dada a estrutura JSON acima:

Entrada Descrição Saída
{% for item in params.items %} {{ item.name }} {% endfor %} Todos os nomes dos itens

Sapatos pretos

Camisa branca

➡️ Para saber mais sobre loops for, confira nosso artigo dedicado [Manual] Repetir um bloco de itens em seus e-mails usando loops for.

🛢️ Variáveis de feed de dados

Disponível para: ✅ E-mail ✅ SMS ✖️ WhatsApp ✖️ Push

As variáveis de feed de dados permitem que você insira dados em tempo real de uma fonte externa ou API diretamente nas suas mensagens. Para identificar as variáveis disponíveis, acesse Configurações > Gerenciamento de dados > Feed de dados e verifique a estrutura do seu arquivo de origem:

datafeed_valid-manually_en-us.png

Dependendo da complexidade da estrutura do seu feed de dados, o formato varia:

⏫ Dados armazenados diretamente sob o objeto raiz

Os dados armazenados diretamente sob o objeto raiz normalmente contêm a entidade mais relevante e imediata no seu feed, como o próximo evento ou o produto mais recente, e podem ser recuperados sem precisar percorrer matrizes.

A sintaxe é {{ feed.feedalias.variable }}, em que você deve substituir cada placeholder da seguinte forma:

  • feedalias pelo nome exato do alias do seu feed de dados, com a mesma ortografia e política de maiúsculas e minúsculas que aparece na página Data feeds (Feeds de dados).
  • variable pelo nome específico da variável ou do campo que você deseja exibir.

Considerando o feed de dados acima:

Entrada Descrição Saída
{{ feed.next_yoga_class.class_name }} Nome da classe Sunrise Vinyasa
{{ feed.next_yoga_class.studio_location }} Localização do estúdio Estúdio no centro da cidade
{{ feed.next_yoga_class.date }} Data da aula 07-03-2025
{{ feed.next_yoga_class.time }} Horário da aula 06:30 da manhã
↪️ Dados acessíveis de uma matriz sob o objeto raiz

Matrizes armazenadas no objeto raiz podem conter vários elementos, cada um com suas próprias propriedades. Use indexação para referenciar elementos específicos ou um loop for para iterar por todos eles.

Use indexação para referenciar elementos específicos

A sintaxe para indexação é {{ feed.feedalias.array.index.variable }}, em que você deve substituir cada placeholder da seguinte forma:

  • feedalias pelo nome exato do alias do seu feed de dados, com a mesma ortografia e política de maiúsculas e minúsculas que aparece na página Data feeds (Feeds de dados).
  • array com o nome da matriz que contém os valores de cada item. 
  • índice com a posição do item específico que você deseja exibir, começando em 0 para o primeiro item.
  • variable pelo nome específico da variável ou do campo que você deseja exibir, por exemplo, nome, preço ou data.

Considerando o feed de dados acima:

Entrada Descrição Saída
{{ feed.yoga_classes.following_classes.0.class_name }} Nome da primeira aula Power Flow Yoga
{{ feed.yoga_classes.following_classes.1.class_name }} Nome da segunda aula Restaurativa noturna

Use um loop for para iterar sobre todos os elementos

💡 É bom saber
Isso é especialmente útil quando o número de itens na matriz é desconhecido, como uma lista de postagens semanais de blog ou um recibo de produtos comprados.

A sintaxe com um loop for é {% for item in feed.feedalias.array %} {{ item.variable }} {% endfor %}, em que você deve substituir cada placeholder da seguinte forma:

  • feedalias pelo nome exato do alias do seu feed de dados, com a mesma ortografia e política de maiúsculas e minúsculas que aparece na página Data feeds (Feeds de dados).
  • array com o nome da matriz que contém os valores de cada item. 
  • variable pelo nome específico da variável ou do campo que você deseja exibir, por exemplo, nome, preço ou data.

Considerando o feed de dados acima:

Entrada Descrição Saída
{% for item in feed.yoga_classes.following_classes %} {{ item.class_name }} {% endfor %} Todos os nomes das aulas

Power Flow Yoga

Restaurativa noturna

Noções básicas de Hatha Yoga

Yin Yoga e Meditação

...

➡️ Para saber mais sobre loops for, confira nosso artigo dedicado [Manual] Repetir um bloco de itens em seus e-mails usando loops for.

🛒 Variáveis do feed de produtos

Disponível para: ✅ E-mail ✅ SMS ✖️ WhatsApp ✖️ Push

As variáveis do feed de produtos permitem que você exiba uma lista dinâmica de produtos da sua loja online, incluindo detalhes como nome, descrição, preços, imagens e disponibilidade.

product-feed-example.png

A sintaxe é {{ feed.feedalias.products.variable }}, em que você deve substituir cada placeholder da seguinte forma:

  • feedalias é o nome exato do seu feed de produtos, correspondendo à grafia e à política de maiúsculas e minúsculas como aparece na página Feed de produtos.
  • variable pelo nome do campo que você deseja exibir.

Considerando o feed de produtos acima:

Entrada Descrição Saída
{{ feed.mats_bestseller.products.imageUrl }} Imagem do produto black-yoga-mat.png
{{ feed.mats_bestseller.products.name }} Nome do produto Tapete de yoga antiderrapante - 6 mm
{{ feed.mats_bestseller.products.url }} URL do produto https://thegreenyoga.com/non-slip/black-mat.html

Use um loop for para iterar sobre todos os elementos

💡 É bom saber
Isso é especialmente útil quando o número de itens na matriz é desconhecido, como uma lista de postagens semanais de blog ou um recibo de produtos comprados.

A sintaxe com um loop for é {% for item in feed.feedalias.products %} {{ item.variable }} {% endfor %}, em que você deve substituir cada placeholder da seguinte forma:

  • feedalias pelo nome exato do alias do seu feed de dados, com a mesma ortografia e política de maiúsculas e minúsculas que aparece na página Data feeds (Feeds de dados).
  • variable pelo nome específico da variável ou do campo que você deseja exibir, por exemplo, nome, preço ou data.

Considerando o feed de produtos acima:

Entrada Descrição Saída
{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}
Todos os nomes de produtos

Tapete de yoga antiderrapante - 6 mm

Bloco de yoga - 4 polegadas

Calças de yoga de cintura alta e pernas largas

➡️ Para saber mais sobre loops for, confira nosso artigo dedicado [Manual] Repetir um bloco de itens em seus e-mails usando loops for.

📦 Variáveis de objeto

Disponível para: ✅ E-mail
(somente automação)
✅ SMS
(somente automação)
✖️ WhatsApp ✖️ Push

Variáveis de objeto permitem que você inclua detalhes sobre seus objetos personalizados ou os objetos associados a eles nas suas mensagens. Elas só podem ser usadas em automações, pois dependem de um registro de objeto específico ser o gatilho da automação.

Para criar variáveis de objeto, você vai precisar do nome do objeto e dos IDs de atributo na página configuração de objetos personalizados. A sintaxe varia dependendo dos dados que você quer exibir:

Dados do objeto

As variáveis de dados de objeto permitem que você exiba atributos do registro de objeto personalizado que acionou a automação, como o valor de uma cotação ou a data de criação.

A sintaxe é {{ feed.object.attributes.variable }}, em que você deve substituir cada placeholder da seguinte forma:

  • object com o nome no singular do seu objeto personalizado conforme definido quando você o criou.
  • variable com o ID do atributo que você quer exibir, por exemplo, nome, valor ou data. Você pode encontrar IDs de atributos clicando no nome do objeto na página Configurações de objetos personalizados.

Dado um objeto quote com os atributos amount, date, id_quote e paid:

Entrada Descrição Saída
{{ feed.quote.attributes.amount }} Valor do orçamento 350
{{ feed.quote.attributes.date }} Data de criação da cotação 2025-03-29T00:04:11+00:00
{{ feed.quote.attributes.paid }} Status do pagamento true
{{ feed.quote.attributes.id_quote }} ID do orçamento OQPPBDCSSZQ9
Dados do objeto associado

As variáveis de dados de objetos associados permitem exibir atributos de objetos vinculados ao objeto personalizado que acionou a automação. Use indexação para referenciar registros específicos ou um loop for para iterar por todos eles.

Use indexação para referenciar elementos específicos

A sintaxe de indexação é {{ feed.object.associations.associatedobject.index.variable }}, em que você deve substituir cada placeholder da seguinte forma:

  • object com o nome no singular do seu objeto personalizado conforme definido quando você o criou.
  • associatedobject com o nome no singular do seu objeto associado encontrado na aba Associações ao selecionar um objeto personalizado na página de configuração de objetos personalizados.
  • index com a posição do registro de objeto associado que você deseja exibir, começando em 0 para o primeiro registro.
  • variable com o ID do atributo que você quer exibir, encontrado na guia Associações ao selecionar um objeto personalizado na página Configuração de objetos personalizados.

Dado um objeto quote associado a registros de veículo que contêm um atributo de brand:

Entrada Descrição Saída
{{ feed.quote.associations.vehicle.0.brand }} Primeira marca do veículo Renault
{{ feed.quote.associations.vehicle.1.brand }} Marca do segundo veículo Toyota

Use um loop for para iterar sobre todos os elementos

💡 É bom saber
Isso é especialmente útil quando o número de itens na matriz é desconhecido, como uma lista de postagens semanais de blog ou um recibo de produtos comprados.

A sintaxe com um loop for é {% for item in feed.object.associations.associatedobject %} {{ item.variable }} {% endfor %}, em que você deve substituir cada placeholder da seguinte forma:

  • object com o nome no singular do seu objeto personalizado conforme definido quando você o criou.
  • associatedobject com o nome no singular do seu objeto associado encontrado na aba Associações ao selecionar um objeto personalizado na página de configuração de objetos personalizados.
  • variable com o ID do atributo que você quer exibir, encontrado na guia Associações ao selecionar um objeto personalizado na página Configuração de objetos personalizados.

Dado um objeto quote associado a registros de veículo que contêm um atributo de brand:

Entrada Descrição Saída
{% for item in feed.quote.associations.vehicle %}
{{ item.brand }}
{% endfor %}
Marca de todos os registros de veículos associados

Renault

Toyota

Audi

...

➡️ Para saber mais sobre loops for, confira nosso artigo dedicado [Manual] Repetir um bloco de itens em seus e-mails usando loops for.

📅 Variáveis de data

Disponível para: ✅ E-mail ✅ SMS ✖️ WhatsApp ✖️ Push

Insere um carimbo de data/hora da data e hora exatas em que a mensagem foi enviada, com base no fuso horário da conta Brevo. Usa UTC por padrão se nenhum fuso horário estiver definido.

A sintaxe é {{ time_now }}.

Por exemplo:

Entrada Descrição Saída
Hoje é {{ time_now }} Carimbo de data/hora completo Hoje é 2025-03-11 15:10:20.823713502 +0100 CET
Hoje é {{ time_now |date:"Monday, Jan 2, 2006" }} Data formatada usando o filtro date Hoje é terça-feira, 11 de março de 2025

➡️ Para saber mais sobre como ajustar a formatação de datas, confira nosso artigo dedicado Modificar a formatação do seu placeholder com filtros.

🔗 Link de e-mail e variáveis de pré-visualização

Disponível para: ✅ E-mail ✖️ SMS ✖️ WhatsApp ✖️ Push

Coloque estas variáveis dentro de uma tag HTML <a> para permitir que o destinatário veja seu e-mail em um navegador, cancele a inscrição ou gerencie suas preferências.

Os seguintes link de e-mail e variáveis de pré-visualização estão disponíveis:

Entrada Descrição Saída
<a href="{{ mirror }}">Ver no navegador</a> Link espelho Ver no navegador
Se você não quiser mais <a href="{{ unsubscribe }}">Cancelar inscrição</a> Link de cancelamento de inscrição Cancelar inscrição
<a href="{{ update_profile }}">Atualize suas preferências</a> Link de atualização de perfil Atualizar suas preferências
<a href="{{ doubleoptin }}">Confirmo minha assinatura</a> Link de double opt-in Confirmo minha assinatura

➡️ Para saber mais, consulte nossos artigos dedicados:

📢 Declarações condicionais

Disponível para: ✅ E-mail ✖️ SMS ✖️ WhatsApp ✖️ Push

Exibição condicional (instruções if)

Use uma instrução if para mostrar ou ocultar partes de um e-mail com base nos dados de cada remetente

➡️ Para saber mais, confira nosso artigo dedicado [Manual] Mostrar ou ocultar conteúdo em seus e-mails usando instruções if.

Seções repetíveis (para loops)

Use um loop for para exibir dinamicamente todos os elementos em uma matriz, sem referenciar manualmente cada índice.

➡️ Para saber mais, confira nosso artigo dedicado [Manual] Repetir um bloco de itens em seus e-mails usando loops for.

🪄 Filtros

Disponível para: ✅ E-mail ✅ SMS ✖️ WhatsApp ✖️ Push

Os filtros modificam a saída de uma variável e ficam dentro dos colchetes duplos, separados por uma barra vertical |. Vários filtros podem ser combinados.

Por exemplo:

Entrada Descrição Saída
{% for item in feed.yoga_classes.following_classes|slice:'0:3' %} Limita o número de itens a serem exibidos em um loop for

Power Flow Yoga

Restaurativa noturna

Noções básicas de Hatha Yoga

{{ contact.FIRSTNAME|upper }} Converte o nome do destinatário para letras maiúsculas (originalmente: Abby). ABBY
{{ params.TOTAL|floatformat:2 }} Exibe o total do carrinho com duas casas decimais (originalmente: 49,995). 49,99
{{ time_now|date:"02/01/2006" }} Formata a data atual como dd/MM/yyyy (originalmente: 2025-03-11 15:10:20.823713502 +0100 CET). 11/03/2025 

➡️ Para saber mais, confira nosso artigo dedicado Modificar a formatação dos placeholders com filtros.

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.

💬 Este artigo foi útil?

25 de 162 acharam isto útil