El nodo se está habilitando de forma gradual; si no lo ves en el canvas, pide a tu ejecutivo de Jelou que lo active.
Cómo agregar el nodo
Ambos tipos de agente de IA se agregan desde el mismo punto de entrada: el ítem AI Agent en la barra de herramientas del builder. Su comportamiento cambia según cómo lo uses:- Clic: agrega un nodo AI Agent normal: el agente de IA de Jelou.
- Mantener el cursor encima (hover): abre un selector de proveedores de agentes de IA externos. Al elegir un proveedor, Jelou agrega un nodo Agente de IA externo preconfigurado para ese proveedor.


AI Agent o agente de IA externo
Elige según dónde viva el agente. Para construirlo dentro de Jelou, usa el nodo AI Agent (guía general).Proveedores disponibles
Cada proveedor pide sus propios campos, tomados directamente de su consola, y valida mientras escribes. Las credenciales se seleccionan por el nombre del secreto de la organización que las guarda; el valor del secreto nunca se muestra ni se guarda en el flujo.Una tarea o varios turnos
Al configurar el nodo eliges cómo interactúa con tu agente:- Una tarea: el nodo envía la tarea una vez, recibe la respuesta y sale del nodo.
- Varios turnos: el nodo mantiene la conversación con el agente, mensaje a mensaje, hasta que el agente la termine o la derive. Mientras el agente responde sin terminar la conversación, el nodo no toma ninguna salida: envía los mensajes al usuario y espera su siguiente mensaje para continuar con el agente.

Ejemplo: una tarea
Ejemplo: varios turnos
Salidas del nodo
El nodo Agente de IA externo tiene cuatro salidas:
- Respondió → el mensaje del agente ya se entregó; continúa el flujo o termínalo.
- Pide más información → un nodo de pregunta que recoge el dato faltante y vuelve a llamar al agente.
- Derivar a operador → tu nodo de transferencia a la Bandeja de entrada.
- Hubo un error → un mensaje de disculpa y, si aplica, un reintento o una derivación a un operador.
La variable “Guardar la respuesta en”
Cada nodo Agente de IA externo tiene un campo Guardar la respuesta en (por defectoagentReply) donde se escribe la respuesta del agente. Puedes referenciarla en nodos posteriores del flujo con la sintaxis habitual de variables, por ejemplo {{$context.agentReply}} en un nodo de mensaje o en una condición.
Si el agente además envía datos estructurados (por ejemplo con la ruta de datos del HTTP personalizado, o con una señal variables_set), esos datos se escriben como variables individuales del contexto del flujo, disponibles para cualquier nodo posterior.
Autenticación y secretos de la organización
Cada proveedor admite uno o varios esquemas de credencial, según lo que su API acepta:
En todos los casos, el nodo guarda solo el nombre del secreto de la organización, nunca su valor. El secreto se resuelve en el momento de la llamada y nunca se muestra ni se guarda en el flujo.
Opciones Enterprise para HTTP personalizado
Cuando tu agente usa HTTP (contrato de turno de Jelou) o HTTP personalizado, tu empresa puede tener acceso a opciones adicionales:

