Sintaxe avançada

Esse recurso requer conhecimento de lógica e normalmente é usada por usuários avançados.

Visão geral

É possível utilizar sintaxe avançada para deixar os blocos de texto, automações e templates ainda mais inteligentes e adaptáveis ao contexto. Essa funcionalidade permite incorporar lógica condicional, iteração de listas, e até chamadas de funções de consulta.

A sintaxe avançada transforma conteúdos estáticos em templates dinâmicos que se adaptam automaticamente aos dados disponíveis.

Conceitos-chave

Variáveis dinâmicas

Acesse dados com chaves delimitadas por {{ ... }}.Exemplos:

{{ nome }}
{{ etapa.atual }}
{{ project.data_inicio }}

Condicionais (if/else)

Mostre conteúdos diferentes baseado em condições lógicas.

{% if cliente.vip %}
  Bem-vindo, cliente especial!
{% else %}
  Olá! Obrigado por estar conosco.
{% endif %}

Loops (for)

Itere sobre listas e gere blocos repetitivos.

{% for item in pedidos %}
  Pedido nº {{ item.numero }}
{% endfor %}

Filtros

Transforme dados com funções especiais.Exemplos:

{{ nome|upper }}
{{ data|date("d/m/Y") }}
{{ itens|length }}

Variáveis dinâmicas

As variáveis permitem inserir dados dinamicamente no conteúdo.

Sintaxe básica

{{ variavel }}

Variáveis simples
Variáveis aninhadas
Arrays e listas

Olá, {{ user.name }}!
Seu e-mail é {{ user.email }}.

Resultado:

Olá, João Silva!
Seu e-mail é [email protected].

Projeto: {{ project.code }} - {{ project.name }}
Cliente: {{ project.customer.name }}
Status: {{ project.status }}

Resultado:

Projeto: P-1 - Website Institucional
Cliente: Acme Corp
Status: 1

{% set lista = ['A', 'B', 'C'] %}
Primeiro item: {{ lista[0] }}
Último item: {{ lista[-1] }}
Total de itens: {{ lista|length }}

Resultado (se lista = [‘A’, ‘B’, ‘C’]):

Primeiro item: A
Último item: C
Total de itens: 3

Verificação de existência

Antes de usar uma variável, você pode verificar se ela existe:

{% if variavel is defined %}
  A variável existe: {{ variavel }}
{% else %}
  A variável não está disponível
{% endif %}

Use is defined para evitar erros quando uma variável pode não estar disponível em todos os contextos.

Condicionais

Condicionais permitem exibir conteúdo diferente baseado em condições.

Estrutura if/else

If simples
If/Else
If/Elseif/Else

{% if usuario.idade >= 18 %}
  Você é maior de idade.
{% endif %}

{% if project.impact < 3 %}
  ⚠️ URGENTE: Este projeto requer atenção imediata!
{% else %}
  📋 Projeto regular
{% endif %}

{% if project.impact < 3 %}
  ✅ Projeto de alto impacto
{% elseif project.impact < 5 and project.impact > 3 %}
  🚀 Projeto de médio impacto
{% else %}
  ⚠️ Projeto de baixo
{% endif %}

Operadores de comparação

Igualdade e diferença

