> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar llamadas entrantes

> Define quién contesta las llamadas de un agente en horario y fuera de horario: solo la IA, la IA primero y tu equipo si lo piden, tu equipo primero y luego la IA después de 1 a 6 timbres, o solo tu equipo. Requiere confirm: true.

Primero lee la configuración actual con [Consultar llamadas entrantes](https://docs.getnexor.ai/docs/es/api/inbound-router/get-inbound-calls.md) y envía la configuración completa con `"confirm": true`. Las claves MCP necesitan `numbers:write`.

## Modos por franja

| Valor en `slots` | Quién contesta |
| - | - |
| `ai_only` | La IA. Pedir hablar con una persona no transfiere la llamada. |
| `ai_first_team_when_asked` | La IA, y transfiere a `team_number` cuando quien llama pide hablar con una persona. |
| `human_first_then_ai` | Primero suena `team_number`. La IA contesta después de `rings` timbres (1 a 6, por defecto 4) si nadie toma la llamada. |
| `team_only` | `team_number`, sin la IA. |

El horario es el de Contactabilidad de la tarea donde empiezan las llamadas. Si no hay horario definido, todas las llamadas usan `in_hours`.

## Modos distintos según el horario

```json theme={null}
{
  "mode": "ai_human",
  "number_id": "44444444-4444-4444-8444-444444444444",
  "transfer_to": "+56912345678",
  "slots": { "in_hours": "human_first_then_ai", "after_hours": "ai_first_team_when_asked" },
  "team_number": "+56912345678",
  "rings": 4,
  "confirm": true
}
```

* Toda franja distinta de `ai_only` necesita `team_number`, con `+` y el código de país. No puede ser el número del propio agente.
* Define `mode` como lo hace el panel: `ai_human` con `transfer_to` igual a `team_number` cuando una franja es `ai_first_team_when_asked`, `forward` con `transfer_to` cuando ambas franjas son `team_only`, y `ai` en los demás casos.
* `human_first_then_ai` y `team_only` necesitan un número que pueda llamar a un teléfono externo. Si no, la respuesta es 422 `call_forwarding_provider_unsupported`.

Sin `slots`, `mode` aplica todo el tiempo. `off` detiene las llamadas entrantes y mantiene el número asignado al 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.

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.

Un 409 `group_call_settings_number_in_use` indica que otro agente ya recibe llamadas en este número. Cada número contesta llamadas para un solo agente: quítalo primero del otro agente, o usa otro número.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.