Estas opciones están disponibles en planes Enterprise. Si no las ves en tu nodo, pide a tu ejecutivo de Jelou que verifique tu plan.
Firma HMAC: qué se firma y cómo verificarla
Cuando activas la firma de solicitud, Jelou calcula un HMAC-SHA256 sobre el cuerpo exacto de la solicitud (los mismos bytes que se envían) usando el secreto que elijas, y lo envía en un header:
Tu propio servidor puede verificar la firma así (Node.js, usando solo el cuerpo):
{{$message.text}}: contiene el texto del mensaje que llegó al flujo. {{$input.message}} no es una variable de mensaje: $input solo guarda los datos que tu flujo recolectó (por ejemplo, con un nodo Input), así que sale vacío cuando el nodo se ejecuta desde un mensaje de chat.
Scripts previos y posteriores
Los scripts corren en el mismo entorno seguro (sandbox) que usa el nodo API, y solo aplican a proveedores HTTP. Se configuran en la pestaña Transformar del nodo, junto a la tarea que se envía y la variable donde se guarda la respuesta:
$context.get("agentRequest") contiene { task, sessionId, body, headers }. El script puede modificar agentRequest.body o agentRequest.headers antes de que Jelou envíe la solicitud. Por ejemplo, para envolver el cuerpo en un sobre propio de tu empresa:
$context.get("agentResponse") contiene { status, body }. El script debe dejar en agentResponse.body el objeto que luego lee el mapeo de la respuesta (las rutas textPath, dataPath, sessionIdPath, etc.).
Un error que lanza el script hace fallar el turno por la salida de error del nodo. Los cambios del script nunca tocan las variables propias del flujo: solo modifican lo que Jelou envía o lee para esta llamada.
Responder después (confirma y responde después)
Algunos agentes externos no contestan dentro de la misma llamada: confirman que recibieron el mensaje y envían su respuesta más tarde, por su cuenta. Para ese caso, el nodo Agente de IA externo tiene un modo opcional. Viene desactivado, así que un nodo existente se comporta exactamente igual que antes. El campo Cómo responde el agente aparece en la pestaña Conexión cuando el tipo de conexión es HTTP (contrato de turno de Jelou) o HTTP personalizado y la interacción es Varios turnos. Tiene dos opciones:- En la misma respuesta (por defecto): el agente responde dentro de la misma llamada, como hasta ahora.
- Confirma y responde después: el agente confirma con cualquier respuesta 2xx. Jelou no entrega nada del cuerpo de la confirmación y deja el nodo esperando el siguiente mensaje del usuario, con el mismo tiempo de inactividad de la sesión. Ese mensaje se reenvía al agente dentro de la misma ejecución.

Cuándo termina la conversación
En la pestaña Avanzado, estos dos campos opcionales aparecen solo en este modo:- Campo que termina la conversación: la ruta del campo en el cuerpo de la confirmación, por ejemplo
status,data.stateoitems[0].s(máximo 200 caracteres). - Valores que terminan la conversación: de 1 a 20 valores distintos, separados por comas. Acepta texto, números enteros y verdadero o falso. Cuando el campo trae uno de ellos, la conversación termina y el flujo sigue por la salida Respondió.

Salidas que debes conectar
- Conecta siempre la salida Hubo un error: es la que toma el nodo cuando vence la espera sin que el usuario escriba. Sin esa conexión no podrás publicar el flujo.
- Conecta la salida Respondió solo si definiste el campo que termina la conversación. Sin esos campos no se usa.
- La salida Derivar a operador no es obligatoria.
Mensajes que no son texto
Cuando el usuario envía una imagen, un audio, un documento, una respuesta de WhatsApp Flow, un botón, una lista o una ubicación, el agente ya no recibe una tarea vacía. La tarea llega como[tipo] descripción (o solo [tipo]), y la solicitud incluye un objeto input.inbound con el tipo, el texto, la descripción, el tipo de archivo y el id del mensaje.
Los datos sensibles no se envían por defecto. En la pestaña Transformar, el campo Datos sensibles de mensajes no texto que recibe el agente te deja elegir cuáles agregar:
- URL del archivo
- Respuesta de botón o lista
- Respuesta de WhatsApp Flow
- Ubicación

