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.

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

CampoTipoPresençaDescrição
callsMaxConcurrentintegercondicionalLimite 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
incomingCallModestringcondicionalComportamento 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"
expectedCallsConfigVersionintegeropcionalComparaçã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."
}