Webex · Schema

CreateCallQueueObject

CallingCollaborationCommunicationEnterpriseMessagingVideo Conferencing

Properties

Name	Type	Description
name	string	Unique name for the call queue.
phoneNumber	string	Primary phone number of the call queue. Either a `phoneNumber` or `extension` is mandatory.
extension	string	Primary phone extension of the call queue. Either a `phoneNumber` or extension is mandatory.
languageCode	string	Language code.
firstName	string	First name to be shown when calls are forwarded out of this call queue. Defaults to ".".
lastName	string	Last name to be shown when calls are forwarded out of this call queue. Defaults to `phoneNumber` if set, otherwise defaults to call group name.
timeZone	string	Time zone for the call queue.
callPolicies	object	Policy controlling how calls are routed to `agents`.
queueSettings	object	Overall call queue settings.
agents	array	People, workspaces and virtual lines that are eligible to receive calls.
callingLineIdPolicy	string	Which type of Calling Line ID Policy Selected for Call Queue. * `DIRECT_LINE` - Calling Line ID Policy will show the caller's direct line number. * `LOCATION_NUMBER` - Calling Line ID Policy will show
callingLineIdPhoneNumber	string	Calling line ID Phone number which will be shown if CUSTOM is selected.
allowCallWaitingForAgentsEnabled	boolean	If `true`, call waiting is enabled for the agents.
allowAgentJoinEnabled	boolean	Whether or not to allow agents to join or unjoin a queue.
phoneNumberForOutgoingCallsEnabled	boolean	When true, indicates that the agent's configuration allows them to use the queue's Caller ID for outgoing calls.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CreateCallQueueObject",
  "title": "CreateCallQueueObject",
  "type": "object",
  "required": [
    "name",
    "callPolicies",
    "queueSettings",
    "agents"
  ],
  "properties": {
    "name": {
      "type": "string",
      "example": "CallQueue-1",
      "description": "Unique name for the call queue."
    },
    "phoneNumber": {
      "type": "string",
      "example": "+12225555309",
      "description": "Primary phone number of the call queue. Either a `phoneNumber` or `extension` is mandatory."
    },
    "extension": {
      "type": "string",
      "example": "5309",
      "description": "Primary phone extension of the call queue. Either a `phoneNumber` or extension is mandatory."
    },
    "languageCode": {
      "type": "string",
      "example": "en-US",
      "description": "Language code."
    },
    "firstName": {
      "type": "string",
      "example": "Hakim",
      "description": "First name to be shown when calls are forwarded out of this call queue. Defaults to \".\"."
    },
    "lastName": {
      "type": "string",
      "example": "Smith",
      "description": "Last name to be shown when calls are forwarded out of this call queue. Defaults to `phoneNumber` if set, otherwise defaults to call group name."
    },
    "timeZone": {
      "type": "string",
      "example": "America/Chicago",
      "description": "Time zone for the call queue."
    },
    "callPolicies": {
      "$ref": "#/components/schemas/PostCallQueueCallPolicyObject",
      "description": "Policy controlling how calls are routed to `agents`."
    },
    "queueSettings": {
      "$ref": "#/components/schemas/CallQueueQueueSettingsObject",
      "description": "Overall call queue settings."
    },
    "agents": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PostPersonPlaceVirtualLineCallQueueObject"
      },
      "description": "People, workspaces and virtual lines that are eligible to receive calls."
    },
    "callingLineIdPolicy": {
      "type": "string",
      "enum": [
        "DIRECT_LINE",
        "LOCATION_NUMBER",
        "CUSTOM"
      ],
      "description": "Which type of Calling Line ID Policy Selected for Call Queue.\n * `DIRECT_LINE` - Calling Line ID Policy will show the caller's direct line number.\n * `LOCATION_NUMBER` - Calling Line ID Policy will show the main number for the location.\n * `CUSTOM` - Calling Line ID Policy will show the value from the `callingLineIdPhoneNumber` field.\n"
    },
    "callingLineIdPhoneNumber": {
      "type": "string",
      "example": "+12072342368",
      "description": "Calling line ID Phone number which will be shown if CUSTOM is selected."
    },
    "allowCallWaitingForAgentsEnabled": {
      "type": "boolean",
      "description": "If `true`, call waiting is enabled for the agents."
    },
    "allowAgentJoinEnabled": {
      "type": "boolean",
      "description": "Whether or not to allow agents to join or unjoin a queue."
    },
    "phoneNumberForOutgoingCallsEnabled": {
      "type": "boolean",
      "example": true,
      "description": "When true, indicates that the agent's configuration allows them to use the queue's Caller ID for outgoing calls."
    }
  }
}