Get a List of Interactions

You are here:

Get a List of Interactions

Use a GET request to retrieve a list of interactions, with details such as when the interaction started, ended, and which agents were involved. You must have the INTERACTIONS_API_READ_ALL permission to retrieve the interaction details. You can request up to 1000 interactions per page.

This request returns:

All interactions on a tenant with the most recent interaction listed first.
All data, except parameters that have a null value, that is stored for each interaction. You can add a filter to include the null parameter. See Example: Including Null Values in a Response.

You can use other filter parameters to search for interactions that match your specified criteria. See Searching Interactions.

Request

Sample Request

curl GET https://api.cxengage.net/v1/tenants/<tenantID>/interactions

Request Parameters

The table below lists and describes the parameters that you can include in the request.

Parameter	Description
tenantID required UUID	The tenant's unique identifier.

Parameter

Description

tenantID

required

UUID

The tenant's unique identifier.

Response

Sample Response

The request returns JSON structured like the example below:

{
    "page": null,
    "limit": 10,
    "offset": 0,
    "tenantId": "2336d1ec-c956-47e1-b3b1-fe8fde81b2b4",
    "total": 127,
    "tenantName": "Your Tenant",
    "tenantTimezone": "US/Eastern",
    "results": [
        
        {
            "tenantId": "2336d1ec-c956-47e1-b3b1-fe8fde81b2b4",
            "customerAbandonTime": 41.149,
            "endTimestamp": "2017-12-29T14:24:38.625Z",
            "flowId": "28219e00-82b6-11e7-b08f-6e56a766befb",
            "interactionTime": 41.154,
            "segments": [
                {
                    "segmentNumber": 0,
                    "segmentCancelled": true,
                    "interactionSegmentId": "e80733e0-eca3-11e7-9429-6aa21fb32015",
                    "segmentStartType": "interaction",
                    "endTimestamp": "2017-12-29T14:24:38.620Z",
                    "segmentEndType": "customer-disconnect",
                    "segmentCancelTime": 41.149,
                    "startTimestamp": "2017-12-29T14:23:57.471Z",
                    "segmentTime": 41.149
                }
            ],
            "interactionId": "e6952d50-eca3-11e7-ba92-25b49e03c3e7",
            "contactPoint": "+15553005555",
            "customer": "+15553005556",
            "customerHolds": 0,
            "startTimestamp": "2017-12-29T14:23:57.471Z",
            "ivrTime": 1.793,
            "flowName": "Basic Flow",
            "queues": [
                {
                    "queueEntryLength": 1,
                    "interactionSegmentId": "e80733e0-eca3-11e7-9429-6aa21fb32015",
                    "queueAbandonTime": 39.356,
                    "platformQueueId": 743,
                    "queueAbandoned": true,
                    "endTimestamp": "2017-12-29T14:24:38.620Z",
                    "slaAbandoned": true,
                    "queueExitType": "abandon",
                    "queueEntryType": "ivr",
                    "interactionQueueId": "e91807a0-eca3-11e7-8f8a-740a2f77d3cf",
                    "queueType": "queue",
                    "startTimestamp": "2017-12-29T14:23:59.264Z",
                    "queueName": "Support",
                    "queueTime": 39.356,
                    "slaTime": 39.356,
                    "queueId": "3703e470-834a-11e7-b08f-6e56a766befb"
                }
            ],
            "direction": "inbound",
            "channelType": "voice"
        },
        {
            "tenantId": "2336d1ec-c956-47e1-b3b1-fe8fde81b2b4",
            "customerAbandonTime": 94.166,
            "endTimestamp": "2017-12-07T19:22:07.638Z",
            "flowId": "28219e00-82b6-11e7-b08f-6e56a766befb",
            "interactionTime": 94.244,
            "segments": [
                {
                    "segmentNumber": 0,
                    "segmentCancelled": true,
                    "interactionSegmentId": "b2233520-db83-11e7-b86d-6aa612aefe9d",
                    "segmentStartType": "interaction",
                    "endTimestamp": "2017-12-07T19:22:07.560Z",
                    "segmentEndType": "customer-disconnect",
                    "segmentCancelTime": 94.166,
                    "startTimestamp": "2017-12-07T19:20:33.394Z",
                    "segmentTime": 94.166
                }
            ],
            "interactionId": "b2109780-db83-11e7-9709-c2b07aa3bee9",
            "contactPoint": "+15553005555",
            "customer": "+15553005556",
            "customerHolds": 0,
            "startTimestamp": "2017-12-07T19:20:33.394Z",
            "ivrTime": 0.173,
            "flowName": "Basic Flow",
            "queues": [
                {
                    "queueEntryLength": 1,
                    "interactionSegmentId": "b2233520-db83-11e7-b86d-6aa612aefe9d",
                    "queueAbandonTime": 93.993,
                    "platformQueueId": 743,
                    "queueAbandoned": true,
                    "endTimestamp": "2017-12-07T19:22:07.560Z",
                    "slaAbandoned": true,
                    "queueExitType": "abandon",
                    "queueEntryType": "ivr",
                    "interactionQueueId": "b23cb090-db83-11e7-95f3-204e8fcfa723",
                    "queueType": "queue",
                    "startTimestamp": "2017-12-07T19:20:33.567Z",
                    "queueName": "Support",
                    "queueTime": 93.993,
                    "slaTime": 93.993,
                    "queueId": "3703e470-834a-11e7-b08f-6e56a766befb"
                }
            ],
            "direction": "inbound",
            "channelType": "voice"
        },
        {
            "tenantId": "2336d1ec-c956-47e1-b3b1-fe8fde81b2b4",
            "customerAbandonTime": 15.923,
            "flagged": true,
            "endTimestamp": "2017-12-05T22:56:52.020Z",
            "flowId": "28219e00-82b6-11e7-b08f-6e56a766befb",
            "interactionTime": 16.003,
            "segments": [
                {
                    "segmentNumber": 0,
                    "segmentCancelled": true,
                    "interactionSegmentId": "8ba30210-da0f-11e7-b09a-a24faebeabe1",
                    "segmentStartType": "interaction",
                    "endTimestamp": "2017-12-05T22:56:51.940Z",
                    "segmentEndType": "customer-disconnect",
                    "segmentCancelTime": 15.923,
                    "startTimestamp": "2017-12-05T22:56:36.017Z",
                    "segmentTime": 15.923
                }
            ],
            "interactionId": "8b8e8fb0-da0f-11e7-9709-c2b07aa3bee9",
            "contactPoint": ""+15553005555"",
            "customer": "+19057555612",
            "customerHolds": 0,
            "startTimestamp": "2017-12-05T22:56:36.017Z",
            "ivrTime": 0.183,
            "flowName": "Basic Flow",
            "queues": [
                {
                    "queueEntryLength": 1,
                    "interactionSegmentId": "8ba30210-da0f-11e7-b09a-a24faebeabe1",
                    "queueAbandonTime": 15.74,
                    "platformQueueId": 743,
                    "queueAbandoned": true,
                    "endTimestamp": "2017-12-05T22:56:51.940Z",
                    "slaAbandoned": true,
                    "queueExitType": "abandon",
                    "queueEntryType": "ivr",
                    "interactionQueueId": "8bbe0420-da0f-11e7-95f3-204e8fcfa723",
                    "queueType": "queue",
                    "startTimestamp": "2017-12-05T22:56:36.200Z",
                    "queueName": "Support",
                    "queueTime": 15.74,
                    "slaTime": 15.74,
                    "queueId": "3703e470-834a-11e7-b08f-6e56a766befb"
                }
            ],
            "direction": "inbound",
            "channelType": "voice"
        },
        {
            "tenantId": "2336d1ec-c956-47e1-b3b1-fe8fde81b2b4",
            "endTimestamp": "2017-12-05T18:10:59.704Z",
            "flowId": "8590ce70-8668-11e7-b018-9a5ac3da6edd",
            "customerTransfers": 8,
            "interactionTime": 20.414,
            "segments": [
                {
                    "endTimestamp": "2017-12-05T18:12:05.319Z",
                    "interactionSegmentId": "996e1290-d9e7-11e7-b3f1-2675b8cf7e39",
                    "segmentEndType": "success",
                    "segmentStartType": "interaction",
                    "segmentToAgentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "startTimestamp": "2017-12-05T18:10:39.290Z",
                    "segmentNumber": 0,
                    "segmentTime": 86.029
                },
                {
                    "interactionSegmentId": "bbb2f5f0-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:36.783Z",
                    "segmentNumber": 2
                },
                {
                    "interactionSegmentId": "baad1eb0-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:35.068Z",
                    "segmentNumber": 1
                },
                {
                    "interactionSegmentId": "bbd3eb70-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:37.000Z",
                    "segmentNumber": 3
                },
                {
                    "interactionSegmentId": "bd6f24e0-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:39.694Z",
                    "segmentNumber": 4
                },
                {
                    "interactionSegmentId": "c033c320-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:44.339Z",
                    "segmentNumber": 5
                },
                {
                    "interactionSegmentId": "c1bfe160-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:46.934Z",
                    "segmentNumber": 7
                },
                {
                    "interactionSegmentId": "c19cc900-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:46.704Z",
                    "segmentNumber": 6
                },
                {
                    "interactionSegmentId": "c678ae80-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "transfer": true,
                    "segmentCancelled": true,
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "segmentStartType": "transfer",
                    "startTimestamp": "2017-12-05T18:11:54.858Z",
                    "segmentNumber": 8
                }
            ],
            "interactionId": "98a56b60-d9e7-11e7-9c4e-7eab04d876eb",
            "contactPoint": "kdemo@gmail.com",
            "customer": "kdemo@service.com",
            "customerHolds": 0,
            "startTimestamp": "2017-12-05T18:10:39.290Z",
            "ivrTime": 0.203,
            "agents": [
                {
                    "platformAgentId": 15184,
                    "agentWorkAccepted": true,
                    "agentName": "Kris Agent",
                    "agentWorkOfferTime": 18.186,
                    "agentWrapUpTime": 3.822,
                    "sessionId": "60938bf0-d9e5-11e7-9330-6833ccd45639",
                    "interactionSegmentId": "996e1290-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "interactionAgentId": "9a60aff0-d9e7-11e7-816a-c7c1ef97bf27",
                    "endTimestamp": "2017-12-05T18:12:05.319Z",
                    "agentHandleTime": 65.36,
                    "agentFocusTime": 145.5,
                    "startTimestamp": "2017-12-05T18:10:40.879Z",
                    "tenantAgentId": 8376,
                    "agentConversationTime": 61.538,
                    "agentReadTime": 60.151,
                    "queueId": "3703e470-834a-11e7-b08f-6e56a766befb",
                    "agentTalkTime": 61.538,
                    "agentWorkAcceptedTime": 18.186
                }
            ],
            "flowName": "Email Flow",
            "queues": [
                {
                    "queueEntryLength": 1,
                    "interactionSegmentId": "996e1290-d9e7-11e7-b3f1-2675b8cf7e39",
                    "agentId": "e05468e0-82b1-11e7-b08f-6e56a766befb",
                    "platformQueueId": 743,
                    "endTimestamp": "2017-12-05T18:10:59.360Z",
                    "queueExitType": "success",
                    "queueEntryType": "ivr",
                    "interactionQueueId": "998d0c40-d9e7-11e7-95f3-204e8fcfa723",
                    "queueType": "queue",
                    "startTimestamp": "2017-12-05T18:10:39.493Z",
                    "queueName": "Support",
                    "queueTime": 19.867,
                    "slaTime": 80.018,
                    "queueId": "3703e470-834a-11e7-b08f-6e56a766befb",
                    "timeToAnswer": 80.018
                }
            ],
            "direction": "inbound",
            "channelType": "email"
        }, ...
    ]
}

