/icws/{sessionId}/configuration/defaults/workgroup

GET

/icws/{sessionId}/configuration/defaults/workgroup

Returns an initialized workgroup object with default values.
Feature Version
configuration 1

Request

Parameters
Type
Name
Comments
Header
ININ-ICWS-CSRF-Token

Required

The ININ session token necessary for all calls that require a security or user context.

    Header
    Cookie

    Required

    The session cookie. With the exception of the connection request, all requests must provide a session cookie.

      Template
      sessionId

      Required

      The ININ session ID necessary for all calls that require a security or user context.

        Response

        200 - OK
        An initialized workgroup object with defaults is in the response.
        workgroup
        Represents the workgroup configuration object.
        Property
        Value
        Comments
        id
        String

        Required

        The unique identifier used to reference this configuration object.
        displayName
        String
        The display name of this configuration object.

        This property can be null.

        uri
        Uri
        A URI used to access this configuration object.
        createdDate
        DateTime
        The date this configuration object was created.

        This is a read only property and can not be changed with PUT or POST operations.

        This property can be null.

        name
        String

        Required

        The key identifying this pair.
        value
        String

        Required

        The value of this pair.

        This property can be null.

        lastModifiedDate
        DateTime
        The date this configuration object was last modified.

        This is a read only property and can not be changed with PUT or POST operations.

        This property can be null.

        notes
        String
        The notes for this configuration object.

        This property can be null.

        id
        String
        The unique identifier used to reference this configuration object. The value of this can be null when the grouping of this value is All. Otherwise, it is required.

        This property can be null.

        displayName
        String
        The display name of this configuration object.

        This property can be null.

        uri
        Uri
        A URI used to access this configuration object.

        This property can be null.

        none
        0
        Represents no object type.
        acg
        1
        Represents an ACG object type.
        workgroup
        2
        Represents the workgroup object type.
        lineGroup
        3
        Represents the lineGroup object type.
        feedbackSurveyGroup
        4
        Represents the feedbackSurveyGroup object type.
        all
        0
        Represents all possible ConfigurationIds.
        single
        1
        Represents a single ConfigurationId.
        group
        2
        Represents a grouping of ConfigurationIds where each ConfigurationId is a member of some other Aggregate (Workgroup, Role, ...).
        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        actualValue
        Boolean
        The value directly assigned to this configuration object. This value is required for POST and PUT operations.

        This property can be null.

        effectiveValue
        Boolean
        The effective value of this property, from the blending of the actualValue with the inheritedValue. This value is required for GET object and GET object list operations.

        This property can be null.

        inheritedValue
        Boolean
        The actual inherited value, based on this configuration object's membership/inheritance, such as Workgroup, Role, and Default User.

        This property can be null.

        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        values
        Boolean

        Required

        acdSaveRepliesToSentItemsFolder
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        acdUseAvailablityTime
        Boolean

        Setting this property to null will set it to its default value.

        Default value: true

        agentScoreChange
        Int
        The value must conform to all of these criteria:
        • Is a value from -1000 to 1000.

        Setting this property to null will set it to its default value.

        Default value: -10

        callbackMaxRetry
        Int
        The value must conform to all of these criteria:
        • Is a value of at least 0.

        Setting this property to null will set it to its default value.

        Default value: 0

        callbackServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [300, 600, 900, 1800, 3600, 7200, 14400, 28800]

        Property type documentation:

        Represents a collection of durations.

        callbackServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 14400

        callbackSnoozeDuration
        Int
        The value must conform to all of these criteria:
        • Is a value of at least 0.

        Setting this property to null will set it to its default value.

        Default value: 0

        callServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [5, 10, 20, 30, 40, 50, 60, 120]

        Property type documentation:

        Represents a collection of durations.

        callServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 30

        callStatisticsPeriod
        Int
        The value must conform to all of these criteria:
        • Is a value from 5 to 480.

        Setting this property to null will set it to its default value.

        Default value: 30

        captureInRecordings
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        chatServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [10, 20, 30, 45, 60, 90, 120, 240]

        Property type documentation:

        Represents a collection of durations.

        chatServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 30

        clientWaitTimeout
        Int
        The value must conform to all of these criteria:
        • Is a value from 0 to 60.

        Setting this property to null will set it to its default value.

        Default value: 30

        emailServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [300, 600, 1200, 1800, 3600, 7200, 14400, 28800]

        Property type documentation:

        Represents a collection of durations.

        emailServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 14400

        estimatedCallTimeInterval
        Int
        The value must conform to all of these criteria:
        • Is a value from 5 to 480.

        Setting this property to null will set it to its default value.

        Default value: 30

        executeTransferActionOnUserTransfer
        Boolean

        Setting this property to null will set it to its default value.

        Default value: true

        extension
        String
        The value must conform to all of these criteria:
        • Is a value representing a valid Extension.

        This property can be null.

        faxCapability
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        genericServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [10, 20, 30, 45, 60, 90, 120, 240]

        Property type documentation:

        Represents a collection of durations.

        genericServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 30

        gracePeriodBeforeNew
        Int
        The value must conform to all of these criteria:
        • Is a value from 0 to 120.

        Setting this property to null will set it to its default value.

        Default value: 10

        hasQueue
        Boolean

        This is a read only property and can not be changed with PUT or POST operations.

        Setting this property to null will set it to its default value.

        Default value: false

        actualValue
        Duration
        The value directly assigned to this configuration object. This value is required for POST and PUT operations.

        This property can be null.

        effectiveValue
        Duration
        The effective value of this property, from the blending of the actualValue with the inheritedValue. This value is required for GET object and GET object list operations.

        This property can be null.

        inheritedValue
        Duration
        The actual inherited value, based on this configuration object's membership/inheritance, such as Workgroup, Role, and Default User.

        This property can be null.

        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        values
        Duration

        Required

        isAcdEmailRoutingActive
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        isActive
        Boolean

        Setting this property to null will set it to its default value.

        Default value: true

        isCallbackEnabled
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        isExemptHeldInteractionsEnabled
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        isWrapUpActive
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        keypadWaitTimeout
        Int
        The value must conform to all of these criteria:
        • Is a value from 0 to 60.

        Setting this property to null will set it to its default value.

        Default value: 30

        maximumChatReponseTime
        Int
        The value must conform to all of these criteria:
        • Is a value from 0 to 3600.

        This property can be null.

        maxNumberOfExempt
        Int
        The value must conform to all of these criteria:
        • Is a value from 1 to 100.

        Setting this property to null will set it to its default value.

        Default value: 1

        membersSpanSites
        Boolean
        This value can only be set to true if the homesite is participating in multi-site configuration. The value must conform to all of these criteria:
        • Is a value referring to an existing configured item.

        Setting this property to null will set it to its default value.

        Default value: false

        canReceiveEncryptedEmail
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        emailAddress
        String

        This property is required to be present in POST operations.

        inboundFolder
        String
        For inbound mailbox types, this folder must exist in the configured mailbox. For non-inbound mailboxes, this must be null. An Invalid Folder validation error will be returned otherwise. The value must conform to all of these criteria:
        • The ACD mailbox inbound folder must exist or be set to null.

        This property can be null.

        mailboxMoniker
        String
        When this value is changed for inbound mailboxes, the current Inbound Folder must exist in the new mailbox or an Invalid Folder validation error will be returned with the folder name. The value must conform to all of these criteria:
        • The ACD mailbox inbound folder must exist or be set to null.

        This property is required to be present in POST operations.

        inbound
        0
        outbound
        1
        outboundAndInbound
        2
        nameSpellingsAsr
        List [Unbounded]: String

        This property can be null.

        Property type documentation:

        Represents a collection of strings.

        nameSpellingTts
        String

        This property can be null.

        onHoldMessage
        String

        This property can be null.

        onHoldMusic
        String

        This property can be null.

        operatorTarget
        String

        This property can be null.

        actualValue
        String
        The value directly assigned to this configuration object. This value is required for POST and PUT operations.

        This property can be null.

        effectiveValue
        String
        The effective value of this property, from the blending of the actualValue with the inheritedValue. This value is required for GET object and GET object list operations.

        This property can be null.

        inheritedValue
        String
        The actual inherited value, based on this configuration object's membership/inheritance, such as Workgroup, Role, and Default User.

        This property can be null.

        none
        0
        The property was not inherited.
        Workgroup
        1
        The property was inherited from a Workgroup configuration object.
        Role
        2
        The property was inherited from a Role configuration object.
        DefaultUser
        3
        The property was inherited from the Default User configuration object.
        ClientConfigurationTemplate
        4
        The property was inherited from a Client Configuration Template configuration object.
        values
        String

        Required

        playToExternalPartiesOnly
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        id
        String

        Required

        The unique identifier used to reference this object.
        displayName
        String
        The display name of this object.

        This property can be null.

        None
        0
        Custom
        1
        GroupRing
        2
        Sequential
        3
        RoundRobin
        4
        ACD
        5
        recordAll
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        revertToAvailableTimeout
        Int
        The value must conform to all of these criteria:
        • Is a value from 0 to 10000.

        Setting this property to null will set it to its default value.

        Default value: 0

        proficiency
        Int

        Required

        desireToUse
        Int

        Required

        socialConversationServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.
        Feature Version
        configuration 14

        Setting this property to null will set it to its default value.

        Default value: [300, 600, 1200, 1800, 3600, 7200, 14400, 28800]

        Property type documentation:

        Represents a collection of durations.

        socialConversationServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.
        Feature Version
        configuration 14

        Setting this property to null will set it to its default value.

        Default value: 14400

        socialDirectMessageServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.
        Feature Version
        configuration 14

        Setting this property to null will set it to its default value.

        Default value: [10, 20, 30, 45, 60, 90, 120, 240]

        Property type documentation:

        Represents a collection of durations.

        socialDirectMessageServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.
        Feature Version
        configuration 14

        Setting this property to null will set it to its default value.

        Default value: 14400

        statisticsShiftStarts
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a value from 0 to 86340.

        Setting this property to null will set it to its default value.

        Default value: 0:00

        Property type documentation:

        Represents a collection of durations.

        useRecordingTones
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        useTiffForFaxes
        Boolean

        Setting this property to null will set it to its default value.

        Default value: false

        invalid
        0
        call
        1
        chat
        2
        email
        3
        generic
        4
        callback
        5
        workItem
        6
        socialDirectMessage
        7
        Feature Version
        configuration 14
        socialConversation
        8
        Feature Version
        configuration 14
        utilization
        Int

        Required

        maxAssignable
        Int

        Required

        voicemailMessage
        String

        This property can be null.

        displayName
        String

        This property can be null.

        emailAddress
        String

        This property can be null.

        none
        0
        interactionMessageStore
        1
        imapSmtp
        2
        genericProvider
        3
        workItemServiceLevelDistribution
        List [Unbounded]: Duration
        Is a collection of items that each conform to all of these criteria:
        • Is a collection containing 1 to 14 items.
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: [30, 60, 900, 1800, 3600, 14400, 86400, 172800]

        Property type documentation:

        Represents a collection of durations.

        workItemServiceLevelTarget
        Duration
        The value must conform to all of these criteria:
        • Is a value from 0 to 604800.

        Setting this property to null will set it to its default value.

        Default value: 14400

        wrapUpPrompt
        String

        This property can be null.

        wrapUpTimeout
        Int
        The value must conform to all of these criteria:
        • Is a value of at least 1.
        • Both the values of wrapUpStatus and wrapUpTimeout needs both to be null or not null.

        This property can be null.

        500 - Internal Server Error
        An unexpected error occurred while processing the request.

        Error Responses

        Error Identifier
        Error Type
        Error Description
        error.request.internalServerError
        Type: urn:inin.com:common:error
        The server encountered an unexpected, internal error.
        Feature Version
        configuration 2
        error.request.timeout
        Type: urn:inin.com:common:error
        The request timed out.
        Feature Version
        configuration 2
        error
        Provides additional detail for an error.
        Property
        Value
        Comments
        errorId
        String
        The error identifier that describes the current error.
        message
        String

        Required

        A message that describes the current error.
        400 - Bad Request
        The request was invalid. This can occur when the message body is malformed or missing required items. This will also occur if a required header or query string parameter is missing or invalid.
        error
        Provides additional detail for an error.
        Property
        Value
        Comments
        errorId
        String
        The error identifier that describes the current error.
        message
        String

        Required

        A message that describes the current error.
        401 - Unauthorized
        The specified session token is missing, invalid, or has expired.
        Parameters
        Type
        Name
        Comments
        Header
        WWW-Authenticate

        Required

        Indicates that the client needs to authenticate using a custom ICWS scheme, which supports a realm of type ICWS and a location which is the URL at which the client can authenticate. A typical example would be the following.

        WWW-Authenticate: ICWS realm="ICWS" location="/ICWS/connection"

          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          410 - Gone
          This resource has been deprecated and removed from the API.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.