GuidesAPI ReferenceDiscussionsKnowledge BaseAppConnectTalkdeskContacts

User Status Report

Suggest Edits

❗️

The Reporting API has been replaced by the Explore API. Talkdesk strongly encourages the transition to the Explore API. You may still use the Reporting API, but please note:

  • Talkdesk will only provide support (no SLA for bug fixing or outage recovery) until June 1, 2022.
  • The Reporting API endpoint will stop responding to requests on December 1, 2022.

Overview

The User Status report provides a raw log of agent status changes occurring in Talkdesk®.

Usage

Specify user_status type in the Reporting API path: /reports/user_status/jobs

FieldDescription
user_id
string		Unique identifier of the user who underwent the status change
user_name
string		Full name of the user who underwent the status change
user_email
email		Email of the user who underwent the status change
status_label
string		Label assigned to the status
status_start_at
datetime		Start datetime of this status session
status_end_at
datetime		End datetime of this status session
status_time
int		Total duration of the time spent in this status by the user (in seconds)
is_user_active
boolean		Whether the user is active in Talkdesk
team_id
string		The team the agent was on when the status change occurred (null if the agent wasn't on a team)
team_name
string		The team the agent was on when the status change occurred (null if the agent wasn't on a team)
{
  "total": 2,
  "type": "user_status",
  "version": "v1",
  "entries": [
    {
      "user_name": "Robert Sur",
      "user_email": "[email protected]",
      "user_id": "13da-3ccd-3423",
      "status_label": "Away",
      "status_start_at": "2016-01-29 10:30:00",
      "status_end_at": "2016-01-29 10:30:14",
      "status_time": 14,
      "is_user_active": true,
      "team_id": "69bd4bed944f4de99cb79736f2ca15b1"
      "team_name": "Admin"
    },
    {
      "user_name": "Robert Sur",
      "user_email": "[email protected]",
      "user_id": "13da-3ccd-3423",
      "status_label": "On A Call",
      "status_start_at": "2016-01-29 10:30:15",
      "status_end_at": "2016-01-29 10:31:15",
      "status_time": 60,
      "is_user_active": false,
      "team_id": "69bd4bed944f4de99cb79736f2ca15b1"
      "team_name": "Admin"
    }
  ]
}

📘

User Status Data Availability

User status data from as far back as 2016 is available in this report type.

Troubleshooting

If you have any questions, or if you’re having any technical issues, please open a ticket using this form.

Updated 17 days ago