Variáveis, também conhecidas como tags de personalização ou de mesclagem, permitem que você insira dados personalizados para cada destinatário, como nome ou compra mais recente. Os filtros modificam a forma como esses dados são exibidos. 

Como usar filtros?

Você usa filtros dentro de chaves duplas {{ }} com uma barra vertical |. Por exemplo:

Você pode encadear vários filtros, de forma que a saída de um filtro seja transmitida para o próximo. Por exemplo:

Para inserir uma variável com filtros em uma mensagem, você pode:

• Digitar a variável e os filtros manualmente, ou

  

• Selecionar uma variável existente e editar a sintaxe na guia Advanced settings (Configurações avançadas).

  

💬 Insira um valor padrão

default

Insere um valor alternativo caso uma variável esteja vazia.

🔠 Formatar a capitalização da palavra

capfirst

A primeira letra é maiúscula.

title

A primeira letra de cada palavra começa com letra maiúscula.

upper

Converte todos os caracteres em maiúsculas.

lower

Converte todos os caracteres em minúsculas.

truncatechars

Reduz uma string a N caracteres. Valores truncados terminarão com reticências (…) incluídas na contagem de caracteres.

🔢 Formate números

floatformat

Arredonda valores de ponto flutuante para um número específico de casas decimais.

integer

Converte um número em formato de string ou ponto flutuante em um número inteiro.

float

Converte um número em formato string ou inteiro em um número de ponto flutuante.

lang_format

Formata números de acordo com um idioma.

📅 Formate data e horário

time_parse

Converte uma string de data em um carimbo de data/hora padrão que pode ser usado com outros filtros, como date ou date_i18n.

Ao passar o formato de data como argumento, escreva a data e a hora exatamente como a hora de referência apareceria se fosse o valor.

date

Converte um carimbo de data e hora ou uma data analisada em um formato específico. Use-o com uma data analisada por meio de time_parse ou com a hora atual usando time_now.

date_i18n

Converte um carimbo de data e hora ou uma data analisada em um formato especificado, com a saída exibida em um idioma especificado. Este filtro funciona como a data, mas primeiro você precisa especificar o idioma e, em seguida, o formato.

Os idiomas compatíveis são inglês, francês, italiano, espanhol, alemão e português.

time_add_date

Adiciona anos, meses e dias a um carimbo de data e hora ou a uma data analisada. Você deve especificar a hora a ser adicionada no formato ano, mês, dia.

time_in_location

Converte um carimbo de data e hora ou uma data analisada em um fuso horário específico. Você deve especificar o fuso horário no formato local/fuso horário.

time_add_duration

Adiciona horas, minutos e segundos a um carimbo de data e hora ou a uma data analisada. Você deve especificar o valor no formato h,m,s e transmitir pelo menos um valor (hora, minuto ou segundo) no filtro.

time_unix

Converte um valor horário em uma timestamp Unix em segundos.

time_unix_nano

Converte um valor de tempo em uma timestamp Unix em nanosegundos.

🧑‍💻 Dados codificados ou criptografados

base64_encode ou decode

Codifica ou decodifica 64:

• base64_decode decodifica uma string para um []byte
• base64_encode codifica um []byte para uma string

Os filtros base64_encode e decode podem ser um parâmetro de codificação opcional:

• std: codificação base64 encoding normal,
• raw_std: codificação base64 normal, sem o = caracteres de preenchimento,
• url: versão segura da URL de codificação base64 encoding, + e / são substituídos respectivamente por - e _,
• raw_url: uma combinação de raw e url.

aes_128, 192 ou 256

Criptografa um valor. Por exemplo, você pode usar esse filtro para enviar informações criptografadas de contato em um URL, como um endereço de e-mail ou uma ID.

A variante de AES depende do comprimento da chave fornecida:

Por exemplo, para a variante AES-256, a variável deve ser formatada como {{ contact.ATTRIBUTE | aes_256:'key' }}, onde a chave:

• Tem 32 dígitos.
• Foi gerada aleatoriamente.
• Tem que ter persistido em sua ponta para poder decodificar o valor original.

Por padrão, se nenhum parâmetro de codificação for adicionado, base64 std será usado. Caso contrário, ele também suporta:

• raw_std: codificação base64 normal, sem o = caracteres de preenchimento,
• url: versão segura da URL de codificação base64 encoding, + e / são substituídos respectivamente por - e _,
• raw_url: uma combinação de raw e url.

🔎 Outros filtros

first

Retorna o primeiro item de uma sequência, um mapeamento ou uma string.

join

Combina os itens de uma matriz em uma única string, usando o argumento como um separador.

O separador entre elementos é vazio por padrão. Você pode defini-lo com o primeiro parâmetro opcional.

last

Retorna o último item de uma sequência, mapeamento ou string.

length

Retorna o número de itens de uma sequência ou mapeamento ou o tamanho de uma string.

safe

Marca uma string como não exigindo mais escapamento HTML antes de saída.

Sem o filtro safe, a tag HTML seria exibida como uma string normal no e-mail do destinatário: "<p>Esta é minha frase teste</p>" ou "Welcome to <b>Brevo</b>, we're glad to have you here".

slice

Extrai um pedaço de uma sequência, mapeamento ou string.

Este filtro pode ser configurado para:

Em cada elemento, considere que sua matriz contém o seguinte: ["a","b","c","d","e","f","g","h"...]

verbatim

Na Brevo, as variáveis são escritas usando chaves duplas como {{ params.property }}. Quando você inclui chaves duplas como {{ this }} em seu e-mail, o Brevo o trata como um elemento do modelo.

Para exibir {{ }} como texto simples em seu e-mail, envolva o conteúdo em um bloco {% verbatim %}:

autoescape

Por padrão, a Brevo escapa todo o conteúdo variável, incluindo HTML e JavaScript. Isso significa que, se sua variável contiver HTML (por exemplo, <h1>Meu título</h1>), ela será exibida como texto simples em vez de renderizada como HTML.

Para permitir a renderização de HTML, você precisa desativar o escape automático usando a tag {% autoescape off %}. Envolva a variável neste bloco e feche-o com {% endautoescape %}:

{% autoescape off %}{{ params.my_html }}{% endautoescape %}

📖 Recursos adicionais

A Linguagem do modelo Brevo se baseia no Pongo2, uma reimplementação do Django in Go (uma linguagem de programação).

Todas as tags suportadas

autoescape, comment, cycle, filter, firstof, for, if, ifchanged, now, set, spaceless, templatetag, with.

Todos os filtros suportados

escape, safe, escapejs, add, addslashes, capfirst, center, cut, date, default, default_if_none, divisibleby, first, floatformat, get_digit, iriencode, join, last, length, length_is, linebreaks, linebreaksbr, linenumbers, ljust, lower, make_list, phone2numeric, pluralize, random, removetags, rjust, slice, stringformat, striptags, time, title, truncatechars, truncatechars_html, truncatewords, truncatewords_html, upper, urlencode, urlize, urlizetrunc, wordcount, wordwrap, yesno.

Todos os filtros suportados para algorítimos hash

hash_md5, hash_sha256, hash_sha256_224, hash_sha512, hash_sha512_224, hash_sha512_256, hash_sha512_384, hash_sha3_224, hash_sha3_256, hash_sha3_384, hash_sha3_512.

🤔 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.