Saltar al contenido principal
GET
Get topic transfer rules
Devuelve las reglas de transferencia por tema de un agente, las mismas que muestra la Recepcionista IA en Transferir por tema, dentro de su pestaña Transferencias.
  • Cada regla tiene una key, el topic que la activa, el number al que transfiere y lo que dice la IA antes (say).
  • rules viene vacío cuando el agente no tiene reglas. Un agente tiene como máximo 5 reglas.
  • status es ready cuando las llamadas ya usan estas reglas. Justo después de un cambio es pending, normalmente durante uno o dos minutos. unpublished indica que las llamadas del agente todavía no se han publicado.
Las claves MCP necesitan numbers:read. Consulta Transferir por tema para saber cómo usa la IA cada regla.

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

Topic transfer rules of the agent.

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
Última modificación el 26 de octubre de 2026