Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Release notes for Insights Stats API version 3

Release notes list, by API version, all the changes that the API version introduces. Use the notes to check whether your integration is compatible with an API version, and what changes you might need to make before you migrate. This API adheres to Semantic Versioning.

...

Release notes for Insights Stats API version 3

Release notes list, by API version, all the changes that the API version introduces. Use the notes to check whether your integration is compatible with an API version, and what changes you might need to make before you migrate. This API adheres to Semantic Versioning.

VersionRelease date

3.60.17

2023-04-28

3.55.3

2022-09-30

3.54.1

2022-08-10

3.53.18

2022-08-03

3.53.17

2022-07-19

3.52.222022-05-30
3.51.02021-10-15
3.50.32021-08-25
3.50.22021-06-09
3.49.12021-06-04
3.46.02021-03-04
3.44.02021-02-19
3.38.172021-01-15
3.38.152021-01-08
3.38.122020-12-03
3.35.262020-09-25
3.34.92020-05-18
3.33.02020-04-02
3.31.02020-02-05
3.30.42020-01-24
3.30.02020-01-17
3.28.02019-10-31
3.26.02019-07-17
3.18.02019-02-08

Anchor
3.60.17
3.60.17
3.60.17 (2023-04-28)

The release adds a new channel event type of Monitoring to the /interactions, /interactions/ongoing and /interactions/{guid} endpoints. 

The Monitoring channel event represents times when a monitoring party (role is Monitor) is currently monitoring the channel. 

The type property indicates whether the Monitor is listening in, coaching or has joined the call.

Schema changes

EndpointChangeJSONPath
/interactionsNew Event Type$.items..events.type
/interactions/ongoingNew Event Type$.items..events.type
/interactions/{guid}New Event Type$..events.type


...

Anchor
3.55.3
3.55.3
3.55.3 (2022-09-30)

Added VoicemailRecording channel event type to schemas.

The release adds a new channel event type of VoicemailRecording to the /interactions/interactions/ongoingand /interactions/{guid} endpoints. 

The VoicemailRecording channel event represents times when a channel left a voicemail recording.

The type property indicates the type of applet that created the voicemail recording. This could be "VoiceMail" or "MessageTake".

Schema changes

EndpointChangeJSONPath
/interactionsNew Event Type$.items..events.type
/interactions/ongoingNew Event Type$.items..events.type
/interactions/{guid}New Event Type$..events.type


...

Anchor
3.54.1
3.54.1
3.54.1 (2022-08-10)

A new reportingGroup property has been added to the /interactions, /interactions/ongoingand /interactions/{guid} endpoints. 

This is a label used to differentiate interaction plans. Useful for reporting on similar types of interaction plans and their associated interactions

Schema changes

EndpointChangeJSONPath
/interactionsNew Field$.items.interactionPlanMapping.reportingGroup
/interactions/ongoingNew Field$.items.interactionPlanMapping.reportingGroup
/interactions/{guid}New Field$.interactionPlanMapping.reportingGroup


...

Anchor
3.53.18
3.53.18
3.53.18 (2022-08-03)

The include parameter for the /wfm/queue-activity endpoint has been removed. Any queue activity that exits the queue within the search window will be returned.

...

Anchor
3.53.17
3.53.17
3.53.17 (2022-07-19)

The release adds a new /wfm/queue-activity endpoint. This endpoint gets information about activity in queues within an account. This includes how long the interactions were in the queues, why they left those queues, and the total connected and wrap times for agents that handled the interactions after they left the queue.

...

Anchor
3.52.22
3.52.22
3.52.22 (2022-05-30)

...

  • null. Indicates a VCC channel (not an integration).
  • VBC. Indicates VBC channel integration.

Schema changes

EndpointChangeJSONPath
/interactionsNew Field$.items..channel.integrationType
/interactions/ongoingNew Field$.items..channel.integrationType
/interactions/{guid}New Field$.channel.integrationType

...

The release also adds a new channel event type of AgentQueue on the interaction endpoints. AgentQueue events represent the time an agent was queuing during a warm transfer to queue. (AgentQueue only appears if enabled for your account.)

Schema changes

EndpointTypeJSONPath
/queue-timesNew Value$.items..reason
/queue-timesNew Value$.items..category
/interactionsNew Value$.items..events[?(@.type == 'Queue')].properties.result
/interactions/ongoingNew Value$.items..events[?(@.type == 'Queue')].properties.result
/interactions/{guid}New Value$..events[?(@.type == 'Queue')].properties.result
/interactionsNew Event Type$.items..events.type
/interactions/ongoingNew Event Type$.items..events.type
/interactions/{guid}New Event Type$..events.type

...

This value indicates which party role entered that queue.

Schema changes

EndpointTypeJSONPath
/queue-timesNew Field$.items..party.role

...

This value indicates that a queue ended because an agent declined the interaction.

Schema changes

