Get agent message feedback
GET/api/v2/Agent/:agentCode/feedback
Returns a paginated list of the feedback your users have submitted on this agent's messages, newest first.
Each record pairs the user message with the agent message it rates, together with the boolean feedback value, an optional free-text comment, and the channel and user identifier the execution was attributed to. Use startDate and endDate to bound the results by dateUtc, and sortDirection to order by that same field.
Request
Path Parameters
Code of the agent whose message feedback is requested.
Query Parameters
Default value: 1
The page number to retrieve. Default is 1.
Default value: 20
Number of items per page. Default is 20.
Only return feedback recorded on or after this UTC date and time.
Only return feedback recorded on or before this UTC date and time.
Default value: desc
Sort order applied to dateUtc. desc (the default) returns the newest feedback first, asc the oldest.
Use this param to override the culture of the response. Options: - en (default) - es
Responses
- 200
- 401
- 403
- 404
- 500
Returns a paginated list of the agent's message feedback.
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
Whether the rating is positive. true is a thumbs up, false a thumbs down.
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"agentMessageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"userMessage": "string",
"agentMessage": "string",
"channel": "string",
"dateUtc": "2024-07-29T15:51:28.071Z",
"feedback": true,
"comment": "string",
"userIdentifier": "string"
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string"
}
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
Whether the rating is positive. true is a thumbs up, false a thumbs down.
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"agentMessageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"userMessage": "string",
"agentMessage": "string",
"channel": "string",
"dateUtc": "2024-07-29T15:51:28.071Z",
"feedback": true,
"comment": "string",
"userIdentifier": "string"
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string"
}
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Array [
]
items
object[]
nullable
links
object[]
nullable
Whether the rating is positive. true is a thumbs up, false a thumbs down.
links
object[]
nullable
{
"items": [
{
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"agentMessageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"userMessage": "string",
"agentMessage": "string",
"channel": "string",
"dateUtc": "2024-07-29T15:51:28.071Z",
"feedback": true,
"comment": "string",
"userIdentifier": "string"
}
],
"total": 0,
"pageSize": 0,
"page": 0,
"links": [
{
"method": "string",
"url": "string",
"rel": "string"
}
],
"agentCode": "string"
}
The user is unauthorized or the session expired
The user does not have permission
The entity was not found
There was an unexpected error