Pular para o conteúdo principal
A interpolação substitui placeholders por valores reais em tempo de execução, permitindo integrações que se adaptam a diferentes contextos, períodos e dados.
TipoSintaxeCaso de Uso
Variáveis Simples{{nomeVariavel}}Inserir valores dos parâmetros
DateTime{{now.format(YYYY-MM-DD)}}Data/hora atual com formatação

Quando utilizar

Use interpolação quando precisar:
  • Inserir valores de parâmetros em URLs ou paths de API
  • Adicionar datas dinâmicas às requisições (hoje, ontem, semana passada)
  • Referenciar datas dos datapoints de extração
  • Gerar nomes de arquivos com timestamps
  • Construir query strings parametrizadas

Variáveis Simples

Substitua placeholders por valores dos parâmetros da sua integração. O nome da variável deve corresponder exatamente.
// Input
"users/{{userId}}/orders"
// Params
{ "userId": "123" }
// Output
"users/123/orders"

Utilizando datapoint com variável simples

Para interpolar um valor de datapoint, adicione um query param com o nome do campo do datapoint. O nome do param fica disponível como variável.
// Query Params
{ "userId": "{{userId}}" }
// Path
"users/{{userId}}/orders"
// Se o datapoint tiver userId = "456", o output será
"users/456/orders"

Interpolação DateTime

Insira datas atuais, calcule datas relativas e formate a saída para requisitos de APIs. A interpolação DateTime suporta três prefixos:
PrefixoDescriçãoExemplo
nowData e hora atuais{{now.format(YYYY-MM-DD)}}
todayAlias para now{{today.format(YYYY-MM-DD)}}
date()Data de um campo de dados{{date(order.createdAt).format(YYYY-MM-DD)}}

Padrões de Formato

Use .format(pattern) para controlar a saída. Os padrões seguem os tokens de formato do dayjs.
PadrãoExemplo de Saída
YYYY-MM-DD2026-01-12
DD/MM/YYYY12/01/2026
YYYY-MM-DDTHH:mm:ss2026-01-12T15:30:00
HH:mm:ss15:30:00
MMMM D, YYYYJanuary 12, 2026

Conversão de Timezone

Use .timezone(tz) para converter para um timezone específico antes de formatar. O timezone padrão é America/Sao_Paulo.
{{now.timezone(UTC).format(YYYY-MM-DDTHH:mm:ss)}}
{{now.timezone(America/New_York).format(YYYY-MM-DD)}}
{{now.timezone(Europe/London).format(HH:mm:ss)}}

Aritmética de Datas

Adicione ou subtraia tempo usando .add(amount, unit) e .subtract(amount, unit). Unidades disponíveis: days, weeks, months, years, hours, minutes, seconds
{{now.subtract(1, days).format(YYYY-MM-DD)}} // Ontem
{{now.subtract(7, days).format(YYYY-MM-DD)}} // Uma semana atrás
{{now.add(1, months).format(YYYY-MM-DD)}} // Próximo mês
{{now.add(2, weeks).format(YYYY-MM-DD)}} // Duas semanas a partir de agora

Usando Campos de Dados

Referencie datas dos seus datapoints de extração com a função date(). Passe o caminho do campo como argumento.
{{date(order.createdAt).format(YYYY-MM-DD)}}
{{date(user.lastLogin).add(30, days).format(YYYY-MM-DD)}}
{{date(invoice.dueDate).subtract(7, days).format(YYYY-MM-DD)}}
Isso é útil quando você precisa calcular datas relativas a valores dos dados em vez do horário atual.