Código

El nodo Código te permite ejecutar JavaScript personalizado dentro de tu flujo. Es útil para operaciones que no se pueden lograr con los nodos estándar: transformar datos, hacer cálculos, manipular textos, firmar peticiones o integrar lógica de negocio personalizada. El panel del nodo se organiza en tres pestañas:

Configuración — el editor de JavaScript, formateo, cheat sheet, autocompletado y la sección DLP.
Avanzado — el manejo del error por defecto para decidir a dónde va el flujo si la ejecución del script falla.
Eventos — registra eventos de seguimiento que se disparan cuando el nodo se ejecuta, para alimentar tus métricas.

Configuración del editor

El editor de código incluye herramientas para agilizar la escritura y depuración:

Formatear: aplica Prettier al script y agrega automáticamente await en los métodos asincrónicos que lo requieran.
Cheat sheet: abre una referencia rápida con los objetos globales disponibles ($context, $memory, $user, $message, $input, $output, $utils) y sus métodos.
Autocompletado: al escribir $, el editor sugiere las funciones y namespaces disponibles con su descripción.
Modo claro / oscuro: cambia el tema del editor desde el selector en la esquina superior derecha.
Validación en vivo: el editor marca errores comunes de lint y advierte cuando falta await en un método asincrónico.

Acceso a variables

Dentro del nodo Código puedes leer y escribir variables del flujo usando objetos globales predefinidos.

Contexto (`$context`)

Variables que persisten solo durante la ejecución actual del flujo:

// Leer
const nombre = $context.get('nombre')
const nombre = $context.get('nombre', 'Juan') // con valor por defecto

// Escribir
$context.set('ultimoPedido.estado', 'entregado')
$context.set('usuario', { nombre: 'Juan', plan: 'gold' })

Memoria (`$memory`)

Variables que persisten entre workflows, tools y nodos. Soportan tiempo de vida (TTL):

// Primitivos (string, number, boolean) - TTL opcional
$memory.set('nombre', 'Juan')
$memory.set('intentos', 3, 3600) // expira en 1 hora

// JSON - TTL requerido (en segundos, máximo 86,400 = 1 día)
$memory.setJson('usuario', { nombre: 'Juan', plan: 'gold' }, 86400)

// Archivos - async, TTL requerido (máximo 604,800 = 1 semana)
await $memory.setFile('comprobante', base64String, 604800, 'application/pdf')

Lectura

const nombre = $memory.get('nombre')
const usuario = $memory.getJson('usuario')
const url = $memory.getFile('comprobante').toUrl()           // URL temporal
const base64 = await $memory.getFile('comprobante').toBase64()

Eliminación

$memory.delete('temporal')
$memory.delete(['tmp1', 'tmp2', 'cache']) // múltiples claves

Límites por tipo de dato

Tipo	Tamaño máximo	TTL	TTL máximo
String	255 caracteres	Opcional	—
Number	15 dígitos	Opcional	—
Boolean	—	Opcional	—
JSON	15 KB	Requerido	86,400s (1 día)
File	10 MB	Requerido	604,800s (1 semana)

Los métodos $memory.setFile(), $memory.getFile().toBase64() y $memory.getFile().toRaw() son asincrónicos. Debes usar await al llamarlos.

Migración desde nodos legacy

Crea un nuevo nodo Código (Memory V2).
Copia y pega el script del nodo legacy.
Usa los nuevos métodos disponibles ($memory.setJson, $memory.setFile, etc.) si lo necesitas.

Usuario (`$user`)

Información del contacto que interactúa con tu flujo:

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

Mensaje (`$message`)

El último mensaje que envió el usuario:

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

Input/Output (`$input`, `$output`)

Para comunicación entre tools y workflows:

const ciudad = $input.get('ciudad', 'Quito')  // con valor por defecto
$output.set('data', resultado)

Respuestas HTTP

Si guardaste la respuesta de un nodo API:

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

$memory.set('nombre', apiResponse.data.usuario.nombre)

La llave en $context.getHttpResponse() debe coincidir exactamente con la que configuraste en el campo “Guardar respuesta” del nodo API.

Utilidades disponibles (`$utils`)

Logger

Registra valores para depuración en formato clave-valor. Los logs aparecen en el historial de ejecuciones:

// Primitivos se almacenan tal cual
$utils.logger.log('userId', 1245)
$utils.logger.log('estado', 'activo')

// Objetos y arrays se convierten a string (truncado a 2,000 caracteres)
$utils.logger.log('orderData', { id: 1, nombre: 'cristian' })

Cada nodo permite un máximo de 5 registros. El valor de cada registro tiene un límite de 2,000 caracteres.

Crypto

Funciones criptográficas estándar:

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

Lodash

Utilidades para manipular arrays, objetos y strings:

$utils._.get(objeto, 'ruta.anidada', valorPorDefecto)
$utils._.uniq(array)
$utils._.chunk(array, tamano)
$utils._.merge(objeto1, objeto2)

DLP (Prevención de pérdida de datos)

Al final de la pestaña Configuración encuentras la sección DLP, que enmascara automáticamente los datos sensibles que el nodo escribe en los logs. Activa el toggle “Habilitar DLP” para elegir qué tipos de información se enmascaran (número de tarjeta, correo, teléfono, etc.). Es la protección recomendada cuando tu script trabaja con datos personales, financieros o de identidad.

Pestaña Avanzado

Configura el camino de error por defecto. Si la ejecución del script lanza una excepción no capturada (por ejemplo, un JSON inválido o un await faltante), el flujo continúa por el camino configurado en lugar de detenerse. Úsalo para mostrar un mensaje amigable al usuario o para escalar a un humano cuando el script falla.

