Saltar al contenido principal
GET
Get incoming calls
Devuelve la configuración de llamadas entrantes de un agente, la misma que muestra la Recepcionista IA en su pestaña Transferencias.
  • slots indica el modo en horario (in_hours) y fuera de horario (after_hours). Es null cuando las llamadas entrantes están apagadas. Un agente configurado antes de que existieran los modos por franja devuelve su modo único en ambas franjas.
  • team_number es compartido por ambas franjas. rings es null cuando usa el valor por defecto de 4.
  • status es ready cuando las llamadas ya usan esta configuración. Justo después de un cambio es pending, normalmente durante uno o dos minutos.
Las claves MCP necesitan numbers:read. Consulta Recepcionista IA para saber qué hace cada modo.

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

Incoming-call settings of the agent.

agent_group_id
string<uuid>
requerido

Agent ID.

mode
enum<string>
requerido

Single incoming-call mode. When slots is set, slots decides who answers each call.

Opciones disponibles:
off,
ai,
ai_human,
forward
number_id
string<uuid> | null
requerido

The agent's number that receives the calls.

transfer_to
string | null
requerido

Destination for ai_human or forward; otherwise null.

Pattern: ^\+[1-9]\d{7,14}$
status
enum<string>
requerido

ready when calls already use these settings. pending while the change is being applied, usually a minute or two. Never treat pending or error as active.

Opciones disponibles:
ready,
pending,
error,
unconfigured
numbers
object[]
requerido

Numbers of the account that this agent can use.

linked_numbers
object[]
requerido

Other numbers whose calls follow these settings.

slots
object | null
requerido

Who answers during business hours and after hours. Business hours are the Contactability hours of the task where calls start; with no hours set, every call uses in_hours. ai_only: the AI answers and does not transfer when asked for a person. ai_first_team_when_asked: the AI answers and transfers to team_number when the caller asks for a person. human_first_then_ai: team_number rings first, and the AI answers after rings rings if nobody takes the call. team_only: calls go to team_number without the AI. null when incoming calls are off.

team_number
string | null
requerido

Your team's number, shared by both slots.

Pattern: ^\+[1-9]\d{7,14}$
rings
integer | null
requerido

Rings before the AI answers in human_first_then_ai. null means the default of 4. Each ring lasts about 6 seconds.

Rango requerido: 1 <= x <= 6
Última modificación el 26 de octubre de 2026