{% if valor == 10 %}      {# Igual a #}
{% if valor != 10 %}      {# Diferente de #}

Comparações numéricas

{% if idade > 18 %}       {# Maior que #}
{% if idade >= 18 %}      {# Maior ou igual #}
{% if idade < 18 %}       {# Menor que #}
{% if idade <= 18 %}      {# Menor ou igual #}

Operadores lógicos

{% if a and b %}          {# E lógico #}
{% if a or b %}           {# OU lógico #}
{% if not a %}            {# NÃO lógico #}

Testes especiais

{% if variavel is defined %}     {# Está definida #}
{% if variavel is null %}        {# É nula #}
{% if variavel is empty %}       {# É vazia #}
{% if numero is even %}          {# É par #}
{% if numero is odd %}           {# É ímpar #}

Loops (for)

Loops permitem iterar sobre listas e arrays para gerar conteúdo repetitivo.

Estrutura básica

{% for item in lista %}
  {{ item }}
{% endfor %}

Lista simples
Com índice
Com condicionais
Loop vazio

Membros da equipe:
{% for membro in equipe %}
- {{ membro.nome }} ({{ membro.cargo }})
{% endfor %}

Resultado:

Membros da equipe:
- João Silva (Desenvolvedor)
- Maria Santos (Designer)
- Carlos Oliveira (Gerente)

{% for item in lista %}
  {{ loop.index }}. {{ item }}
{% endfor %}

Variáveis especiais do loop:

loop.index - Índice atual (começa em 1)
loop.index0 - Índice atual (começa em 0)
loop.first - True na primeira iteração
loop.last - True na última iteração
loop.length - Total de itens

{% for tarefa in tarefas %}
  {% if tarefa.status == 'pendente' %}
    ⏳ {{ tarefa.nome }} - Pendente
  {% endif %}
{% endfor %}

{% for item in lista %}
  - {{ item }}
{% else %}
  Nenhum item encontrado.
{% endfor %}

O bloco else é executado se a lista estiver vazia.

Loops com ranges

{% for i in 1..5 %}
  Número {{ i }}
{% endfor %}

Resultado:

Número 1
Número 2
Número 3
Número 4
Número 5

Use ranges para criar sequências numéricas facilmente.

Filtros

Filtros transformam dados antes de exibi-los.

Sintaxe de filtros

{{ variavel|filtro }}
{{ variavel|filtro(parametro) }}
{{ variavel|filtro1|filtro2 }}

Texto
Números
Datas
Arrays
Objetos

{{ nome|upper }}              {# JOÃO SILVA #}
{{ nome|lower }}              {# joão silva #}
{{ nome|capitalize }}         {# João silva #}
{{ nome|title }}              {# João Silva #}
{{ texto|trim }}              {# Remove espaços #}
{{ texto|length }}            {# Conta caracteres #}
{{ texto|json }}              {# Converte para JSON #}
{{ texto|json(true) }}        {# Converte para JSON com identação #}

{{ preco|number_format(2, ',', '.') }}
{# 1.234,56 #}

{{ valor|round }}             {# Arredonda #}
{{ valor|round(2) }}          {# 2 decimais #}
{{ valor|abs }}               {# Valor absoluto #}

{{ data|date("d/m/Y") }}      {# 21/01/2026 #}
{{ data|date("d/m/Y H:i") }}  {# 21/01/2026 14:30 #}
{{ data|date("F Y") }}        {# Janeiro 2026 #}

{{ lista|length }}            {# Tamanho #}
{{ lista|first }}             {# Primeiro item #}
{{ lista|last }}              {# Último item #}
{{ lista|join(', ') }}        {# Une com vírgula #}
{{ lista|reverse }}           {# Inverte ordem #}
{{ lista|sort }}              {# Ordena #}
{{ lista|unique }}            {# Remove duplicatas #}
{{ lista|json }}              {# Converte para JSON #}
{{ lista|json(true) }}        {# Converte para JSON com identação #}

{{ objeto|json }}              {# Converte para JSON #}
{{ objeto|json(true) }}        {# Converte para JSON com identação #}

Filtros especiais da Olie

mention

Cria uma menção de usuário automaticamente.

{{ usuario|mention }}

Saiba mais sobre menções →

default

Define um valor padrão se a variável for vazia.

{{ nome|default('Nome não informado') }}

escape

Escapa caracteres especiais para segurança.

{{ texto|escape }}
{{ texto|e }}  {# Atalho #}

json

Converte para JSON. Muito útil para debugar e exibir dados em formato JSON.

{{ lista|json }}              {# Converte para JSON #}
{{ lista|json(true) }}        {# Converte para JSON com identação #}

Funções de consulta

Nem tudo que você precisa está disponível no contexto. A função query busca o que falta, direto da plataforma, no meio da expressão.

Sintaxe

query('nome_da_consulta', { 'parametro': valor })

O retorno é uma estrutura de dados, não um texto — por isso query quase sempre vem com set:

{% set p = query('project_details', { 'project_code': project.code }) %}
{{ p.name }}

Consultas disponíveis

Consulta	Parâmetros	Devolve
`project_details`	`project_code` ou `id`	O projeto completo, com etiquetas, funis, etapas e respostas
`project_dynamic_forms`	`project_code`	Os formulários dinâmicos do projeto; cada item traz `pivot` e `form_answers`
`project_medias`	`project_code`	`medias` (o conteúdo publicado no projeto) e `pagination`
`get_form_answers`	`pivot` — opcionais: `edge_id`, `format`	As respostas de um formulário, dentro de `response`
`user_details`	`user_id`	Os dados de um usuário
`user_email`	`user_id`	O e-mail principal do usuário, como texto

Exemplos

Etiquetas do projeto
Respostas de um formulário
E-mail de um responsável
Descobrir o formato

Etiquetas não vêm carregadas no contexto — é preciso buscá-las:

{% set p = query('project_details', { 'project_code': project.code }) %}
{% for tag in p.tags %}{{ tag.name }}{% if not loop.last %}, {% endif %}{% endfor %}

get_form_answers precisa do pivot — o endereço que diz onde o formulário está anexado. Ele vem pronto de project_dynamic_forms, e as duas consultas se encadeiam:

{% set formularios = query('project_dynamic_forms', { 'project_code': project.code }) %}
{% for f in formularios %}
  {% set respostas = query('get_form_answers', { 'pivot': f.pivot }) %}
  {{ respostas.response|json(true) }}
{% endfor %}

{% for u in project.users %}{{ query('user_email', { 'user_id': u.id }) }}
{% endfor %}

Na dúvida sobre o que a consulta devolve, imprima tudo uma vez e olhe o resultado no registro de execução:

{{ query('project_medias', { 'project_code': project.code })|json(true) }}

Cuidados

Limite de consultas

Cada expressão pode executar no máximo 50 consultas. Um query dentro de um laço conta uma vez por iteração — cuidado ao consultar dentro de for.

Quando a consulta não encontra nada

O retorno é nulo. Proteja antes de usar:

{% set p = query('project_details', { 'project_code': project.code }) %}
{% if p %}{{ p.name }}{% else %}Projeto não encontrado{% endif %}

Nome ou parâmetro errado

Um nome de consulta que não existe, ou a falta de um parâmetro obrigatório, interrompe a expressão e registra template_error. O registro de execução mostra a mensagem.

Escopo e repetição

As consultas são resolvidas sempre dentro da sua própria conta — não há como acessar dados de outra. E a mesma consulta, com os mesmos parâmetros, é reaproveitada em vez de repetida.

Variáveis nas automações

O que já vem carregado no contexto de uma automação — e, portanto, dispensa query.

Formulários dinâmicos e o pivot

O que é o pivot, por que ele muda de formato e como descobrir o endereço certo.

Como funciona o mecanismo

Por trás da sintaxe avançada, a plataforma utiliza um mecanismo baseado no Twig, uma das engines de templates mais modernas e seguras do ecossistema web.

O Twig é amplamente adotado por frameworks robustos e foi adaptado aqui para permitir automação lógica dentro dos conteúdos da plataforma, de forma controlada e intuitiva.

Documentação oficial do Twig

Para usuários avançados ou desenvolvedores, vale a pena conferir a documentação oficial do Twig para explorar todo o potencial da sintaxe:

Documentação do Twig

Acesse a documentação completa do Twig para aprender sobre recursos avançados, filtros adicionais e melhores práticas.

Começando

Conceitos fundamentais

Funis e etapas

Projetos

Formulários dinâmicos

Metas

Automação

Inteligência artificial

Integrações

Conta

Implantação

Sintaxe avançada

Visão geral

Conceitos-chave

Variáveis dinâmicas

Condicionais (if/else)

Loops (for)

Filtros

Variáveis dinâmicas

Sintaxe básica

Verificação de existência

Condicionais

Estrutura if/else

Operadores de comparação

Loops (for)

Estrutura básica

Loops com ranges

Filtros

Sintaxe de filtros

Filtros especiais da Olie

Funções de consulta

Sintaxe

Consultas disponíveis

Exemplos

Cuidados

Variáveis nas automações

Formulários dinâmicos e o pivot

Como funciona o mecanismo

Documentação oficial do Twig

Documentação do Twig

​Visão geral

​Conceitos-chave

Variáveis dinâmicas

Condicionais (if/else)

Loops (for)

Filtros

​Variáveis dinâmicas

​Sintaxe básica

​Verificação de existência

​Condicionais

​Estrutura if/else

​Operadores de comparação

​Loops (for)

​Estrutura básica

​Loops com ranges

​Filtros

​Sintaxe de filtros

​Filtros especiais da Olie

​Funções de consulta

​Sintaxe

​Consultas disponíveis

​Exemplos

​Cuidados

Variáveis nas automações

Formulários dinâmicos e o pivot

​Como funciona o mecanismo

​Documentação oficial do Twig

Documentação do Twig

Visão geral

Conceitos-chave

Variáveis dinâmicas

Sintaxe básica

Verificação de existência

Condicionais

Estrutura if/else

Operadores de comparação

Loops (for)

Estrutura básica

Loops com ranges

Filtros

Sintaxe de filtros

Filtros especiais da Olie

Funções de consulta

Sintaxe

Consultas disponíveis

Exemplos

Cuidados

Como funciona o mecanismo

Documentação oficial do Twig