Response Parameters

Your response may include statistics that are not described in this reference. For more information about the statistics that are returned, see the Data Dictionary.

The table below lists and describes the parameters that can be returned in the response.

Parameter

Description

page

The page number for the page of results returned in the request..

limit

The number of interactions to return per page. The default is 10. The maximum is 1000.

offset

The offset, if specified, from the request. For example, the request might show interactions from page 10.

tenantId

The tenant’s unique identifier.

total

The number of interactions on the tenant.

tenantTimeZone

The human readable name of the time zone for the tenant.

results

For each interaction, the following parameters might be returned:

Parameter	Description
tenantID	The unique identifier of the tenant.
flagged	Flagged interactions may have missing data associated with them. Valid values are true or null.
endTimestamp	The date and time, in UTC, that the interaction ended.
flowId	The unique identifier of the flow.
interactionId	The unique identifier of the interaction..
contactPoint	The phone number or email address that the customer contacted.
customer	The phone number or email address of the customer.
messagingTranscript	The transcript of the SMS conversation.
notes	The note that the agent wrote for the interaction.
startTimestamp	The date and time, in UTC, that the interaction started.
audioRecording	A link to the audio recording if recording was enabled for the flow that received the interaction.
dispositionName	The human-readable description of the disposition assigned to the interaction.
dispositionId	The unique identifier of the disposition assigned to the interaction.
flowName	The human-readable name of the flow.
direction	The direction of the interaction, either inbound or outbound.
contactId	The contact's unique identifier.
channelType	The channel of the interaction such as voice, email, or SMS.
hooks	If the interaction is linked with a record from a third-party Customer Relationship Manager (CRM) or ticketing system, the following attributes are returned: interactionHookId—The unique identifier of hook instance. hookSubType—The type of record linked to the interaction. For example, this could be user or ticket. agentId—The unique identifier of the CxEngage agent. hookType—The third-party application, for example, zendesk. hookName—The title associated with the third-party record linked to the interaction. For example, this could be a contact name or a ticket number. hookedBy—The unique identifier for the third-party system user. For example, the Zendesk user identification for the user that linked the record to the CxEngage interaction. hookId—The unique identifier of the record from the third party system that that is linked to the interaction. For example, a ticket number for Zendesk or a case number for Salesforce. This attribute is part of a three-way key that also includes hookType and hookSubtype. timestamp—The date and time, in UTC, of when this interaction was linked to a third-party record.
segments	Each entry in this object provides data about the segments of the customer interaction. The following attributes are returned for each segment: segmentAgentId—Displays the ID of the agent responsible for creating this segment. For example the agent that initiated the add-participant or transfer event, or makes an outbound interaction. segmentToAgentId—Displays the ID of the agent that accepted the work, either through a transfer or add participant action, for this segment. interactionSegmentId—A unique identifier for the segment. segmentNumber—Segments are enumerated as follows: Segment 0 is always the result of an interaction-start event. The segment ends when either the agent is deallocated from the interaction or the customer abandons. Segment 1 (and subsequent segments) are created as the result of a transfer-start or add-participant-start event. startTimestamp—The date and time, in UTC, that the segment started. segmentStartType—Displays the type of action that initiated the segment, either: interaction—Indicates that the segment was initiated by an interaction-start event. transfer—Indicates that a transfer event initiated the segment. addParticant—Indicates that an add-participant event initiated the segment. endTimestamp— The date and time, in UTC, that the segment ended. segmentEndType—Displays the type of action that ended the segment. interaction-end—The interaction is complete. customer-disconnect—The customer abandons the interaction. cancelled—The agent cancels the Add Participant or Transfer action. success—An agent accepts the transfer, causing the agent that initiated the transfer to be deallocated from the interaction. segmentCancelled—Displays true if the transfer was canceled or abandoned. segmentCancelTime—The amount of time, in seconds, from the interaction start until the segment is cancelled, either by a customer-disconnect or cancelled event. segmentTime—The amount of time, in seconds, from the interaction start until the segment is complete, either by a success or interaction-end event.
agents	Each entry in this object includes agent-related data. Each entry provides data from when an agent is allocated until the agent is deallocated in the interaction. The following attributes are returned for each agent: platformAgentId—The unique identifier of the platform user. agentName—The first and last name of the agent. sessionId—The unique identifier for the agent's session. A session begins when an agent logs in to Agent Toolbar or any of the Skylight products and ends when the agent logs out. interactionSegmentId—A unique identifier for the segment. If an interaction enters the same queue twice in an interaction, each queue entry is given a unique identifier. agentId—The unique identifier of the CxEngage agent. interactionAgentId—Each agent is involved in an interaction is given a unique identifier. For each time that an agent is allocated, a unique interactionAgentId attribute is created. endTimestamp—The date and time, in UTC, that the agent was deallocated from the interaction. startTimestamp—The date and time, in UTC, that the agent was allocated to the interaction. tenantAgentId—The unique identifier of the tenant user. queueId—The unique identifier of the queue that the work offer is accepted from.
queues	Each entry in this object provides queue-related data when a customer enters a queue until an agent accepts the interaction. The following attributes are returned for each queue: interactionSegmentId—A unique identifier for the segment that this enqueuement belongs to. agentId—The unique identifier of the agent who accepts the interaction from the queue. platformQueueId—An integer value that third-party Workforce Management (WFM) systems can use to associate with the CxEngage queue. In CxEngage, queues are identfied by a UUID, so a second identification number is required for third-party systems that don't use UUIDs. endTimestamp—The date and time, in UTC, that the interaction exited the queue. queueExitType—The action that caused the interaction to leave the queue. Valid options are timeout, success, callback, abandon, add-participant-cancel, and interaction-end. queueEntryType—The actions that put the interaction in the queue. Valid options are transfer, add participant, callback, ivr, or timeout. interactionQueueId—A unique identifier for each time that an interaction enters a queue. For each queue entry in an interaction, a new interactionQueueId attribute is created. queueType—The type of queue, either queue or resource. startTimestamp—The date and time, in UTC, that the interaction entered the queue. queueName—The human-readable name of the queue. queueId—The unique identifier of the queue that the work offer is accepted from.