Reporting API

CCAI Platform Data API

API documentation is available at:

Manager API Docs HTML version Postman collection

Apps API Docs HTML version Postman collection

For frequently asked questions see Data and API FAQ

Available Endpoints

Endpoint Description
Agent Provides necessary details around the agents that are assigned to the CCAI Platform platform
Agent Status History Enables status changes and associated timestamps for what agents are doing within the CCAI Platform platform. This data is extremely useful in WFM and time-series analysis.
Call Gives visibility into every call and call type that the CCAI Platform platform manages including inbound, outbound, voicemails and by which channels these calls came in from. Subset details can also be included including keys to join photos, videos, transfer and call participants. Furthermore, keys are provided to link calls and agents together for deeper tracking analysis.
Chat Similar to the call data model, the chat data model allows for users to identify the details of all chats managed by the CCAI Platform platform including the menu path taken prior to the chat being taken and transfer of the chat if applicable.
Call Participant Allows for the data to be pulled on the agent, end-users and/or third party who participated in a particular call(s).
Chat Participant Allows for the data to be pulled on the agent and ensures who participated in a particular chat(s).
Changed Detail Provides a unique data model to account for data value changes between the former and new value by specific fields.
User Info A subset of data that is best categorized as a limited view of the full agent data model.
Photo Represents the end user-uploaded photos which can be traced to call and chat channels.
Video Represents the end user-uploaded videos which can be traced to call and chat channels.
Team Provides additional context into agent details and how a particular agent is grouped in the support center. Agents can belong to more than 1 team.
Team With Assignees Provides data into the team and the associated agents.
Team Tree Provides the tree structure of the teams configured in the CCAI Platform platform. For example, the US Team has 2 sub-teams, East and West Coast. This hierarchy is exposed with the US being the parent with 2 siblings, East and West.

CCAI Platform Basic Call Segment API Metrics

Overview

The CCAI Platform Portal reports and API requests are two ways to look at metrics. Due to the intricacies that exist between the different data sources, some call metrics will appear in the API that do not appear in reports.

Basic call segments - API

  • Billing TIme

    Start - API: created_at

    End - API: ended_at"

  • Call Time

    Start - API: created_at

    End - API: ended_at

  • IVR Time

    Start - API: created_at

    End - API: queued_at

  • Queued Time & Wait Time

    Start - API: queued_at

    End - API: connected_at

  • Handle Time

    Start - API: connected_at

    End - API: ended_at

  • Transfer

    Start - API: /call.transfers[]['created_at']

    End - API: /call.participants[]['connected_at']

  • Conference Time

    API: /calls.participants[]['connected_at']

    API: /calls.participants[]['ended_at']

    Note: Overlap of agent participants connected & ended times

  • Third Party Talk Time

    API: /calls.participants[]['connected_at']

    API: /calls.participants[]['ended_at']

    Note: Overlap of agent participants connected & ended times

  • Ring Time (Connecting Time)

    Start - API: connecting_at

    End - API: connected_at

  • Talk Time

    API: duration - hold_duration

  • Hold Time

    API: hold_duration

Types of calls and segments and events

The blue and green chart below shows how each type of Call Segment is reported through a call Lifecycle model. Gray-colored boxes indicate a situation in which the metric does not apply and will not be captured in reports.

To expand this image and see details, right-click on it to download the file, and open it in a new tab.