URL y método HTTP
En la parte superior del panel configuras los dos campos esenciales: Método HTTP — define qué tipo de operación realizarás:
URL — la dirección del servicio. Puedes inyectar variables directamente:
Si pegas una URL que ya contiene parámetros (como
?clave=valor), el nodo los extrae automáticamente y los mueve a la pestaña de Parámetros.Importar desde cURL
Si tienes un comando cURL listo (por ejemplo, de la documentación de un API), puedes pegarlo directamente en el campo de URL. El nodo interpreta automáticamente el método, headers, body y autenticación del comando.Pestañas de configuración
El panel tiene 6 pestañas para configurar todos los aspectos de la petición:Parámetros
Agrega parámetros de consulta (query string) como pares clave-valor. Cada parámetro tiene un checkbox para habilitarlo o deshabilitarlo sin eliminarlo.?param1=valor1¶m2=valor2.
Autenticación
Dos métodos de autenticación disponibles:
Ambos métodos soportan variables en sus campos, lo que permite usar credenciales almacenadas dinámicamente.
Las credenciales se mantienen en contexto durante la ejecución del workflow. Puedes editarlas desde el modal de credenciales si ya están almacenadas.
Headers
Agrega headers HTTP personalizados como pares clave-valor. Cada header tiene un checkbox para activarlo o desactivarlo.El header
Content-Type se actualiza automáticamente cuando cambias el tipo de body.Body
Para métodos que envían datos (POST, PUT, PATCH), configura el cuerpo de la petición en distintos formatos:
El editor JSON valida la estructura en tiempo real y soporta variables dentro del contenido:
Settings
Configuraciones avanzadas para controlar el comportamiento de la petición:Timeout
Tiempo máximo que el nodo espera la respuesta del servicio, en milisegundos. Si la respuesta no llega dentro de ese tiempo, la petición se corta y el flujo continúa por la salida de error.Límite por plan
En las compañías self-service el timeout no puede superar el máximo que otorga el plan:
Al crear un nodo API, el timeout inicial es el máximo de tu plan. Si escribes un valor mayor, el campo muestra el límite vigente y te ofrece subir de plan.
Un nodo que ya tenía configurado un valor por encima del límite sigue funcionando: la petición se ejecuta con el máximo del plan.
Qué dice el log de la ejecución
Cuando la petición se corta por tiempo, el log indica la causa enerror.cause y el detalle en error.timeout:
Cuándo no aplica el límite
- Compañías Enterprise: el límite es exclusivo de los planes self-service.
- Nodo Bases de datos: consulta la base de datos de Jelou, no un servicio externo.
- Nodos con certificado mTLS: conservan su propio timeout.
Certificado SSL
Habilita la verificación SSL/TLS para conexiones seguras.Certificados mTLS
Autenticación mutua TLS con el servidor. Esta opción solo aparece si tu compañía tiene al menos un certificado configurado.- Al activar mTLS, el certificado SSL se desactiva automáticamente (son mutuamente excluyentes)
- Si existe un certificado primario, se selecciona automáticamente
- Puedes elegir cualquier certificado de la lista disponible
- Incluye un campo de timeout configurable entre 1000ms (1s) y 120000ms (2min) (por defecto 30000ms)
Reintentos
Configura reintentos automáticos cuando una petición falla:Avanzado
Retener la conversación mientras espera
Por defecto, mientras el nodo espera la respuesta del servicio el usuario queda libre: si escribe, su mensaje lo atiende el router del proyecto y puede arrancar otro flujo en la misma conversación. Para evitarlo, abre la pestaña Avanzado y activa Retener la conversación mientras espera: el usuario permanece en este workflow hasta que la petición termina.Hasta cuándo dura
La conversación se libera en cuanto la petición termina, tanto por la salida de éxito como por la de error, y el flujo continúa. Como respaldo, la retención dura como máximo el timeout configurado en Settings; si no configuraste uno, dura 60 segundos. En ningún caso supera 1 hora.El tope se calcula con el timeout de un solo intento. Si activaste Reintentos, la petición puede tardar más que ese tope: al alcanzarlo, el usuario vuelve a conversar con el router aunque el nodo siga reintentando.
Cuándo no aplica
- Nodos dentro de una Tool: solo el workflow que conversa con el usuario puede retenerlo, así que la opción se ignora en un nodo API que corre dentro de una Tool. En ese caso, actívala en el nodo Tool del workflow; consulta Qué es una Tool.
- Conversaciones con un operador: si un agente humano toma la conversación, sus mensajes no pasan por la retención.
- Usuario ya retenido: si otro nodo —por ejemplo, una Pausa o una Tool con la misma opción— ya retiene al usuario, se respeta esa retención y este nodo no la reemplaza.
Guardar la respuesta
Activa el toggle “Guardar respuesta” en la parte superior y define un nombre de variable. La respuesta completa del API se almacenará en esa variable.Acceder a la respuesta sin manipulación
Usa la variable directamente en otros nodos:Manipular la respuesta en un nodo Código
Si necesitas extraer datos específicos del JSON:Respuesta de prueba
Después de ejecutar una prueba desde el panel, la respuesta se muestra en una sección colapsable con:- Código de estado (por ejemplo,
200 OK) - Pestaña Body — Respuesta formateada como JSON con botón de copiar
- Pestaña Headers — Headers de respuesta del servidor