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.

Na linguagem de modelo do Brevo, as variáveis devem ser colocadas entre colchetes duplos, como {{ ... }} ou {{...}}. Elas podem ser usadas para inserções simples ou combinados com instruções condicionais e filtros para personalização avançada.

A linguagem de modelo Brevo suporta diferentes tipos de variáveis:

👤 Variáveis de contato

As variáveis de contato permitem que você exiba dados dos atributos do seu contato, como o nome do contato, em suas mensagens. Essas variáveis são formatadas como {{ contact.ATTRIBUTE }}, onde você deve substituir ATTRIBUTE pelo nome exato do atributo do seu contato, conforme ele aparece na página Atributo de contato na sua conta Brevo. Você pode usar o atributo Brevo padrão e atributos personalizados.

Aqui estão alguns exemplos de variáveis de contato com três atributos Brevo padrão e um atributo personalizado:

➡️ Para saber mais sobre os diferentes tipos de atributo de contato disponíveis e como criar os personalizados, confira nossos artigos dedicados:

• Sobre atributos de contato
• Criar e gerenciar atributos de contato

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

O link de e-mail e as variáveis de pré-visualização permitem que os destinatários visualizem seu e-mail no navegador, cancelem a assinatura de suas comunicações e gerenciem suas preferências. Essas variáveis devem ser colocadas dentro de uma etiqueta HTML <a> , envolvendo o texto que será exibido no e-mail.

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

➡️ Para saber mais, consulte nossos artigos dedicados:

• Insira um link "Ver no navegador" em suas campanhas
• Insira um link de cancelamento de inscrição em suas campanhas
• Atualize seus dados e preferências de contatos (formulário de atualização de perfil)
• Criar um modelo de e-mail personalizado de double opt-in (DOI) para um formulário de assinatura criado na Brevo

📅 Variáveis de data

Variáveis de data permitem que você insira um registro de data e hora exatas em que um e-mail foi enviado. A data é baseada no fuso horário da sua conta Brevo. Se nenhum fuso horário estiver definido em sua conta, a variável assumirá como padrão o registro de data e hora atual em UTC. 

A seguinte variável de data está disponível:

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

⚡ Variáveis de evento

Variáveis de evento permitem que você exiba 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 variáveis de eventos para sua mensagem, verifique sua API de chamada ou log de eventos na Brevo. Aqui está um exemplo de uma estrutura JSON típica, onde:

data é o objeto raiz que contém as seguintes propriedades: id → o ID do carrinho total → valor total do carrinho currency → o tipo de moeda url → um link para o 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

As variáveis de evento são formatadas usando chaves duplas. Cada dado na estrutura JSON pode ser incluído em uma variável de evento para personalizar suas mensagens:

{% for item in params.items %}
{{ item.name }}
{% endfor %}

🛢️ Variáveis de feed de dados

As variáveis defeed de dados permitem que você personalize suas comunicações de marketing enviadas com a Brevo com as informações mais recentes sobre produtos, clientes, eventos ou quaisquer outros dados relevantes de sua fonte de dados externa ou API. Use-as para automatizar e personalizar suas mensagens com dados em tempo real. 

Para identificar variáveis de feed de dados para sua mensagem, clique no menu suspenso conta e selecione Configurações > Gerenciamento de dados > Feed de dados para verificar a estrutura do arquivo de origem na Brevo:

As variáveis de feed de dados são formatadas usando chaves duplas. Dependendo da complexidade da estrutura do feed de dados, o formato das variáveis do seu feed de dados varia: 

{% for item in feed.yoga_classes.following_classes %}
{{ item.class_name }}
{% endfor %}

🛒 Variáveis do feed de produtos

As variáveis do feed de produtos permitem que você exiba uma lista dinâmica de produtos da sua loja online, facilitando a criação de recomendações personalizadas. Ela contém detalhes do produto, como nome, descrição, preços, imagens e disponibilidade. Use-a para destacar itens populares, personalizar recomendações ou manter exibições consistentes de produtos em suas campanhas de marketing.

As variáveis de feed de dados são formatadas usando chaves duplas:

{{ feed.feedalias.products.variable }}

Você deve substituir:

• 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 é o nome do campo na API que contém os dados que você deseja recuperar.

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

Exibir todos os elementos usando um loop for

Use um loop for para exibir dinamicamente todos os elementos em uma matriz. Em vez de referenciar manualmente cada índice, o loop itera pela matriz e exibe cada item automaticamente. 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.

Por exemplo, se quisermos mostrar o nome de cada item no feed de produtos mats_bestseller, o loop for correspondente seria:

{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}

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

📢 Declarações condicionais

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

Use uma instrução if para mostrar ou ocultar partes do seu e-mail com base nos dados de cada remetente. Isso permite que você envie um único e-mail que se adapta dinamicamente a diferentes contatos, dependendo de condições específicas.

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

🔁 Seções repetíveis (loops for)

Use um loop for para exibir dinamicamente todos os elementos em uma matriz. Em vez de referenciar manualmente cada índice, o loop itera pela matriz e exibe cada item automaticamente. 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.

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

🪄 Filtros

Filtros modificam a saída de uma variável transformando seu valor. Eles são colocados dentro dos colchetes duplos da variável e separados por uma barra vertical |, por exemplo, {{ contact.FIRSTNAME|upper }}. Você também pode encadear vários filtros, com cada filtro aplicando sua transformação ao resultado do anterior.

Aqui estão alguns exemplos de variáveis usadas junto com filtros para modificar sua saída:

➡️ 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.