Hi Amanda,
Quick follow-up. I see that the stats count for nConversationSummaryEngagements is being returned for the interval 20th June to 24th June.
"interval": "2025-06-20T18:30:00.000Z/2025-06-24T18:29:59.000Z",
"metrics": [
{
"metric": "nConversationSummaryEngagements",
"stats": {
"count": 34070
}
}
]
However, when I apply filters to the Summary Engagement query using dimensions like copied, summaryRating, or editedField, the API returns an empty result {}. For instance, here are the queries I tried:
{
"metrics": ["nConversationSummaryEngagements"],
"filter": {
"type": "and",
"predicates": [
{
"type": "dimension",
"dimension": "triggerSourceType",
"operator": "matches",
"value": "COPILOT"
},
{
"type": "dimension",
"dimension": "summaryRating",
"operator": "matches",
"value": "POSITIVE"
}
]
},
"interval": "2025-06-20T18:30:00.000Z/2025-06-24T18:29:59.000Z"
}
{
"metrics": [
"nConversationSummaryEngagements"
],
"filter": {
"type": "and",
"predicates": [
{
"type": "dimension",
"dimension": "triggerSourceType",
"operator": "matches",
"value": "COPILOT"
},
{
"type": "dimension",
"dimension": "editedField",
"operator": "matches",
"value": "SUMMARY"
}
]
},
"interval": "2025-06-20T18:30:00.000Z/2025-06-24T18:29:59.000Z"
}
{
"metrics": [
"nConversationSummaryEngagements"
],
"filter": {
"type": "and",
"predicates": [
{
"type": "dimension",
"dimension": "triggerSourceType",
"operator": "matches",
"value": "COPILOT"
},
{
"type": "dimension",
"dimension": "copied",
"operator": "matches",
"value": "true"
}
]
},
"interval": "2025-06-20T18:30:00.000Z/2025-06-24T18:29:59.000Z"
}
Am I missing something in how I'm constructing the filter? or if there's a specific way these dimensions should be used?
Appreciate your help, Thanks in advance!
------------------------------
Ramsha Shaikh
Telecom/AI Engineer
------------------------------
Original Message:
Sent: 06-26-2025 04:25
From: Amanda Halpin
Subject: Agent Copilot Summary Analytics API
Hi Ramsha,
Summaries are stored for 10 days so the API call isn't working because your date range is beyond that.
If you change the date range it should work as expected.
Thanks,
Amanda
------------------------------
Amanda Halpin
EMEA Strategic Solutions Lead
Original Message:
Sent: 06-26-2025 04:20
From: Ramsha Shaikh
Subject: Agent Copilot Summary Analytics API
This helps, thank you!
Just one more question. I tried the following query in the API Explorer, but it returns {}.
{ "interval": "2025-04-30T18:30:00.000Z/2025-05-30T18:30:00.000Z", "metrics": [ "nConversationSummaries", "nConversationSummaryEngagements", "tConversationSummary" ], "filter": { "type": "and", "predicates": [ { "type": "dimension", "dimension": "triggerSourceType", "operator": "matches", "value": "COPILOT" }, { "type": "dimension", "dimension": "copied", "operator": "matches", "value": "true" } ] }}
Could this be because Summary Engagements is still in preview?
All other queries, like those under Summary Generation, seem to work fine, but anything from Summary Engagement Queries returns an empty response.
Appreciate your help!
------------------------------
Ramsha Shaikh
Telecom/AI Engineer
Original Message:
Sent: 06-26-2025 04:10
From: Amanda Halpin
Subject: Agent Copilot Summary Analytics API
Hi Ramsha,
There's no additional cost associated with that permission.
Thanks,
Amanda
------------------------------
Amanda Halpin
EMEA Strategic Solutions Lead
Original Message:
Sent: 06-26-2025 02:13
From: Ramsha Shaikh
Subject: Agent Copilot Summary Analytics API
Hi Amanda and Marc,
Thank you for the information.
When I attempt to query the API endpoint /api/v2/analytics/summaries/aggregates/query, I receive the following error:
"Unable to perform the requested action. You must have at least one of the following permissions assigned: [analytics:summaryAggregate:view]"
I wanted to check whether enabling this permission and querying this API incurs any additional costs or token usage.
------------------------------
Ramsha Shaikh
Telecom/AI Engineer
Original Message:
Sent: 06-25-2025 11:05
From: Amanda Halpin
Subject: Agent Copilot Summary Analytics API
Hi Ramsha,
The summary analytics API are in the analytics section: https://developer.genesys.cloud/analyticsdatamanagement/analytics/aggregate/summary-query
You should be able to find what you're looking for on that link.
Thanks,
Amanda Halpin
------------------------------
Amanda Halpin
EMEA Strategic Solutions Lead
Original Message:
Sent: 06-20-2025 00:32
From: Ramsha Shaikh
Subject: Agent Copilot Summary Analytics API
Hi everyone,
In this week's release notes, there's a mention of the Agent Copilot Summary Analytics API, but I'm not sure which API it refers to.
I've tried a POST request to:
/api/v2/analytics/agentcopilots/aggregates/query
and also checked the preview APIs, but I couldn't find the Analytics API mentioned in the release notes
Can anyone clarify where I can access the API that provides these metrics related to summaries?
Thanks in advance!
#PlatformAPI
------------------------------
Ramsha Shaikh
Telecom/AI Engineer
------------------------------