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. 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"
  }
}