Herramientas del bot
Cómo conectar el bot a tus APIs externas para consultas y operaciones transaccionales.
Las herramientas permiten al bot consultar tus sistemas en tiempo real (CRM, ERP, facturación, bases de datos) mediante function calling. El bot decide cuándo usar cada herramienta basándose en la descripción que tú le des.
Cómo funcionan
- El cliente escribe algo como "¿Cuánto debo?"
- El bot clasifica la intención y detecta que necesita consultar un sistema externo
- El bot llama a la herramienta configurada (API HTTP) con los parámetros necesarios
- El resultado se formatea y se envía al cliente
Crear una herramienta
Ve a Bot → Mis bots → [tu bot] → tab Herramientas y haz clic en + Agregar herramienta.
Configuración básica
| Campo | Descripción |
|---|---|
| Nombre interno | Identificador único (minúsculas, números, _). No se puede cambiar después |
| Nombre visible | Nombre de display (ej: "Consultar Saldo") |
| Descripción | El bot lee esto para decidir cuándo usar esta herramienta. Sé claro y específico |
| Cuándo NO usar | (Opcional) Describe cuándo el bot no debería usar esta herramienta |
Configuración de API
| Campo | Descripción |
|---|---|
| URL del API | Soporta variables: {{phone}}, {{param}}, {{secret}} |
| Método HTTP | POST, GET, PUT, DELETE, PATCH |
| Parámetros del bot | Los datos que el bot pide al cliente. Cada uno con: nombre, tipo, descripción, requerido |
| Ruta de respuesta | Dot-notation al dato en el JSON (ej: data.results.0) |
Configuración avanzada
| Campo | Descripción |
|---|---|
| Headers HTTP | Encabezados con soporte para {{secret}} |
| Body | Cuerpo de la petición con variables |
| Timeout | 1,000 – 30,000 ms (default: 15,000) |
| Reintentos | 0–10 (default: 3). Solo para errores 5xx y de red |
| Timeout de reintentos | 1–60 seg (default: 15) |
| Parámetros automáticos | Se envían sin que el bot los pida (auto-inject) |
| Formato de respuesta | Template con {{variable}} para formatear el resultado |
| Respuesta directa | Envía el resultado directo al cliente sin pasar por el LLM — elimina alucinación en datos transaccionales |
| Nivel de verificación | Sin verificación / Identificado / Verificado |
| Credenciales (secrets) | Pares key-value encriptados, usables como {{nombre}} |
| Pre-requisito | Herramienta que debe ejecutarse antes de esta |
Cadenas de herramientas
Las herramientas pueden tener pre-requisitos: una herramienta que debe ejecutarse primero. Esto crea cadenas de ejecución (ej: primero consultar datos del cliente, luego generar referencia de pago).
Respuesta directa
Cuando activas Respuesta directa, el resultado de la herramienta se formatea con el template de respuesta y se envía directamente al cliente por WhatsApp, sin pasar por el LLM. Esto es crítico para datos transaccionales (saldos, folios, referencias) donde la alucinación es inaceptable.
Probar herramientas
Cada herramienta tiene un botón Probar que abre un panel donde puedes:
- Ingresar valores de prueba para cada parámetro
- Ejecutar la llamada en vivo
- Ver la respuesta completa del API
- Verificar que la ruta de respuesta extrae los datos correctos
Disponible para agentes
El toggle Disponible para agentes (icono de llave inglesa) permite que los agentes humanos también usen esta herramienta desde el inbox, sin necesidad de que el bot esté activo.
Las herramientas con Respuesta directa son especialmente útiles para agentes: ejecutan la consulta y el resultado formateado se puede enviar con un clic.
¿Esta página fue útil?