Salud de las herramientas
Revisa cómo se comportaron las herramientas de tus agentes en conversaciones y llamadas reales: ejecuciones, fallas, resultados vacíos, bloqueos, errores frecuentes y ejemplos.
Antes de empezar
- Las llaves MCP necesitan
workflows:ready tambiénleads:read, porque los ejemplos incluyen datos de leads. Las llaves REST de acceso completo no necesitan nada más. - No cuenta los leads de prueba, los leads sandbox ni las conversaciones del Playground.
- Es solo de lectura: consultarlo no ejecuta ninguna herramienta.
- Los errores devuelven un código estable en
error, por ejemploinvalid_days. Asocia cada código a tus propios textos.
Qué consultar
Qué significa cada número
Cómo interpretar los resultados
Límites
- Hasta 100 filas. Si hay más coincidencias,
truncatedviene entrue. - Cada consulta lee primero la actividad más reciente. Si el período tuvo más actividad de herramientas de la que cabe en una consulta,
truncatedviene entrueywindow.scanned_fromindica desde qué momento parten los conteos. Acota conworkflow_id,tool_name,channelo menosdays. argsyresultse cortan en 600 caracteres. Las llaves de API, tokens, contraseñas y firmas aparecen enmascarados. Los datos del lead, como nombres y teléfonos, no se eliminan: trata los ejemplos como datos de leads.
Autorizaciones
API key for authentication. Keys are prefixed with nxr_live_.
Parámetros de consulta
How many days back to read, counted in 24-hour periods from the moment of the request. Any other value returns 400 invalid_days.
1 <= x <= 14Task ID (workflow in the API). Counts only that task's conversations and calls. A malformed ID returns 400 invalid_workflow_id; a task from another account returns an empty tools list.
Exact tool name. Surrounding spaces are ignored. Empty after trimming, or longer than 120 characters, returns 400 invalid_tool_name.
120Only runs on this channel. call is phone calls; unsupervised-whatsapp is a personal WhatsApp line. Any other value returns 400 invalid_channel.
whatsapp, unsupervised-whatsapp, instagram, messenger, webchat, sms, imessage, email, call true keeps only tools where failed + empty is at least half of the runs that reached the integration (calls - blocked), with at least 3 such runs. Accepts true, false, 1, or 0; anything else returns 400 invalid_only_problems.
Respuesta
Tool rows, sorted by problem rate ((failed + empty) / (calls - blocked)) and then by calls, highest first.
100true when more than 100 rows matched, or when the window had more activity than one request reads (see window.scanned_from). Narrow with workflow_id, tool_name, channel, or fewer days.