Código

O nó Código permite que você execute JavaScript personalizado dentro do seu fluxo. É útil para operações que não podem ser realizadas com nós padrão: transformar dados, realizar cálculos, manipular texto, assinar requisições ou integrar lógica de negócio personalizada. O painel do nó está organizado em três abas:

Configuração — o editor de JavaScript, formatação, cheat sheet, autocompletar e a seção DLP.
Avançado — o caminho de erro padrão que decide para onde o fluxo vai caso o script falhe.
Eventos — eventos de rastreamento que disparam quando o nó é executado, para alimentar suas métricas.

Configuração do editor

O editor de código traz ferramentas para agilizar a escrita e a depuração:

Formatar: aplica o Prettier ao script e adiciona automaticamente await nos métodos assíncronos que precisarem.
Cheat sheet: abre uma referência rápida com os objetos globais disponíveis ($context, $memory, $user, $message, $input, $output, $utils) e seus métodos.
Autocompletar: ao digitar $, o editor sugere as funções e namespaces disponíveis junto com a descrição.
Modo claro / escuro: alterne o tema do editor pelo seletor no canto superior direito.
Validação em tempo real: o editor sinaliza erros comuns de lint e avisa quando falta await em um método assíncrono.

Acessando variáveis

Dentro do nó de Código você pode ler e escrever variáveis do fluxo usando objetos globais predefinidos.

Contexto (`$context`)

Variáveis que persistem apenas durante a execução atual do fluxo:

// Read
const name = $context.get('name')
const name = $context.get('name', 'John') // with default value

// Write
$context.set('lastOrder.status', 'delivered')
$context.set('user', { name: 'John', plan: 'gold' })

Memória (`$memory`)

Variáveis que persistem entre workflows, ferramentas e nós. Suportam time-to-live (TTL):

// Primitives (string, number, boolean) - optional TTL
$memory.set('name', 'John')
$memory.set('attempts', 3, 3600) // expires in 1 hour

// JSON - TTL required (in seconds, maximum 86,400 = 1 day)
$memory.setJson('user', { name: 'John', plan: 'gold' }, 86400)

// Files - async, TTL required (maximum 604,800 = 1 week)
await $memory.setFile('receipt', base64String, 604800, 'application/pdf')

Leitura

const name = $memory.get('name')
const user = $memory.getJson('user')
const url = $memory.getFile('receipt').toUrl()           // temporary URL
const base64 = await $memory.getFile('receipt').toBase64()

Exclusão

$memory.delete('temporary')
$memory.delete(['tmp1', 'tmp2', 'cache']) // multiple keys

Limites por tipo de dado

Tipo	Tamanho máximo	TTL	TTL máximo
String	255 caracteres	Opcional	—
Number	15 dígitos	Opcional	—
Boolean	—	Opcional	—
JSON	15 KB	Obrigatório	86.400s (1 dia)
File	10 MB	Obrigatório	604.800s (1 semana)

Os métodos $memory.setFile(), $memory.getFile().toBase64() e $memory.getFile().toRaw() são assíncronos. Você deve usar await ao chamá-los.

Migração de nós legados

Crie um novo nó Code (Memory V2).
Copie e cole o script do nó legado.
Use os novos métodos disponíveis ($memory.setJson, $memory.setFile, etc.) se necessário.

Usuário (`$user`)

Informações sobre o contato que interage com seu fluxo:

const userId = $user.get('id')
const userName = $user.get('names')

Mensagem (`$message`)

A última mensagem enviada pelo usuário:

const text = $message.get('text')
const type = $message.get('type')       // TEXT, IMAGE, AUDIO, VIDEO, LOCATION, FILE
const attachmentUrl = $message.get('mediaUrl')
const lat = $message.get('lat')
const lng = $message.get('lng')

Entrada/Saída (`$input`, `$output`)

Para comunicação entre ferramentas e workflows:

const city = $input.get('city', 'Quito')  // with default value
$output.set('data', result)

Respostas HTTP