Prefijo de la firma
Algunos agentes esperan la firma HMAC con un texto delante, por ejemplosha256= seguido del valor. En Firmar las solicitudes, el campo Prefijo de la firma (ej. sha256=) agrega ese texto literal antes del valor de la firma. Acepta de 1 a 32 caracteres: letras, números y _ = . : / + -; no admite espacios ni plantillas. El header de la marca de tiempo nunca lleva prefijo. Se aplica a HTTP (contrato de turno de Jelou) y HTTP personalizado, y en cada reintento.
Token OAuth2 por mTLS
Si tu agente usa Credenciales de cliente OAuth2 y exige el certificado de cliente también para pedir el token, elige un Certificado mTLS y activa Pedir el token también con el certificado mTLS. El pedido del token viaja por el mismo certificado que la llamada al agente. La URL del token debe seguir siendo https. El interruptor solo aparece con esa autenticación y con un certificado elegido; si quitas el certificado, se desactiva. Desactivado, el token se pide como siempre.El contrato de turno de Jelou
Cuando eliges HTTP (contrato de turno de Jelou), tu servidor recibe y responde con una forma fija que Jelou ya sabe interpretar, sin necesidad de mapear rutas manualmente. Esto es lo que Jelou realmente envió y recibió en una prueba real contra un servidor de agente, con la firma HMAC redactada:Segunda respuesta del agente
Si tu agente no habla exactamente este contrato, usa HTTP personalizado: ahí defines tú mismo la forma del cuerpo que se envía y las rutas donde Jelou debe leer el texto de respuesta, los datos estructurados y el identificador de sesión, en la pestaña Transformar del nodo.
Probar conexión
Antes de publicar tu flujo, usa el botón Probar conexión en la pestaña Conexión del nodo para verificar que todo está bien configurado, sin esperar a que un usuario real dispare el nodo. La prueba corre una serie de verificaciones encadenadas, deteniéndose en la primera que falle:
Si todas las verificaciones pasan, ves una confirmación:


Seguridad
- Las credenciales nunca salen de los secretos de tu organización. El nodo guarda solo el nombre del secreto; su valor nunca se muestra ni se guarda en el flujo.
- Solo HTTPS. Jelou no llama a direcciones internas ni privadas.
- Las respuestas de tu agente pasan por los mismos controles de seguridad de Jelou que las respuestas de un AI Agent, antes de llegar al usuario: se filtran igual que cualquier mensaje saliente, sin que tengas que configurar nada adicional en el nodo.
Solución de problemas
El nodo sale siempre por 'Hubo un error'
El nodo sale siempre por 'Hubo un error'
Revisa primero Probar conexión: casi siempre señala si el problema es el certificado, el secreto, el token o el propio agente. Las causas más comunes son una credencial que expiró o se revocó, una URL que dejó de responder, o una respuesta del agente que no es JSON válido o no trae el campo esperado en la ruta configurada.
El turno tarda mucho y termina en error
El turno tarda mucho y termina en error
El nodo espera como máximo el tiempo límite por turno configurado (25 segundos por defecto, hasta 120 como máximo). Si tu agente necesita más tiempo, sube el límite en la pestaña Avanzado; si el agente falla de forma intermitente, revisa los reintentos: solo aplican a tiempos de espera, límites de uso (HTTP 429) y errores de servidor (5xx), nunca a una solicitud que el agente rechazó explícitamente.
La firma HMAC no coincide en mi servidor
La firma HMAC no coincide en mi servidor
Verifica siempre sobre el cuerpo crudo de la solicitud, antes de parsear el JSON (ver la sección de firma HMAC más arriba). Confirma también que usas el mismo secreto, la misma codificación (hexadecimal o Base64) y, si activaste
timestamp.body, que estás firmando "{timestamp}.{body}" y no solo el cuerpo.'Pide más información' no aparece en varios turnos
'Pide más información' no aparece en varios turnos
Es esperado: esa salida solo existe en modo una tarea. En varios turnos, cuando el agente necesita un dato adicional simplemente lo pide como un mensaje normal y el nodo sigue esperando la respuesta del usuario, sin tomar ninguna salida.
No veo el nodo Agente de IA externo ni el selector de proveedores
No veo el nodo Agente de IA externo ni el selector de proveedores
El nodo se está habilitando de forma gradual. Pide a tu ejecutivo de Jelou que lo active para tu empresa.
No veo las opciones Enterprise (HMAC, headers estáticos, scripts, mTLS)
No veo las opciones Enterprise (HMAC, headers estáticos, scripts, mTLS)
Estas opciones están disponibles en planes Enterprise. Pide a tu ejecutivo de Jelou que verifique tu plan.
Disponibilidad
El nodo Agente de IA externo se está habilitando de forma gradual. Si no lo ves en el canvas de tu proyecto, contacta a tu ejecutivo de cuenta de Jelou para solicitar su activación.Nodo AI Agent
Configuración general del nodo AI Agent.