The maximum duration supported for the date range is 7 days.
API Details
| Parameter | Description |
|---|---|
| Method | POST |
| Endpoint | https://{{host}}/agentassist/api/v1/public/{{botid}}/aaconversation |
| Content Type | application/json |
| Authorization | auth: {{JWT}}: See How to generate the JWT Token |
| Scope | AgentAssist Analytics: See Associate API Scopes |
Path Parameters
| Parameter | Required | Description |
|---|---|---|
host | Yes | The environment URL. For example, https://platform.kore.ai. |
botid | Yes | The unique bot identifier. Example: st-79a76d65-d540-5b33-96d5-9bf3eebxxxxx |
Header Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountid | String | Yes | Unique identifier of the customer account making the request. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
from | String (YYYY-MM-DD) | Yes | Start date for fetching conversation records. |
to | String (YYYY-MM-DD) | Yes | End date for fetching conversation records. |
page | Integer | No | Page number for paginated results. Default: 1 |
limit | Integer | No | Number of records per page. Maximum: 20. |
includeHistory | Boolean | No | If true, includes conversation history. Default: false |
includeAgenticHistory | Boolean | No | If true, includes Agentic response artifacts history. Default: false. |
includeFeedback | Boolean | No | If true, includes feedback in the response (for example, feedback on summary, Agentic suggestions, and overall widget performance). Default: false. |
includeSummary | Boolean | No | If true, includes the conversation summary. Default: false. |
widgetLoaded | Boolean | No | If true, includes widget loading status. Default: false. |
conversationIds | String | No | Filters the response by conversation IDs. Default: false. |
Sample Request
curl --location --max-time 2000 --request POST 'https://{{host}}/agentassist/api/v1/public/{{botid}}/aaconversation'
--header 'accountId: {{accountId}}'
--header 'auth: {{JWT_TOKEN}}'
--header 'Content-Type: application/json'
--data '{
"from": "2026-06-07",
"to": "2026-06-07",
"page": 1,
"limit": 20,
"includeHistory": true,
"includeAgenticHistory": true,
"includeFeedback": true,
"includeSummary": true,
“widgetLoaded”: true,
“conversationIds”: ["ates*********72"]
}'
Sample Response
{
"results": [
{
"_id": "6a94b************7e-c4a4f9b",
"convId": "atest******lljlf",
"botId": "st-354aa94b************7e-6aaf5ce59c",
"isExtAD": true,
"startTime": "2026-09-08T11:40:35.729Z",
"summaries": [
{
"type": "landing",
"summary": "Unable to fetch the summary. Please try after some time.",
"generatedAt": "2026-09-08T11:40:35.802Z"
}
],
"isLoaded": true,
"aaSessionId": "6a9f4b************7e-c370bd",
"aaUserId": "u-1f24c4b************7e-e3a71ed22967",
"experience": "chat",
"messages": [
{
"_id": "6a9f4b************7e-6bdbcc6",
"type": "AGENTIC",
"timestampValue": 17*******3851,
"requestId": "aa-58ee74b************7e--c177da4832e6",
"conversationId": "atest*****jlf",
"botId": "st-354aa4b************7e-46aaf5ce59c",
"accountId": "6a344b************7e-f4bad04a",
"orgId": "o-f4ba2e4b************7e--97330540cb59",
"experience": "chat",
"language": "en",
"query": "Trigger welcome event",
"components": {
"_id": "cp-cd094b************7e-2bcd2a170d03",
"cT": "text",
"data": {
"text": "Subject: Welcome to Our Service"
}
},
"triggeringMessageId": null,
"isSent": false,
"isCopied": false,
"interacted": false,
"artifacts": [
[
{
"id": "order_details",
"header": "INTERNAL MESSAGE TO AGENT",
"content": "Order Number ",
"artifactId": "art-dd474b************7e-b-79371d69dbc5",
"activities": [
{
"action": "expand",
"timestamp": "2026-09-03T10:52:17.212Z",
"agentId": "a-m****usj"
}
]
},
{
"id": "internal_message",
"header": "INTERNAL MESSAGE TO AGENT",
"content": "The customer has requested a replacement",
"artifactId": "art-b0a4b************7e-2-008c675a5398",
"activities": [
{
"action": "expand",
"timestamp": "2026-09-03T10:52:18.441Z",
"agentId": "a-mt****sj"
}
],
"feedbackInfo": {
"agentDetails": {
"identity": "a-m****usj",
"name": "Anonymous"
},
"feedback": "like",
"comment": "",
"feedbackDetails": [],
"type": "artifact"
}
},
{
"id": "kb_article_link",
"header": "POLICY ARTICLE LINK",
"content": "https://example.com",
"artifactId": "art-114b************7e-249-40ec509855a1",
"activities": [
{
"action": "expand",
"timestamp": "2026-09-03T10:52:22.890Z",
"agentId": "a-m****usj"
},
{
"action": "url_clicked",
"timestamp": "2026-09-03T10:52:23.982Z",
"agentId": "a-m****usj",
"url": "https://example.com"
}
]
}
]
],
"isOverride": false,
"requestedAt": "2026-09-08T11:40:43.848Z",
"respondedAt": "2026-09-08T11:40:49.912Z",
"agentId": "a-m****usj",
"sessionInfo": {
"status": "idle",
"userReference": "atesta****ljlf",
"sessionReference": "ate****tslljlf",
"userId": "u-fb77d524b************7e-658811874a41",
"sessionId": "s-c4b4b************7e-a-5f901a0d9bed",
"runId": "r-e17d4b************7e-4bdd17808843",
"appId": "aa-5858d4b************7e-0eb67be6bd9e",
"envId": "env-fad44b************7e-709c0ee5d8ef",
"envName": "Dev",
"conversationState": "COMPLETED",
"voiceAgentSwitch": {
"agentName": null,
"taskStatus": "COMPLETED"
},
"attachments": [],
"source": "AIS-AA",
"activeConversationAgent": null
}
},
{
"_id": "ms-7a6019e4b************7e-3-d980123dcdec",
"botId": "st-354aa98f4b************7e-046aaf5ce59c",
"accountId": "6a4b************7e-7f4bad04a",
"components": [
{
"_id": "cp-57cf4b************7e--ef819a753db4",
"cT": "text",
"data": {
"text": "could you please write an email regarding leave "
},
"thumbnails": []
}
],
"createdOn": "2026-09-08T11:41:04.514Z",
"lmodifiedOn": "2026-09-08T11:41:04.514Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"type": "USER"
},
"conversationId": "atest******ljlf",
"__lModifiedOn__": "2026-09-08T11:41:04.000Z",
"timestampValue": 178******4527
},
{
"_id": "6a4b************7e-4f6bdbd49",
"type": "AGENTIC",
"timestampValue": 178*******4800,
"requestId": "aa-8a21c54b************7e-85-5f44d60d88ac",
"conversationId": "atest******ljlf",
"botId": "st-3544b************7e-a76b-046aaf5ce59c",
"accountId": "6a4b************7e-7f4bad04a",
"orgId": "o-f4ba2e4c-14b************7e-7330540cb59",
"experience": "chat",
"language": "en",
"query": "could you please write an email regarding leave ",
"components": {
"_id": "cp-af4df7fd-4b************7e--c4e0d7f93b0d",
"cT": "text",
"data": {
"text": "Subject: Leave Request"
}
},
"triggeringMessageId": "ms-74b************7e-0-aef3-d980123dcdec",
"isSent": false,
"isCopied": false,
"isOverride": false,
"requestedAt": "2026-09-08T11:41:04.798Z",
"respondedAt": "2026-09-08T11:41:10.702Z",
"sessionInfo": {
"status": "idle",
"userReference": "atest*****ljlf",
"sessionReference": "ate*****tslljlf",
"userId": "u-fb77d5254b************7e-8-658811874a41",
"sessionId": "s-c4b4b************7e-21a-5f901a0d9bed",
"runId": "r-fe5bec564b************7e--be8b0ed3134f",
"appId": "aa-5858db24b************7e-1-0eb67be6bd9e",
"envId": "env-fad4b************7e-709c0ee5d8ef",
"envName": "Dev",
"conversationState": "COMPLETED",
"voiceAgentSwitch": {
"agentName": null,
"taskStatus": "COMPLETED"
},
"attachments": [],
"source": "AIS-AA",
"activeConversationAgent": null
}
}
],
"searchHistory": [],
"agenticAssistSessionIds": [
"s-c4b5ae0b-**********-5f901a0d9bed"
],
"agenticSearchSessionIds": [],
"widgetFeedbacks": []
},
{
"_id": "6a9ff**********8c4a4f5d",
"convId": "atest******ljlf",
"botId": "st-354aa98f**********b-046aaf5ce59c",
"isExtAD": true,
"startTime": "2026-09-08T11:35:08.678Z",
"summaries": [
{
"summaryId": "smr-8ca89**********3b6-0c3a26eadc75",
"participant": {
"identity": "an-b6685f2**********-72028014d4d2",
"name": "Anonymous",
"type": "agent",
"startTime": [],
"endTime": []
},
"summary": "",
"type": "final",
"editedSummary": "Summary",
"generationTimeInSecs": 0.075,
"generatedAt": "2026-09-08T11:36:08.977Z"
},
{
"type": "landing",
"summary": "Unable to fetch the summary",
"generatedAt": "2026-09-08T11:35:08.818Z"
}
],
"isLoaded": true,
"aaSessionId": "6a9**********e94c1d1e",
"aaUserId": "u-6e98ba**********73a2c469b3cc",
"experience": "chat",
"messages": [
{
"_id": "6a9f**********bdb9a8",
"type": "AGENTIC",
"timestampValue": 178*****17470,
"requestId": "aa-d84e4504-5b**********253d35041",
"conversationId": "atest******ljlf",
"botId": "st-354aa98f-**********aaf5ce59c",
"accountId": "6a34**********f4bad04a",
"orgId": "o-f4ba2e4c**********97330540cb59",
"experience": "chat",
"language": "en",
"query": "Trigger welcome event",
"components": {
"_id": "cp-843fd8**********-d4aae5c220a9",
"cT": "text",
"data": {
"text": "Subject: Welcome to Our Service"
}
},
"triggeringMessageId": null,
"isSent": false,
"isCopied": false,
"isOverride": false,
"requestedAt": "2026-09-08T11:35:17.468Z",
"respondedAt": "2026-09-08T11:35:21.489Z",
"sessionInfo": {
"status": "idle",
"userReference": "atest******ljlf",
"sessionReference": "atest******ljlf",
"userId": "u-385a882b-39**********1003d2d37a5",
"sessionId": "s-fcdc4**********0-8a12-03a3629d1652",
"runId": "r-bc72dd22-**********8-8acfc8fe2c9b",
"appId": "aa-5858db2d**********-0eb67be6bd9e",
"envId": "env-fad4b5e**********09c0ee5d8ef",
"envName": "Dev",
"conversationState": "COMPLETED",
"voiceAgentSwitch": {
"agentName": null,
"taskStatus": "COMPLETED"
},
"attachments": [],
"source": "AIS-AA",
"activeConversationAgent": null
}
},
{
"_id": "ms-06374fa**********c19d82d0e090",
"botId": "st-354aa**********6b-046aaf5ce59c",
"accountId": "6a34e**********7f4bad04a",
"components": [
{
"_id": "cp-90bdfd5**********-01c5102aa07b",
"cT": "text",
"data": {
"text": "could you please write an email regarding leave"
},
"thumbnails": []
}
],
"createdOn": "2026-09-08T11:35:35.366Z",
"lmodifiedOn": "2026-09-08T11:35:35.366Z",
"ire": true,
"chnl": "agentassist",
"lang": "en",
"author": {
"type": "USER"
},
"conversationId": "atest******ljlf",
"__lModifiedOn__": "2026-09-08T11:35:35.000Z",
"timestampValue": 17**********72
},
{
"_id": "6a9ff30**********6bdba00",
"type": "AGENTIC",
"timestampValue": 1788****35671,
"requestId": "aa-69d649fb-5**********d-120d0e085538",
"conversationId": "atest******ljlf",
"botId": "st-354aa98f-ab**********46aaf5ce59c",
"accountId": "6a34e**********f4bad04a",
"orgId": "o-f4ba2e4c-**********97330540cb59",
"experience": "chat",
"language": "en",
"query": "could you please write an email regarding leave",
"components": {
"_id": "cp-28e8bfc0-43b6**********a6b724a3",
"cT": "text",
"data": {
"text": "Subject: Leave Request"
}
},
"triggeringMessageId": "ms-06374faa**********4b-c19d82d0e090",
"isSent": false,
"isCopied": false,
"isOverride": false,
"requestedAt": "2026-09-08T11:35:35.669Z",
"respondedAt": "2026-09-08T11:35:41.920Z",
"sessionInfo": {
"status": "idle",
"userReference": "atest******ljlf",
"sessionReference": "atest******ljlf",
"userId": "u-385a882b-**********b-31003d2d37a5",
"sessionId": "s-fcdc46a9-9431-4480-**********29d1652",
"runId": "r-2fc7e3c1-f650-4e**********98ac71fb89",
"appId": "aa-5858db2d-b109**********eb67be6bd9e",
"envId": "env-fad4b5e**********709c0ee5d8ef",
"envName": "Dev",
"conversationState": "COMPLETED",
"voiceAgentSwitch": {
"agentName": null,
"taskStatus": "COMPLETED"
},
"attachments": [],
"source": "AIS-AA",
"activeConversationAgent": null
}
}
],
"searchHistory": [],
"agenticAssistSessionIds": [
"s-fcdc46a9-9431-4480-**********29d1652"
],
"agenticSearchSessionIds": [],
"widgetFeedbacks": []
}
],
"skip": 0,
"limit": 20,
"hasMore": false,
"totalPages": 1,
"totalResults": 8
}
Response Body Parameters
| Field | Type | Description |
|---|---|---|
_id | String | Unique identifier of the conversation record. |
convId | String | Unique conversation ID. |
botId | String | Identifier of the bot associated with the conversation. |
isExtAD | Boolean | Indicates whether the conversation is associated with an external Active Directory. |
startTime | String | Date and time when the conversation started in ISO 8601 format. |
summaries | Array | Summary information generated for the conversation. |
summaries.summaryId | String | Unique identifier of the summary. |
summaries.participant | Object | Participant details associated with the summary. |
summaries.participant.identity | String | Unique participant identifier. |
summaries.participant.name | String | Participant name. |
summaries.participant.type | String | Participant type, such as agent or user. |
summaries.participant.startTime | Array | Participant start time information. |
summaries.participant.endTime | Array | Participant end time information. |
summaries.summary | String | Generated summary text. |
summaries.editedSummary | String | Edited version of the generated summary. |
summaries.type | String | Type of summary, such as final or landing. |
summaries.generationTimeInSecs | Number | Time taken to generate the summary in seconds. |
summaries.generatedAt | String | Date and time when the summary was generated in ISO 8601 format. |
isLoaded | Boolean | Indicates whether the conversation data is fully loaded. |
aaSessionId | String | Agent AI session identifier. |
aaUserId | String | Agent AI user identifier. |
experience | String | Experience type associated with the conversation. |
messages | Array | Messages exchanged during the conversation. |
messages._id | String | Unique message identifier. |
messages.type | String | Message type. |
messages.timestampValue | Number | Message timestamp in milliseconds. |
messages.requestId | String | Unique request identifier. |
messages.conversationId | String | Conversation ID associated with the message. |
messages.botId | String | Bot identifier associated with the message. |
messages.accountId | String | Account identifier. |
messages.orgId | String | Organization identifier. |
messages.experience | String | Experience type. |
messages.language | String | Language of the message. |
messages.query | String | User query processed by the system. |
messages.components | Object | Message content and associated metadata. |
messages.triggeringMessageId | String | Identifier of the message that triggered the response. |
messages.isSent | Boolean | Indicates whether the message was sent. |
messages.isCopied | Boolean | Indicates whether the message was copied. |
messages.interacted | Boolean | Indicates whether the message was interacted with. |
messages.artifacts | Array | Artifacts associated with the message. |
messages.isOverride | Boolean | Indicates whether the response overrides another response. |
messages.requestedAt | String | Date and time when the request was submitted in ISO 8601 format. |
messages.respondedAt | String | Date and time when the response was generated in ISO 8601 format. |
messages.agentId | String | Identifier of the responding agent. |
messages.sessionInfo | Object | Session information associated with the message. |
messages.sessionInfo.status | String | Current session status. |
messages.sessionInfo.userReference | String | User reference associated with the session. |
messages.sessionInfo.sessionReference | String | Session reference associated with the session. |
messages.sessionInfo.userId | String | User identifier. |
messages.sessionInfo.sessionId | String | Session identifier. |
messages.sessionInfo.runId | String | Run identifier. |
messages.sessionInfo.appId | String | Application identifier. |
messages.sessionInfo.envId | String | Environment identifier. |
messages.sessionInfo.envName | String | Environment name. |
messages.sessionInfo.conversationState | String | Current conversation state. |
messages.sessionInfo.voiceAgentSwitch | Object | Voice agent switch information. |
messages.sessionInfo.voiceAgentSwitch.agentName | String | Name of the voice agent. |
messages.sessionInfo.voiceAgentSwitch.taskStatus | String | Status of the voice agent task. |
messages.sessionInfo.attachments | Array | Attachments associated with the session. |
messages.sessionInfo.source | String | Source of the session. |
messages.sessionInfo.activeConversationAgent | String | Currently active conversation agent. |
searchHistory | Array | Search history associated with the conversation. |
agenticAssistSessionIds | Array | List of Agent Assist session IDs. |
agenticSearchSessionIds | Array | List of Agentic Search session IDs. |
widgetFeedbacks | Array | Feedback associated with widgets. |
skip | Integer | Number of records skipped in the response. |
limit | Integer | Maximum number of records returned per page. |
hasMore | Boolean | Indicates whether additional records are available. |
totalPages | Integer | Total number of available pages. |
totalResults | Integer | Total number of matching records. |
Interactions
| Feature | Description | Expected Tracking |
|---|---|---|
| Link Click Tracking | Track when an agent clicks a document or reference link in an AgentAI or NBA response. | Capture link click events. |
| Accordion / Expandable Section Engagement Tracking | Track when an agent expands a section to view its content. | Capture expand events for each section. |
| Thumbs Up / Thumbs Down per Section | Allow agents to provide feedback on individual expandable sections. | Capture Thumbs Up and Thumbs Down feedback for each section. |
| Section Usage Analytics | Enable administrators to review section-level engagement. | Track the number of section expansions and section-wise usage counts using the artifact section ID. |