Herramientas personalizadas: conectar el agente de IA a tus sistemas con un webhook

Ve a Agentes IA → Herramientas personalizadas y haz clic en Crear herramienta. Si aún no tienes ninguna, la página muestra Ninguna herramienta personalizada.

En la pestaña Configuración básica introduce:

• Nombre, por ejemplo «Consultar estado del pedido»;
• Descripción del trigger: es el texto que le dice a la IA cuándo activar la herramienta. Sé específico: describe condiciones y excepciones y, si hace falta, menciona por su nombre las demás herramientas para coordinarlas;
• URL del webhook, que debe usar HTTPS;
• Cabeceras personalizadas, por ejemplo una clave de autenticación que exija tu sistema;
• Enfriamiento (minutos), es decir, el tiempo mínimo entre dos activaciones para el mismo teléfono (0 = sin límite), y Timeout (segundos).

Activa Devuelve datos a la IA si quieres que el cuerpo de la respuesta del webhook se pase a la IA, que podrá usarlo al responder al cliente (por ejemplo, la disponibilidad de una cita o el estado de un trámite). Si lo dejas desactivado, la herramienta solo envía los datos.

En la pestaña Parámetros haz clic en Agregar parámetro por cada dato que quieras enviar. Para cada uno indica Nombre (solo letras, números y guiones bajos), Tipo (String, Number o Boolean), si es Obligatorio y la Fuente:

• Generado por AI: la IA extrae el valor de la conversación siguiendo la Descripción para la AI que escribes tú;
• Valor estático: un valor fijo, que siempre es el mismo;
• Campo del cliente: un dato del contacto, como teléfono, nombre, apellidos o email.

Antes de usarlo en producción, pulsa Probar. La prueba envía datos de ejemplo (los valores estáticos son reales; los dinámicos y los de IA usan marcadores de posición) y te muestra Estado, Latencia, Respuesta y Payload enviado, para que compruebes que tu sistema lo recibe todo correctamente.

Guarda la herramienta y asegúrate de que está activa con su interruptor (una herramienta desactivada aparece como Inactivo). Después abre Agentes IA → Herramientas y permisos y, en el recuadro de herramientas personalizadas, activa el interruptor de la herramienta para el agente que deba usarla. No olvides pulsar Guardar.

En la ficha de cada herramienta encontrarás Envíos recientes, con el resultado y el número de intentos de cada llamada. Los envíos fallidos se reintentan automáticamente. Las activaciones también aparecen en el Registro de actividad como Herramienta personalizada.