# CallSettingsEventData

Snapshot em data do webhook EventType=call_settings; assinado no envelope existente e entregue somente a inscritos. Cada POST call-settings aceito grava este snapshot e a configuração atomicamente, inclusive desconectado e sem mudança de valor. A configuração inicial é consultada no status. O evento connection usa campos opcionais em instance, não este data. Inclui incomingCallMode; limite e modo formam um único snapshot versionado.

## Campos

| Campo | Tipo | Presença | Descrição |
|---|---|---|---|
| `kind` | `string` | obrigatório | Valor fixo: `"calls"` |
| `callsMaxConcurrent` | `integer` | obrigatório | Limite compartilhado de voz/vídeo e chamadas recebidas/realizadas. Redução não encerra chamadas vivas. Mínimo: `1`. Máximo: `8` |
| `callsConfigVersion` | `integer` | obrigatório | Versão crescente por instância, incrementada a cada POST aceito; independente de seq do envelope. Retries do mesmo evento preservam a versão. Mínimo: `1`. Formato: `int64` |
| `updatedAt` | `string` | obrigatório | Horário UTC da atualização em RFC3339Nano. Comparar versões, não timestamps, para aplicar snapshots. Formato: `date-time` |
| `incomingCallMode` | `string` | obrigatório | 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"` |

## Definição OpenAPI

```json
{
  "type": "object",
  "description": "Snapshot em data do webhook EventType=call_settings; assinado no envelope existente e entregue somente a inscritos. Cada POST call-settings aceito grava este snapshot e a configuração atomicamente, inclusive desconectado e sem mudança de valor. A configuração inicial é consultada no status. O evento connection usa campos opcionais em instance, não este data. Inclui incomingCallMode; limite e modo formam um único snapshot versionado.",
  "properties": {
    "kind": {
      "type": "string",
      "const": "calls"
    },
    "callsMaxConcurrent": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Limite compartilhado de voz/vídeo e chamadas recebidas/realizadas. Redução não encerra chamadas vivas."
    },
    "callsConfigVersion": {
      "type": "integer",
      "format": "int64",
      "minimum": 1,
      "description": "Versão crescente por instância, incrementada a cada POST aceito; independente de seq do envelope. Retries do mesmo evento preservam a versão."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Horário UTC da atualização em RFC3339Nano. Comparar versões, não timestamps, para aplicar snapshots."
    },
    "incomingCallMode": {
      "$ref": "#/components/schemas/IncomingCallMode"
    }
  },
  "required": [
    "kind",
    "callsMaxConcurrent",
    "callsConfigVersion",
    "updatedAt",
    "incomingCallMode"
  ],
  "additionalProperties": true,
  "example": {
    "kind": "calls",
    "callsMaxConcurrent": 2,
    "callsConfigVersion": 3,
    "updatedAt": "2026-09-19T15:00:00.123456789Z",
    "incomingCallMode": "allow"
  }
}
```