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: | ✅ SMS | ✅ 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:
|
data é o objeto raiz que contém as seguintes propriedades:
|
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:
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 |
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
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: | ✅ SMS | ✖️ 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:
Dependendo da complexidade da estrutura do seu feed de dados, o formato varia:
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ã |
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
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: | ✅ SMS | ✖️ 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.
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 | |
| {{ 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
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) |
✖️ 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:
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 |
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
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: | ✅ SMS | ✖️ 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: | ✖️ SMS | ✖️ 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:
- 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
📢 Declarações condicionais
| Disponível para: | ✖️ SMS | ✖️ 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: | ✅ SMS | ✖️ 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.