Skip to main content
GET
Get inbound router
El enrutador de entrada permite que un agente elija cuál de sus tareas responde una conversación entrante nueva, según tus reglas y lo que escribe el lead. En la app aparece como Deja que tu agente elija la tarea. Consulta Tareas que trabajan juntas. En la API, un agente es un 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 de layer, que aparece en Listar decisiones. Si algo falla en el camino, la conversación va a la tarea por defecto para que el lead igual reciba respuesta (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:read para leer y workflows:write para hacer cambios. Las claves de API con acceso completo no necesitan nada más.
  • Todo cambio exige "confirm": true en el cuerpo. Sin eso, la API responde 400 confirmation_required y no cambia nada.
  • Los errores devuelven un código estable en error, como agent_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

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

id
string<uuid>
requerido

Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.

Respuesta

Router of the agent.

agent_group_id
string<uuid>
requerido

Agent ID.

settings
object | null
requerido

Router settings of the agent. null when the router was never configured for it.

identity
object | null
requerido

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
object[]
requerido

Tasks of the agent.

Última modificación el 28 de septiembre de 2026