Ir al contenido principal

Nodo Tool: conecta con APIs o herramientas externas

Integra funcionalidades avanzadas en tu flujo, como validaciones o generación de códigos OTP, sin complicaciones.

Actualizado hace más de 2 semanas

⚙️ ¿Qué hace el nodo Tool?

El nodo Tool te permite ejecutar una acción automatizada usando una herramienta preconfigurada dentro de tu Brain.

Estas herramientas (o “Tools”) pueden hacer cosas como:

  • Validar un correo, teléfono o documento.

  • Consultar el estado de un pedido en tu sistema.

  • Generar y enviar un código OTP.

  • Conectarse con un webhook o una API REST.

  • Realizar cálculos o transformaciones de datos.

🔌 Es el puente entre tu bot y tus sistemas externos.


🧩 ¿Cómo funcionan las Tools?

Cada Tool es una función ya creada que puede recibir datos (como variables del usuario) y devolver una respuesta útil para el flujo.

Al usar un nodo Tool, solo debes:

  1. Elegir la Tool preconfigurada.

  2. Definir qué variables le enviarás como entrada (input).

  3. Decidir qué hacer con la respuesta (output) —por ejemplo, guardarla en una variable o mostrarla.


✉️ Ejemplo práctico: Tool de autenticación con OTP

Imagina que tu usuario debe validar su número con un código de seguridad:

  1. El nodo Tool ejecuta una función que genera un OTP y lo envía por WhatsApp o SMS.

  2. La respuesta del usuario se valida con un nodo de pregunta.

  3. Si el código es correcto, el flujo continúa; si no, se redirige o finaliza.

🛡️ Este tipo de Tool es clave para flujos con validaciones sensibles como registros, pagos o recuperación de acceso.


🔄 ¿Cuándo usar Tool, AI o Skill?

Necesidad

¿Qué usar?

Motivo

Lógica conversacional

Skill

Agrupa flujos completos.

Generar contenido o texto dinámico

AI

Ideal para mensajes únicos y contextuales.

Ejecutar una acción concreta o conectarte con un sistema

Tool

Llama funciones externas o internas.

🧠 Usa Tool para hacer, AI para decidir y Skill para organizar.


✅ Buenas prácticas

  • Asegúrate de que la Tool esté bien configurada en el panel de administración de Brain.

  • Usa nombres de variables claros para entrada ({{telefono}}) y salida ({{codigo_validado}}).

  • Si la Tool devuelve errores, maneja el flujo con nodos condicionales o mensajes de fallback.

  • No sobrecargues el flujo con llamadas innecesarias: usa Tools solo donde agreguen valor real.


🧭 ¿Qué sigue?

👉 Aprende a organizar tu flujo con: Nodo Skill: reutiliza subflujos con lógica propia


👉 O personaliza la experiencia con IA en: Nodo AI: genera respuestas inteligentes

¿Te gustaría que continúe con el nodo Skill o el de condiciones?

¿Ha quedado contestada tu pregunta?