Consultar enrutador de entrada
Consulta la configuración del enrutador de entrada de un agente, su identidad compartida y las tareas entre las que puede elegir.
master_workflow y una tarea es un workflow. El ID del agente va en la ruta, y las tareas aparecen en campos como default_workflow_id y target_workflow_id.
Cómo elige la tarea
Para cada conversación nueva, el enrutador recorre estos pasos en orden y se detiene en el primero que decide. Cada paso tiene un valor delayer, que aparece en Listar decisiones.
error_fail_open).
Antes de empezar
- El enrutador de entrada no está disponible en todas las cuentas. Sin él, todos los endpoints de esta sección responden 403
inbound_router_not_enabled. - Las claves MCP necesitan
workflows:readpara leer yworkflows:writepara hacer cambios. Las claves de API con acceso completo no necesitan nada más. - Todo cambio exige
"confirm": trueen el cuerpo. Sin eso, la API responde 400confirmation_requiredy no cambia nada. - Los errores devuelven un código estable en
error, comoagent_group_not_found. Traduce ese código a tu propio mensaje. - Para elegir qué números y casillas llegan al agente, consulta Listar puntos de entrada.
Autorizaciones
API key for authentication. Keys are prefixed with nxr_live_.
Parámetros de ruta
Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.
Respuesta
Router of the agent.
Agent ID.
Router settings of the agent. null when the router was never configured for it.
The agent's shared identity: the name, voice, language, and instructions all of its tasks speak with, including while the agent works out which task should answer. When the agent has no complete identity of its own, the values shown come from the default task.
Tasks of the agent.