Se você salvou a resposta de um nó API:

let apiResponse = $context.getHttpResponse('apiResponse')
apiResponse = apiResponse.json()

$memory.set('name', apiResponse.data.user.name)

A chave em $context.getHttpResponse() deve corresponder exatamente à que você configurou no campo “Salvar resposta” do nó API.

Utilitários disponíveis (`$utils`)

Logger

Registra valores para depuração no formato chave-valor. Os logs aparecem no histórico de execução:

// Primitives are stored as-is
$utils.logger.log('userId', 1245)
$utils.logger.log('status', 'active')

// Objects and arrays are converted to string (truncated to 2,000 characters)
$utils.logger.log('orderData', { id: 1, name: 'christian' })

Cada nó permite no máximo 5 entradas de log. O valor de cada entrada tem um limite de 2.000 caracteres.

Crypto

Funções criptográficas padrão:

$utils.crypto.createHash('sha256')
$utils.crypto.createHmac('sha256', key)
$utils.crypto.randomBytes(32)

Lodash

Utilitários para manipulação de arrays, objetos e strings:

$utils._.get(object, 'nested.path', defaultValue)
$utils._.uniq(array)
$utils._.chunk(array, size)
$utils._.merge(object1, object2)

DLP (Prevenção de perda de dados)

No final da aba Configuração você encontra a seção DLP, que mascara automaticamente os dados sensíveis que o nó escreve nos logs. Ative o toggle “Habilitar DLP” para escolher quais tipos de informação são mascarados (número de cartão, e-mail, telefone, etc.). É a proteção recomendada sempre que seu script trabalhar com dados pessoais, financeiros ou de identidade.

Aba Avançado

Configure o caminho de erro padrão. Se a execução do script lançar uma exceção não capturada (por exemplo, um JSON inválido ou um await faltando), o fluxo continua pelo caminho configurado em vez de parar. Use-o para mostrar uma mensagem amigável ao usuário ou para escalar para um humano quando o script falhar.

Aba Eventos

Registre eventos de rastreamento que disparam quando o nó é executado. Servem para alimentar suas métricas e correlacionar a passagem por este nó com conversões ou abandonos. Consulte o guia de Eventos para saber como configurá-los e consumi-los.

Casos de uso

Extrair campos do objeto salvo por um AI Agent

Um workflow em que um nó AI Agent gera uma resposta estruturada (por exemplo, um JSON com intencao, produto e sentimento) e a salva no contexto com a opção Salvar resposta ativada. O nó Código seguinte lê esse objeto, valida seus campos e os deixa em variáveis independentes para que os nós posteriores possam reagir sem chamar o modelo de novo.

// O AI Agent salvou sua resposta como $context.ai_agent_response
const resposta = $context.get('ai_agent_response')

// Os campos vêm do objeto structured output do agente
const intencao = $utils._.get(resposta, 'intencao', 'desconhecida')
const produto = $utils._.get(resposta, 'produto.nome')
const sentimento = $utils._.get(resposta, 'sentimento', 'neutral')

// Deixa cada campo pronto para os nós seguintes
$context.set('intencao', intencao)
$context.set('produto', produto)
$context.set('sentimento', sentimento)

// Persiste na memória o que você queira reusar em próximas conversas
$memory.setJson('ultimaInteracao', { intencao, produto, sentimento }, 86400)

$utils.logger.log('intencao', intencao)
$utils.logger.log('produto', produto)

Use $utils._.get(obj, 'caminho.aninhado', valorPadrao) para ler campos aninhados sem quebrar se o modelo omitir algum.

Normalizar a resposta de um nó API

Um workflow em que um nó API retorna uma lista de pedidos com nomes de campo em inglês e os nós seguintes esperam em português. O nó Código transforma a resposta antes de continuar.

const response = $context.getHttpResponse('pedidosApi').json()

const pedidos = response.data.map((p) => ({
  numero: p.order_number,
  cliente: p.customer_name,
  total: p.total_amount,
}))