EndpointTypeJSONPath
/queue-timesNew Value$.items..reason
/interactionsNew Value$.items..events[?(@.type == 'Queue')].properties.result
/interactions/ongoingNew Value$.items..events[?(@.type == 'Queue')].properties.result
/interactions/{guid}New Value$..events[?(@.type == 'Queue')].properties.result

...

Code Block
languagejs
themeMidnight
"targets": {
    {
        "targetTimeToAnswer": 30000
    }
}

Schema changes

EndpointTypeJSONPath
/queue-timesNew Field$.items..targets
/queue-timesNew Field$.items..[?(@.type == 'Virtual')].targets.targetTimeToAnswer

...

The new property is a String value representing a UTC timestamp in ISO-8601 format, with three digits of sub-second precision.

Schema changes

EndpointChangeJSONPath
/queue-timesNew Field$.latestUpdate

...

This release adds a categorizedAt property to the interaction, for the /interactions, /interactions/ongoing and /interactions/{guid} endpoints. The categorizedAt property contains the ISO 8601 timestamp indicating when the interaction was categorized, or null if the interaction hasn’t yet been categorized.

Schema changes

EndpointChangeJSONPath
/interactionsNew Field$.items..categorizedAt
/interactions/ongoingNew Field$.items..categorizedAt
/interactions/{guid}New Field$.categorizedAt

...

Code Block
languagejs
themeMidnight
"targets": [
    {
        "virtualQueue": "Virtual Queue Name 1",
        "targetTimeToAnswer": 30000
    },
    {
        "virtualQueue": "Virtual Queue Name 2",
        "targetTimeToAnswer": 60000
    }
]

Schema changes

EndpointTypeJSONPath
/interactionsNew Event Property$.items..events[?(@.type == 'Queue')].properties
/interactions/ongoingNew Event Property$.items..events[?(@.type == 'Queue')].properties
/interactions/{guid}New Event Property$..events[?(@.type == 'Queue')].properties

...

This release adds agent channel CallRating events, for the endpoints listed below. The classification property is a String which contains null (not set) or a number from 1 to 5.

Schema changes

EndpointTypeJSONPath
/interactionsNew Event Type$.items..events.type
/interactions/ongoingNew Event Type$.items..events.type
/interactions/{guid}New Event Type$..events.type

...

The Queue event property InteractionPlan will be deprecated in version v4 of the API.

Schema changes

EndpointTypeJSONPath
/interactionsNew Event Property$.items..events[?(@.type == 'Queue')].properties
/interactions/ongoingNew Event Property$.items..events[?(@.type == 'Queue')].properties
/interactions/{guid}New Event Property$..events[?(@.type == 'Queue')].properties

...

This release adds semiLive and nonLive fields to the endpoints listed below. This provides information about an agents workload whether the on Calls, Chats or Cases. The new fields are Numeric and have a range of 0 to 65535.

Schema changes

EndpointChangeJSONPath
/agent-statusNew Field$.items..workload.semiLive
/agent-statusNew Field$.items..workload.nonLive
/agent-activitiesNew Field$.items[?(@.type == 'Workload')].workload.semiLive
/agent-activitiesNew Field$.items[?(@.type == 'Workload')].workload.nonLive

This release also adds a Disposition channel event for agent channels. Disposition events describe the outcomes of an interaction.

Schema changes

EndpointTypeJSONPath
/interactionsNew Event Type$.items..events.type
/interactions/ongoingNew Event Type$.items..events.type
/interactions/{guid}New Event Type$..events.type

...

This release adds a mediumManager field to the endpoints listed below. This provides information about the application that routed the interaction. The new field is a String value of maximum 50 characters.

Schema changes

EndpointChangeJSONPath
/interactionsNew Field$.items..mediumManager
/interactions/ongoingNew Field$.items..mediumManager
/interactions/{guid}New Field$.mediumManager
/agent-statusNew Field$.items..interaction.mediumManager
/agent-activitiesNew Field$.items[?(@.type == 'Interaction')].interaction.mediumManager
/agent-activities/interactionsNew Field$.items..interaction.mediumManager
/queue-timesNew Field$.items..mediumManager

...

The new field is a String value representing a UTC timestamp in ISO-8601 format, with three digits of sub-second precision.

Schema changes

EndpointChangeJSONPath
/interactionsNew Field$.latestUpdate
/interactions/ongoingNew Field$.latestUpdate

...

Each field of the interactionPlanMapping object may be null. For example, outbound interactions do not go through an interaction plan, so there is no mapping.

Schema changes

EndpointTypeJSONPath
/interactionsNew Field$.items..interactionPlanMapping
/interactions/ongoingNew Field$.items..interactionPlanMapping
/interactions/{guid}New Field$.interactionPlanMapping

...

The new field has three possible values: true, false and null.

Schema changes

EndpointTypeJSONPath
/agent-statusNew Field$.items..presence.eligibleForRouting
/agent-activitiesNew Field$.items[?(@.type == 'Presence')].eligibleForRouting
/agent-activities/presenceNew Field$.items..eligibleForRouting

...