Saltar al contenido principal
PUT
Update topic transfer rules
Primero lee las reglas actuales con Consultar transferencias por tema y envía la lista completa con "confirm": true. Las claves MCP necesitan numbers:write.

Reemplazar las reglas

  • La lista reemplaza todas las reglas que tenía el agente. Envía cada regla que quieras mantener. "rules": [] las elimina todas.
  • key identifica la regla: una letra minúscula y luego letras minúsculas, dígitos o _, hasta 24 caracteres. Cada key aparece una sola vez.
  • topic tiene hasta 300 caracteres. Descríbelo como lo preguntaría quien llama.
  • number necesita + y el código de país. No puede ser uno de los números del propio agente; si lo es, la respuesta es 400 group_transfer_rules_self_transfer.
  • say tiene hasta 200 caracteres, en el idioma del agente.
Las reglas aplican siempre que la IA está en la llamada, en horario y fuera de horario, y en todas las tareas del agente.

Después de guardar

La respuesta vuelve con status: "pending". Las llamadas toman el cambio en uno o dos minutos; vuelve a leer hasta que status sea ready. Un estado pending o error todavía no está activo. Un 409 group_transfer_rules_busy indica que se está guardando otro cambio en las llamadas de este agente. Vuelve a intentarlo en un momento. Las respuestas de estas escrituras incluyen saved_in_agent_draft. Es false cuando el cambio se aplicó al agente en vivo (toda API key y MCP key de cliente). Es true solo cuando NexorGPT guardó el cambio en el borrador del agente; ese cambio llega a las llamadas al publicar el borrador.

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.

Cuerpo

application/json
rules
object[]
requerido

The full list of rules. Keys must be unique.

Maximum array length: 5
confirm
enum<boolean>
requerido

Must be true. Send it only after the account owner approves this exact list.

Opciones disponibles:
true

Respuesta

Rules saved. status is pending until calls use them.

agent_group_id
string<uuid>
requerido

Agent ID.

rules
object[]
requerido

Topic transfer rules, in the order the AI considers them. Empty when the agent has none.

Maximum array length: 5
status
enum<string>
requerido

ready when calls already use these rules. pending while the change is being applied, usually a minute or two. error needs attention. unpublished when the agent's calls have not been published yet; the rules apply once they are. Never treat pending or error as active.

Opciones disponibles:
ready,
pending,
error,
unpublished
saved_in_agent_draft
boolean
requerido

false when the change was applied to the live agent (every customer API key and MCP key). true only when NexorGPT saved the change to the agent's draft; that change reaches calls when the draft is published.

Última modificación el 26 de octubre de 2026