External Tools

Los External Tools son webhooks HTTP que tú configuras: el agente vocal los invoca en tiempo real para obtener datos o ejecutar acciones en tus sistemas (CRM, software de gestión, automatizaciones a medida).

Qué son

Un External Tool es una función que vive en tu servidor. yourang.ai la registra como herramienta disponible para el agente de IA: cuando el modelo identifica que esa acción es necesaria (p. ej. buscar un cliente en el CRM, comprobar la disponibilidad de una habitación), envía una solicitud HTTP a la URL que has configurado.

Cómo configurarlos

1. 1

   Abre el panel de herramientas del agente

   Ve a /ai-agents → selecciona el agente → pestaña Herramientas → External tools.

2. 2

   Define nombre y descripción

   El nombre interno (tool_name) es un identificador técnico (p. ej. lookup_customer). La descripción le indica a la IA cuándo usar la herramienta: clara, concreta, centrada en la intención del usuario.

3. 3

   Configura el webhook

   URL HTTPS que recibirá las llamadas, método (GET/POST/PUT), esquema de parámetros (JSON Schema) que la IA pasará en el payload.

4. 4

   Configura la autenticación

   Ninguna, Bearer token, API key en cabecera, Basic auth o varias cabeceras personalizadas. Las credenciales se cifran en reposo.

5. 5

   Prueba con una llamada de ensayo

   Activa el agente en el playground y pídele algo que debería disparar la herramienta. El registro de la llamada muestra request, response y tiempos.

Autenticación

Ninguna

Endpoint público, sin cabeceras. No recomendado en producción.

API key

Se envía en la cabecera HTTP que elijas (p. ej. X-API-Key).

Bearer

Cabecera Authorization: Bearer <token>.

Basic

Authorization: Basic <base64(user:pass)>.

Cabecera personalizada

Una o varias cabeceras arbitrarias (p. ej. X-Tenant, X-Signature).

Cuándo usarlos

• Búsqueda en CRM. El agente busca un cliente por número de teléfono y personaliza la respuesta con sus datos.
• Disponibilidad en gestión. El agente pregunta al PMS si hay habitaciones libres en una fecha dada.
• Creación de ticket. El agente registra una reclamación como ticket en tu sistema de atención al cliente.
• Actualización de pedido. El agente cambia el estado de un pedido ya gestionado en tu e-commerce.

Ejemplo de petición

{
 "phone": "+34 612 345 678",
 "call_id": "cl_abc123",
 "organization_id": "org_xyz"
}

# Respuesta esperada (200 OK):
{
 "found": true,
 "customer": {
 "name": "Lucía García",
 "tier": "gold",
 "last_order_date": "2026-03-12"
 }
}