$memory.setJson('pedidos', pedidos, 3600)
$context.set('quantidadePedidos', pedidos.length)

Validar e mascarar dados sensíveis

Um workflow em que um nó Pergunta anterior coletou o e-mail do usuário e o salvou no contexto. O nó Código o valida e mascara antes de armazená-lo ou exibi-lo, retornando apenas o estritamente necessário.

const email = $context.get('email')
const emailValido = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)

if (!emailValido) {
  $context.set('emailValido', false)
  return
}

const [usuario, dominio] = email.split('@')
const mascarado = `${usuario.slice(0, 2)}***@${dominio}`

$context.set('emailValido', true)
$context.set('emailMascarado', mascarado)
$memory.set('email', email, 604800) // 1 semana

Dividir uma lista em lotes para processá-la

Um workflow que precisa processar uma lista grande (por exemplo, 300 contatos) chamando uma API que só aceita 50 por request. O nó Código divide a lista em lotes e os deixa na memória para que um nó posterior itere sobre eles.

const contatos = $memory.getJson('contatos')
const lotes = $utils._.chunk(contatos, 50)

$memory.setJson('lotesContatos', lotes, 3600)
$context.set('totalLotes', lotes.length)
$context.set('loteAtual', 0)

Tipos MIME permitidos para $memory.setFile():

Categoria	Tipos
Texto	`text/plain`
JSON/XML	`application/json`, `application/xml`, `text/xml`
Imagens	`image/jpeg`, `image/png`, `image/gif`
Vídeos	`video/mp4`, `video/ogg`, `video/webm`, `video/x-msvideo`, `video/mpeg`
Áudio	`audio/mpeg`, `audio/wav`, `audio/ogg`, `audio/aac`, `audio/flac`
Documentos	`application/pdf`

Próximos passos

Nó AI Agent

Configure um agente e salve sua resposta no contexto para processá-la com Código.

Nó API

Chame serviços externos e leia a resposta com $context.getHttpResponse().

Variáveis de Contexto

Como funcionam as variáveis temporárias do fluxo que você lê com $context.

Variáveis de Memória

Persista dados entre workflows, ferramentas e conversas.

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Caixa de entrada

Marketplace

Canais

Configuração

Faturamento

Configuração do editor

Acessando variáveis

Contexto (`$context`)

Memória (`$memory`)

Leitura

Exclusão

Limites por tipo de dado

Migração de nós legados

Usuário (`$user`)

Mensagem (`$message`)

Entrada/Saída (`$input`, `$output`)

Respostas HTTP

Utilitários disponíveis (`$utils`)

Logger

Crypto

Lodash

DLP (Prevenção de perda de dados)

Aba Avançado

Aba Eventos

Casos de uso

Próximos passos

Nó AI Agent

Nó API

Variáveis de Contexto

Variáveis de Memória

​Configuração do editor

​Acessando variáveis

​Contexto ($context)

​Memória ($memory)

​Leitura

​Exclusão

​Limites por tipo de dado

​Migração de nós legados

​Usuário ($user)

​Mensagem ($message)

​Entrada/Saída ($input, $output)

​Respostas HTTP

​Utilitários disponíveis ($utils)

​Logger

​Crypto

​Lodash

​DLP (Prevenção de perda de dados)

​Aba Avançado

​Aba Eventos

​Casos de uso

​Próximos passos

Nó AI Agent

Nó API

Variáveis de Contexto

Variáveis de Memória

Configuração do editor

Acessando variáveis

Contexto (`$context`)

Memória (`$memory`)

Leitura

Exclusão

Limites por tipo de dado

Migração de nós legados

Usuário (`$user`)

Mensagem (`$message`)

Entrada/Saída (`$input`, `$output`)

Respostas HTTP

Utilitários disponíveis (`$utils`)

Logger

Crypto

Lodash

DLP (Prevenção de perda de dados)

Aba Avançado

Aba Eventos

Casos de uso

Próximos passos