# CallSettingsRequest

Atualização parcial: informe callsMaxConcurrent e/ou incomingCallMode. Campos omitidos são preservados. Cada atualização aceita incrementa callsConfigVersion. Alterar o modo afeta apenas novas chamadas.

## Campos

| Campo | Tipo | Presença | Descrição |
|---|---|---|---|
| `callsMaxConcurrent` | `integer` | condicional | Limite próprio de ligações simultâneas da instância calls: voz e vídeo, recebidas e realizadas, incluindo ringing/connecting/active e reservas de discagem. Acima de 1 ainda depende de homologação em chamadas reais. Mínimo: `1`. Máximo: `8` |
| `incomingCallMode` | `string` | condicional | Comportamento para novas chamadas recebidas: allow permite atendimento humano; reject recusa no servidor; reject_reply recusa e solicita ao consumidor resposta por uma conexão de mensagens vinculada. Não atende automaticamente. O envio do texto é independente da recusa. Modelo: [IncomingCallMode](https://wpp.atendro.cloud/docs/modelos/incoming-call-mode.md). Valores: `"allow"`, `"reject"`, `"reject_reply"` |
| `expectedCallsConfigVersion` | `integer` | opcional | Comparação condicional opcional. Se diferente da versão salva, retorna 409 settings_version_conflict sem alterar a instância. Enviar junto a pelo menos um campo de configuração. Mínimo: `0`. Formato: `int64` |

Pelo menos uma destas combinações deve ser válida:

- `callsMaxConcurrent`
- `incomingCallMode`

## Definição OpenAPI

```json
{
  "type": "object",
  "properties": {
    "callsMaxConcurrent": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Limite próprio de ligações simultâneas da instância calls: voz e vídeo, recebidas e realizadas, incluindo ringing/connecting/active e reservas de discagem. Acima de 1 ainda depende de homologação em chamadas reais."
    },
    "incomingCallMode": {
      "$ref": "#/components/schemas/IncomingCallMode"
    },
    "expectedCallsConfigVersion": {
      "type": "integer",
      "format": "int64",
      "minimum": 0,
      "description": "Comparação condicional opcional. Se diferente da versão salva, retorna 409 settings_version_conflict sem alterar a instância. Enviar junto a pelo menos um campo de configuração."
    }
  },
  "anyOf": [
    {
      "required": [
        "callsMaxConcurrent"
      ]
    },
    {
      "required": [
        "incomingCallMode"
      ]
    }
  ],
  "description": "Atualização parcial: informe callsMaxConcurrent e/ou incomingCallMode. Campos omitidos são preservados. Cada atualização aceita incrementa callsConfigVersion. Alterar o modo afeta apenas novas chamadas."
}
```