Tool API

Ejecuta una llamada HTTP a cualquier endpoint externo. Es el tipo de tool más usado para integrar Pulbot con sistemas externos: CRMs, ERPs, bases de datos propias, servicios REST.

¿Cuándo usarlo?

Cuando necesitas consultar o escribir datos en un sistema externo: obtener el perfil de un cliente, registrar un pedido, consultar stock, etc.

Pasos

1Crea una nueva tool o edita una existente → elige tipo «API».
2Ingresa el método HTTP (GET, POST, PUT, PATCH, DELETE) y la URL del endpoint.
3Si el endpoint requiere autenticación, selecciona un Conector con las credenciales (Bearer, Basic, API Key, etc.).
4Configura los headers necesarios (Content-Type, Accept, etc.).
5Para POST/PUT, define el body. Usa {{variable}} para inyectar datos del flow.
6Guarda y prueba la tool con datos de muestra usando el botón «Probar».

Referencia

URL: Puede incluir variables: https://api.ejemplo.com/clientes/{{cliente_id}}
Headers: Pares clave-valor. Soportan variables. Ej: Authorization: Bearer {{token}}
Body: JSON, form-data o texto plano. Los campos soportan expresiones {{...}}.
Conector: Almacena las credenciales de forma segura. El nodo referencia el conector, no el secreto directamente.
Timeout: Tiempo máximo de espera por la respuesta externa. Default: 30 s.
Response: La respuesta queda disponible en la variable de salida del nodo para nodos posteriores.

Errores comunes

401 Unauthorized: Las credenciales son incorrectas o el token venció. Revisa el conector asociado.
404 Not Found: La URL es incorrecta o el recurso no existe. Verifica el endpoint y los path params.
Timeout: El servicio externo tardó más del tiempo configurado. Aumenta el timeout o verifica la disponibilidad del servicio.
CORS error en prueba: Las pruebas de tool corren desde el backend de Pulbot, no desde el navegador. Un error CORS en producción no es esperado; si aparece, es un error de configuración del servicio externo.

Siguiente paso

Aprende a usar Tool Transform para mapear la respuesta antes de pasarla al siguiente nodo.