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.
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"]})`
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
returnpara definir o valor de retorno — semreturn, 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.