Integraciones
Herramientas HTTP
Configura integraciones HTTP para que tus agentes interactúen con APIs externas.
Nueva herramienta
Ve a tu agente → Herramientas HTTP → Nueva herramienta. Define los tres campos principales:
Nombre Identificador de la herramienta. El agente lo usa internamente. Usa nombres descriptivos sin espacios, ej: Buscar_Productos.
Método Verbo HTTP de la llamada: GET, POST, PUT, PATCH o DELETE.
URL Endpoint completo de la API. Puedes incluir variables dinámicas con la sintaxis ${var}, ej: https://api.com/productos/${id}.
La herramienta tiene 4 pestañas de configuración: Request, Auth, Inputs IA y Avanzado.
Request
Descripción (lo que lee la IA)
Explica en lenguaje natural qué hace esta herramienta y cuándo usarla. El agente lee esto para decidir si la invoca durante la conversación.
Ej: "Busca productos en el catálogo por nombre. Úsala cuando el cliente pregunte por disponibilidad, precio o características de un producto."
Query parameters
Parámetros que se agregan a la URL (?clave=valor). Usa ${var} para valores que el agente llenará dinámicamente desde la conversación.
Ej: q = ${busqueda} — el agente extrae el término de búsqueda del mensaje del usuario.
Headers
Cabeceras HTTP personalizadas. Úsalas para Content-Type u otros valores que requiera el endpoint. Para autenticación usa la pestaña Auth.
Ejemplo
Usuario
¿Tienen tenis Nike talla 28?
Herramienta ejecutada
GET https://mitienda.com/api/productos?q=tenis+Nike+talla+28
Agente
¡Sí! Tenemos los Nike Air Max 270 en talla 28 a $2,490 MXN en negro y blanco. ¿Te interesa alguno?