Pestaña Eventos

Registra eventos de seguimiento que se disparan cuando el nodo se ejecuta. Sirven para alimentar tus métricas y correlacionar el paso por este nodo con conversiones o abandonos. Consulta la guía de Eventos para conocer cómo configurarlos y consumirlos.

Casos de uso

Extraer campos del objeto guardado por un AI Agent

Un workflow donde un nodo AI Agent genera una respuesta estructurada (por ejemplo, un JSON con intencion, producto y sentimiento) y la guarda en contexto con la opción Guardar respuesta activada. El nodo Código posterior lee ese objeto, valida sus campos y los deja en variables independientes para que los nodos siguientes puedan reaccionar sin volver a llamar al modelo.

// El AI Agent guardó su respuesta como $context.ai_agent_response
const respuesta = $context.get('ai_agent_response')

// Los campos vienen en el objeto structured output del agente
const intencion = $utils._.get(respuesta, 'intencion', 'desconocida')
const producto = $utils._.get(respuesta, 'producto.nombre')
const sentimiento = $utils._.get(respuesta, 'sentimiento', 'neutral')

// Deja cada campo listo para los nodos siguientes
$context.set('intencion', intencion)
$context.set('producto', producto)
$context.set('sentimiento', sentimiento)

// Persiste en memoria lo que quieras reutilizar en próximas conversaciones
$memory.setJson('ultimaInteraccion', { intencion, producto, sentimiento }, 86400)

$utils.logger.log('intencion', intencion)
$utils.logger.log('producto', producto)

Usa $utils._.get(obj, 'ruta.anidada', valorPorDefecto) para leer campos anidados sin romper si el modelo omite alguno.

Normalizar la respuesta de un nodo API

Un workflow donde un nodo API devuelve una lista de pedidos con nombres de campo en inglés y los nodos siguientes esperan español. El nodo Código transforma la respuesta 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('cantidadPedidos', pedidos.length)

Validar y enmascarar datos sensibles

Un workflow donde un nodo Pregunta anterior recolectó el correo del usuario y lo guardó en contexto. El nodo Código lo valida y lo enmascara antes de guardarlo o mostrarlo, y devuelve solo lo estrictamente necesario.

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 enmascarado = `${usuario.slice(0, 2)}***@${dominio}`

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

Dividir una lista en lotes para procesarla

Un workflow que necesita procesar una lista grande (por ejemplo, 300 contactos) llamando a una API que solo acepta 50 por request. El nodo Código divide la lista en lotes y los deja en memoria para que un nodo posterior itere sobre ellos.

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

$memory.setJson('lotesContactos', lotes, 3600)
$context.set('totalLotes', lotes.length)
$context.set('loteActual', 0)

Tipos MIME permitidos para $memory.setFile():

Categoría	Tipos
Texto	`text/plain`
JSON/XML	`application/json`, `application/xml`, `text/xml`
Imágenes	`image/jpeg`, `image/png`, `image/gif`
Videos	`video/mp4`, `video/ogg`, `video/webm`, `video/x-msvideo`, `video/mpeg`
Audios	`audio/mpeg`, `audio/wav`, `audio/ogg`, `audio/aac`, `audio/flac`
Documentos	`application/pdf`

Siguientes pasos

Nodo AI Agent

Configura un agente y guarda su respuesta en contexto para procesarla con Código.

Nodo API

Llama a servicios externos y lee la respuesta con $context.getHttpResponse().

Variables de Contexto

Cómo funcionan las variables temporales del flujo que lees con $context.

Variables de Memoria

Persiste datos entre workflows, tools y conversaciones.

Empezando

Desarrollador

Jelou CLI

Mensajería Outbound

Bandeja de entrada

Marketplace

Canales

Configuración

Facturación

Configuración del editor

Acceso a variables

Contexto (`$context`)

Memoria (`$memory`)

Lectura

Eliminación

Límites por tipo de dato

Migración desde nodos legacy

Usuario (`$user`)

Mensaje (`$message`)

Input/Output (`$input`, `$output`)

Respuestas HTTP

Utilidades disponibles (`$utils`)

Logger

Crypto

Lodash

DLP (Prevención de pérdida de datos)

Pestaña Avanzado

Pestaña Eventos

Casos de uso

Siguientes pasos

Nodo AI Agent

Nodo API

Variables de Contexto

Variables de Memoria

​Configuración del editor

​Acceso a variables

​Contexto ($context)

​Memoria ($memory)

​Lectura

​Eliminación

​Límites por tipo de dato

​Migración desde nodos legacy

​Usuario ($user)

​Mensaje ($message)

​Input/Output ($input, $output)

​Respuestas HTTP

​Utilidades disponibles ($utils)

​Logger

​Crypto

​Lodash

​DLP (Prevención de pérdida de datos)

​Pestaña Avanzado

​Pestaña Eventos

​Casos de uso

​Siguientes pasos

Nodo AI Agent

Nodo API

Variables de Contexto

Variables de Memoria

Configuración del editor

Acceso a variables

Contexto (`$context`)

Memoria (`$memory`)

Lectura

Eliminación

Límites por tipo de dato

Migración desde nodos legacy

Usuario (`$user`)

Mensaje (`$message`)

Input/Output (`$input`, `$output`)

Respuestas HTTP

Utilidades disponibles (`$utils`)

Logger

Crypto

Lodash

DLP (Prevención de pérdida de datos)

Pestaña Avanzado

Pestaña Eventos

Casos de uso

Siguientes pasos