Sintaxe avançada

A sintaxe avançada é a linguagem de template que a Olie aceita nos campos que recebem expressão. Esses campos incluem as mensagens e os campos das automações, o corpo customizado de webhook e o prompt dos assistentes de etapa. Com ela, um texto fixo passa a usar os dados do projeto: você insere variáveis, mostra um trecho conforme uma condição, percorre listas e busca dados com a função query. Esta página é a referência da linguagem. Para saber quais dados cada automação recebe, veja Variáveis nas automações.

Conceitos-chave

Variáveis dinâmicas

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

{{ project.name }}
{{ project.customer.name }}
{{ user.email }}

Condicionais (if/else)

Mostre conteúdos diferentes conforme uma condição.

{% if project.customer %}
  Cliente: {{ project.customer.name }}
{% else %}
  Projeto sem cliente vinculado.
{% endif %}

Loops (for)

Percorra uma lista e repita um trecho para cada item.

{% for u in project.users %}
  {{ u|mention }}
{% endfor %}

Filtros

Transforme um valor antes de exibi-lo.Exemplos:

{{ project.name|upper }}
{{ project.created_at|date("d/m/Y") }}
{{ project.users|length }}

Variáveis dinâmicas

Uma variável insere no texto um dado do contexto, como o nome do projeto ou do cliente.

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: Oficina Norte
Status: 1

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

Resultado:

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

Verificação de existência

Nem toda variável existe em todo contexto. A variável user, por exemplo, só existe quando uma pessoa disparou a automação. Para evitar erro, verifique a variável com is defined antes de usá-la:

{% if user is defined %}
  Movido por {{ user.name }}.
{% else %}
  Disparo sem pessoa associada.
{% endif %}

Condicionais

Uma condicional mostra um trecho ou outro conforme o valor de um dado.

Estrutura if/else

If simples
If/Else
If/Elseif/Else

{% if project.budget >= 100000 %}
  Projeto com orçamento a partir de R$ 100 mil.
{% 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 < 6 %}
  🚀 Projeto de médio impacto
{% else %}
  📋 Projeto de baixo impacto
{% endif %}

Operadores de comparação

Os operadores abaixo servem dentro de if e elseif:

Igualdade e diferença

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

Comparações numéricas

{% if valor > 18 %}       {# Maior que #}
{% if valor >= 18 %}      {# Maior ou igual #}
{% if valor < 18 %}       {# Menor que #}
{% if valor <= 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)

Um laço (for) percorre uma lista e repete um trecho para cada item.

Estrutura básica

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

Lista simples
Com índice
Com condicionais
Loop vazio

As etiquetas não vêm no contexto, então o exemplo as busca com query antes do laço:

Etiquetas do projeto:
{% set p = query('project_details', { 'project_code': project.code }) %}
{% for tag in p.tags %}
- {{ tag.name }}
{% endfor %}

Resultado:

Etiquetas do projeto:
- Aguardando retorno
- Prioridade alta

{% 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

{% set p = query('project_details', { 'project_code': project.code }) %}
{% for tag in p.tags %}
  {% if tag.name == 'Aguardando retorno' %}
    ⏳ Projeto aguardando retorno do cliente
  {% endif %}
{% endfor %}

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

O bloco else roda quando a lista está vazia.

Loops com ranges

Um range, como 1..5, gera uma sequência numérica para o laço percorrer:

{% 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

Filtros

Um filtro transforma um valor antes de exibi-lo. Ele vem depois de uma barra vertical (|), e vários filtros podem ser encadeados.

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 indentação #}

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

{{ valor|round }}             {# Arredonda #}
{{ valor|round(2) }}          {# 2 decimais #}

{{ data|date("d/m/Y") }}      {# 21/01/2026 #}
{{ data|date("d/m/Y H:i") }}  {# 21/01/2026 14:30 #}
{{ data|date("F Y") }}        {# January 2026 #}
{{ project.created_at|date_modify("+15 days")|date("Y-m-d") }}  {# Soma 15 dias #}

Nomes de mês e de dia da semana saem em inglês: F vira “January”, e l vira “Friday”. Para um texto em português, use formatos numéricos, como d/m/Y.

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

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

Outros filtros úteis

Estes filtros completam a lista:

mention

Transforma um usuário, ou uma lista de usuários, em menção.

{{ user|mention }}
{{ project.users|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 }}

json

Converte para JSON. Serve para inspecionar um dado no registro de execução e para devolver uma lista em campos que esperam lista.

{{ lista|json }}              {# Converte para JSON #}
{{ lista|json(true) }}        {# Converte para JSON com indentaçã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

A tabela lista as consultas, os parâmetros de cada uma e o que elas devolvem:

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. Corrija o nome ou o parâmetro conforme a tabela de consultas disponíveis.

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

A sintaxe avançada é baseada no Twig, uma linguagem de templates. A Olie roda as expressões em um ambiente controlado: só um conjunto conhecido de blocos, filtros e funções é permitido, e há limites de laço, consultas e tempo. Os valores estão em Limites do mecanismo. A documentação oficial do Twig explica a linguagem em detalhe. Um recurso do Twig que não aparece nesta página pode não estar liberado na Olie.

Documentação do Twig

A referência completa da linguagem Twig.

Começando

Conceitos fundamentais

Implantação

Funis e etapas

Projetos

Formulários dinâmicos

Metas

Automação

Inteligência artificial

Integrações

Conta

Sintaxe avançada

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

Outros filtros úteis

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 do Twig

​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

​Outros filtros úteis

​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 do Twig

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

Outros filtros úteis

Funções de consulta

Sintaxe

Consultas disponíveis

Exemplos

Cuidados

Como funciona o mecanismo