Saltar al contenido principal
PUT
Envía solo los ajustes que quieres cambiar, junto con "confirm": true. Los que no envíes mantienen su valor. Cualquier otra clave devuelve 400 invalid_router_settings_field, con las claves desconocidas en fields.

Activar el enrutador

  • Si no indicas una tarea por defecto, Nexor prefiere la tarea de entrada del agente. Si no hay una, prioriza las tareas activas y sin pausa, y después su orden de creación. candidate_workflow_ids limita las candidatas cuando está definida.
  • La tarea por defecto debe ser una de las tareas del agente. Puede estar en pausa.
  • Cuando candidate_workflow_ids está definida, la tarea por defecto debe estar en esa lista.
  • Activar el enrutador no activa las llamadas entrantes. Configura el modo de llamadas entrantes del agente por separado con set_agent_inbound_calls en el MCP o PUT /master-workflows/{id}/inbound-calls en la API.

Decidir cuándo el agente pregunta primero

Revisa el resultado con Probar un mensaje antes de que escriban leads reales.

Desactivar el enrutador

Desactivarlo funciona aunque haya IDs de tareas guardados que ya no estén vigentes. También detiene la recepción por IA; el desvío directo sigue activo y el número sigue siendo del agente. Si el número no puede dejar de contestar, el enrutador sigue encendido y la respuesta es 400 con la causa, por ejemplo call_reception_stop_failed.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

Parámetros de ruta

id
string<uuid>
requerido

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

Cuerpo

application/json

Send only the settings to change. Any other key returns 400 invalid_router_settings_field.

confirm
enum<boolean>
requerido

Must be true.

Opciones disponibles:
true
is_active
boolean

Whether the inbound router picks the task for new inbound conversations of this agent.

default_workflow_id
string<uuid> | null

Default task (workflow in the API). Conversations go here when no rule matches and the AI is not confident enough. Must be a task of this agent; paused tasks are allowed.

candidate_workflow_ids
string<uuid>[] | null

Tasks the router may choose from. null means every task of the agent.

ai_enabled
boolean

When true, the AI reads the lead's first message and picks the task that fits best. It runs only when no earlier step decided and more than one task is available.

confidence_threshold
number

Minimum AI confidence to send the conversation straight to a task. Default 0.75.

Rango requerido: 0 <= x <= 1
clarify_threshold
number | null

Below confidence_threshold but at or above this value, the agent asks the lead a clarifying question instead of guessing (WhatsApp and web chat). Below it, the conversation goes to the default task. Must not be greater than confidence_threshold. null restores the default (0.55).

Rango requerido: 0 <= x <= 1
ambiguity_margin
number

When a second task scores within this margin of the best one, the agent asks a clarifying question while questions remain. 0 turns this off. Default 0.25.

Rango requerido: 0 <= x <= 1
routing_window_hours
integer | null

A lead who writes again within this many hours goes back to the task chosen last time. null turns this off.

Rango requerido: x >= 1
max_profiling_turns
integer

Maximum clarifying questions before the conversation goes to the best match or the default task. Default 3.

Rango requerido: 1 <= x <= 5
model_tier
enum<string>

AI model size used to pick the task: haiku (faster, default) or sonnet (more capable).

Opciones disponibles:
haiku,
sonnet
extraction_enabled
boolean

When true, later messages in an ongoing conversation are also checked against the agent's other tasks, and the router records when another task would fit better (would_extract outcome).

extraction_candidate_workflow_ids
string<uuid>[] | null

Tasks considered by that later check. null means every task of the agent.

extraction_confidence_threshold
number

Minimum confidence for that later check. Default 0.75.

Rango requerido: 0 <= x <= 1
continuity
object

Free-form object saved with the settings. Defaults to {}; the router does not require it.

reception_greeting
string | null

What the AI receptionist says word for word to every new caller while it routes calls (AI routing on, or a keyword rule that applies to calls), instead of any task's inbound greeting. Up to 160 characters after trimming; whitespace is collapsed. Variables in double curly braces are not allowed. null uses the generated greeting, returned as reception_greeting_default by GET. Calls use a new value within a minute or two.

Required string length: 1 - 160

Respuesta

Saved settings.

agent_group_id
string<uuid>
requerido
settings
object | null
requerido

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

Última modificación el 23 de octubre de 2026