Skip to main content

Código JavaScript

Executa um bloco de código JavaScript personalizado dentro do fluxo de automação e retorna o valor produzido. Ideal para operações que não possuem uma ação dedicada — como cálculos complexos, transformações de dados, formatações específicas ou manipulações avançadas de objetos e listas.

Dica

Use return no seu código para definir o valor que será retornado pela ação e disponível para as próximas etapas do fluxo.


Opções

Código

Escreva o bloco de código JavaScript que será executado. Use return para definir o valor de retorno.

Acessando saídas de ações anteriores

O objeto actions está disponível dentro do código e contém os retornos de todas as ações que vieram antes no fluxo. Use o ID ou o alias da ação para acessar seus campos:

// Sintaxe: actions["id_ou_alias"]["campo"]
const texto = actions["lerTexto"]["value"]
const numero = actions["calcularTotal"]["value"]

// Combinando em uma expressão
return `Resultado: ${actions["buscarNome"]["value"]} (${actions["lerCodigo"]["value"]})`
tip

O editor mostra autocomplete dos IDs e campos disponíveis ao digitar actions[".

Acessando parâmetros do robô

Use a sintaxe de duplas chaves dentro de template literals para embutir parâmetros:

const url = `https://api.exemplo.com/{{PARAMETROS.endpoint}}`
const token = `{{PARAMETROS.token_api}}`
return token

Para segredos (parâmetros marcados como senha), use {{SEGREDOS.nome}}.

Não escapar símbolo do dólar "$"

Define se o símbolo $ no código será tratado literalmente, sem escape automático. Selecione Sim quando o código contiver templates literais com a sintaxe ${...} e o comportamento padrão de escape estiver interferindo.

Retornos

Código Javascript

actions["id-da-acao"].value // valor retornado pelo código customizado (Qualquer)

Seleção de campos

  • value — valor produzido pelo código executado (Qualquer)

Regras e Condições

  • O campo Código é obrigatório.
  • O código deve usar return para definir o valor de retorno — sem return, a ação retornará vazio.
  • O código é executado em ambiente isolado com acesso às variáveis do fluxo.
  • Erros de sintaxe ou exceções não tratadas no código interrompem a execução do robô.

Usando bibliotecas externas

Além das bibliotecas nativas, é possível instalar qualquer pacote npm e usá-lo no código. Consulte o tutorial Instalar bibliotecas Node.js externas para o passo a passo completo.