Texa Desk Application API · Reports

Get conversation statistics grouped by team

GET/api/v2/accounts/{account_id}/summary_reports/team

Get conversation statistics grouped by team for a given date range. Returns metrics for each team including conversation counts, resolution counts, average first response time, average resolution time, and average reply time.

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The numeric ID of the account

Query parameters

sincestring

The timestamp from where report should start (Unix timestamp).

untilstring

The timestamp from where report should stop (Unix timestamp).

business_hoursboolean

Whether to calculate metrics using business hours only.

Responses

200

Success

idnumber

The team ID

conversations_countnumber

Number of conversations assigned to the team during the date range

resolved_conversations_countnumber

Number of conversations resolved by the team during the date range

avg_resolution_timenumber

Average time (in seconds) to resolve conversations. Null if no data available.

avg_first_response_timenumber

Average time (in seconds) for the first response. Null if no data available.

avg_reply_timenumber

Average time (in seconds) between replies. Null if no data available.

403

Access denied

descriptionstring

errorsarray of object

errors[].fieldstring

errors[].messagestring

errors[].codestring

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} r = requests.get("https://desk.texadesk.com/api/v2/accounts/1/summary_reports/team", headers=headers) r.raise_for_status() print(r.json())

[ { "id": 1, "conversations_count": 250, "resolved_conversations_count": 200, "avg_resolution_time": 2800, "avg_first_response_time": 240, "avg_reply_time": 500 }, { "id": 2, "conversations_count": 180, "resolved_conversations_count": 150, "avg_resolution_time": 2400, "avg_first_response_time": 200, "avg_reply_time": 450 } ]