/icws/{sessionId}/interactions/{interactionId}/consult

Feature Version
interactions 6

POST

/icws/{sessionId}/interactions/{interactionId}/consult

Initiates a consult transfer between the caller, the agent, and a consult. This request must contain the target or queueID property. Specifying or omitting both target and queueID will result in an error.
Feature Version
interactions 6

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.

        Template
        interactionId

        Required

        The interaction ID for the interaction resource.

          Representations
          createConsultParameters
          Property
          Value
          Comments
          target
          String

          Conditionally Required

          The target number or queue.

          Note

          Prior to version 13 when queueID was added, this property is required. Since version 13, if both target and queueID are specified or omitted, the server will return error.

          system
          0
          A special Queue that represents interactions on a user's queue or station queue.
          user
          1
          Represents a user's interactions.
          workgroup
          2
          Represents a workgroup's interactions. Interactions passed to a Workgroup queue can be picked up by its member agents.
          station
          3
          Represents a station's interactions.
          queueName
          String

          Required

          The name of the queue being identified.
          None
          0
          Allocated
          1
          Started
          2
          Completed
          3
          [key]
          String

          Required

          The key identifying this pair.
          [value]
          String

          Required

          The value of this pair.

          Response

          201 - Created

          The consult was successfully created.

          Parameters
          Type
          Name
          Comments
          Header
          Location

          Required

          A URL specifying where a representation of the consult transfer can be found.

            consultTransferResult
            Property
            Value
            Comments
            consultId
            String

            Required

            An ID for the created consult transfer.
            consultInteractionId
            String

            Required

            The interaction ID between the agent and the consult.
            Associated Message
            The audience, in the consult transfer, has changed.
            consultMessage
            A message sent when the consultTransfer's audience has changed.
            Property
            Value
            Comments
            __type
            "urn:inin.com:interactions:consultMessage"

            Required

            The JSON type representing this option.
            isDelta
            Boolean

            Required

            When true, this property indicates that some optional properties that have not changed may be omitted (all required properties will be included). In this case, the client side cache should be updated with the values for the properties provided and no change should be made for the properties not included as part of the message. This allows the API to deliver smaller messages that only represent the properties that have changed.

            When this property is false, the client side cache for this subscription should be cleared and replaced with the data provided in the message. For the initial message in response to a subscription, this property will be false to indicate the cache should be initialized with the data provided.

            originalParty
            Boolean
            The original party has two-way audio with the agent.
            consultedParty
            Boolean
            The consulted party has two-way audio with the agent.
            Associated Message

            The interaction was replaced by another (e.g. during a consult transfer). This message will only be generated for the session creating a consult transfer or other sessions that are subscribed to queues that contain the associated interactions.

            The isDelta property will always be false for these messages.

            interactionMorphedMessage
            Property
            Value
            Comments
            __type
            "urn:inin.com:interactions:interactionMorphedMessage"

            Required

            The JSON type representing this option.
            isDelta
            Boolean

            Required

            When true, this property indicates that some optional properties that have not changed may be omitted (all required properties will be included). In this case, the client side cache should be updated with the values for the properties provided and no change should be made for the properties not included as part of the message. This allows the API to deliver smaller messages that only represent the properties that have changed.

            When this property is false, the client side cache for this subscription should be cleared and replaced with the data provided in the message. For the initial message in response to a subscription, this property will be false to indicate the cache should be initialized with the data provided.

            interactionID
            String

            Required

            The interaction's ID.
            newInteractionID
            String

            Required

            The new interaction ID after the morph.
            404 - Not Found
            The interaction does not exist.
            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.
            403 - Forbidden
            You do not have rights to the interaction.
            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.
              500 - Internal Server Error
              An unexpected error occurred while processing the request.
              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.