...
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.
Version | Release Date |
---|---|
3.52.22 | 2022-05-30 |
3.51.0 | 2021-10-15 |
3.50.3 | 2021-08-25 |
3.50.2 | 2021-06-09 |
3.49.1 | 2021-06-04 |
3.46.0 | 2021-03-04 |
3.44.0 | 2021-02-19 |
3.38.17 | 2021-01-15 |
3.38.15 | 2021-01-08 |
3.38.12 | 2020-12-03 |
3.35.26 | 2020-09-25 |
3.34.9 | 2020-05-18 |
3.33.0 | 2020-04-02 |
3.31.0 | 2020-02-05 |
3.30.4 | 2020-01-24 |
3.30.0 | 2020-01-17 |
3.28.0 | 2019-10-31 |
3.26.0 | 2019-07-17 |
3.18.0 | 2019-02-08 |
Anchor | ||||
---|---|---|---|---|
|
2022-05-30
)This release adds a channel IntegrationType property to the interaction channels, for the /interactions
, /interactions/ongoing
and /interactions/{guid}
endpoints.
This field represent the following integration types:
- null. Indicates a VCC channel (not an integration).
- VBC. Indicates VBC channel integration.
Schema changes
Endpoint | Change | JSONPath |
---|---|---|
/interactions | New Field | $.items..channel.integrationType |
/interactions/ongoing | New Field | $.items..channel.integrationType |
/interactions/{guid} | New Field | $.channel.integrationType |
...
Anchor | ||||
---|---|---|---|---|
|
2021-10-15
)...
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
Endpoint | Type | JSONPath |
---|---|---|
/queue-times | New Value | $.items..reason |
/queue-times | New Value | $.items..category |
/interactions | New Value | $.items..events[?(@.type == 'Queue')].properties.result |
/interactions/ongoing | New Value | $.items..events[?(@.type == 'Queue')].properties.result |
/interactions/{guid} | New Value | $..events[?(@.type == 'Queue')].properties.result |
/interactions | New Event Type | $.items..events.type |
/interactions/ongoing | New Event Type | $.items..events.type |
/interactions/{guid} | New Event Type | $..events.type |
...
This value indicates which party role entered that queue.
Schema changes
Endpoint | Type | JSONPath |
---|---|---|
/queue-times | New Field | $.items..party.role |
...
This value indicates that a queue ended because an agent declined the interaction.
Schema changes
Endpoint | Type | JSONPath |
---|---|---|
/queue-times | New Value | $.items..reason |
/interactions | New Value | $.items..events[?(@.type == 'Queue')].properties.result |
/interactions/ongoing | New Value | $.items..events[?(@.type == 'Queue')].properties.result |
/interactions/{guid} | New Value | $..events[?(@.type == 'Queue')].properties.result |
...
Code Block | ||||
---|---|---|---|---|
| ||||
"targets": { { "targetTimeToAnswer": 30000 } } |
Schema changes
Endpoint | Type | JSONPath |
---|---|---|
/queue-times | New Field | $.items..targets |
/queue-times | New 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
Endpoint | Change | JSONPath |
---|---|---|
/queue-times | New 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
Endpoint | Change | JSONPath |
---|---|---|
/interactions | New Field | $.items..categorizedAt |
/interactions/ongoing | New Field | $.items..categorizedAt |
/interactions/{guid} | New Field | $.categorizedAt |
...
Code Block | ||||
---|---|---|---|---|
| ||||
"targets": [ { "virtualQueue": "Virtual Queue Name 1", "targetTimeToAnswer": 30000 }, { "virtualQueue": "Virtual Queue Name 2", "targetTimeToAnswer": 60000 } ] |
Schema changes
Endpoint | Type | JSONPath |
---|---|---|
/interactions | New Event Property | $.items..events[?(@.type == 'Queue')].properties |
/interactions/ongoing | New 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
Endpoint | Type | JSONPath |
---|---|---|
/interactions | New Event Type | $.items..events.type |
/interactions/ongoing | New 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
Endpoint | Type | JSONPath |
---|---|---|
/interactions | New Event Property | $.items..events[?(@.type == 'Queue')].properties |
/interactions/ongoing | New 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
Endpoint | Change | JSONPath |
---|---|---|
/agent-status | New Field | $.items..workload.semiLive |
/agent-status | New Field | $.items..workload.nonLive |
/agent-activities | New Field | $.items[?(@.type == 'Workload')].workload.semiLive |
/agent-activities | New 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
Endpoint | Type | JSONPath |
---|---|---|
/interactions | New Event Type | $.items..events.type |
/interactions/ongoing | New 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
Endpoint | Change | JSONPath |
---|---|---|
/interactions | New Field | $.items..mediumManager |
/interactions/ongoing | New Field | $.items..mediumManager |
/interactions/{guid} | New Field | $.mediumManager |
/agent-status | New Field | $.items..interaction.mediumManager |
/agent-activities | New Field | $.items[?(@.type == 'Interaction')].interaction.mediumManager |
/agent-activities/interactions | New Field | $.items..interaction.mediumManager |
/queue-times | New 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
Endpoint | Change | JSONPath |
---|---|---|
/interactions | New Field | $.latestUpdate |
/interactions/ongoing | New 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
Endpoint | Type | JSONPath |
---|---|---|
/interactions | New Field | $.items..interactionPlanMapping |
/interactions/ongoing | New Field | $.items..interactionPlanMapping |
/interactions/{guid} | New Field | $.interactionPlanMapping |
...
The new field has three possible values: true
, false
and null.
Schema changes
Endpoint | Type | JSONPath |
---|---|---|
/agent-status | New Field | $.items..presence.eligibleForRouting |
/agent-activities | New Field | $.items[?(@.type == 'Presence')].eligibleForRouting |
/agent-activities/presence | New Field | $.items..eligibleForRouting |
...