To fetch the feedback survey scores provided by the user in the conversation with a virtual assistant and push the data for visualization on the Feedback Analytics module using the Survey Type and Survey Name.
Method | POST |
Endpoint | https://{{host}}/api/public/bot/{{BotID}}/saveFeedback
|
Content Type | application/json |
Authorization | auth: {{JWT}}
|
API Scope |
|
Path Parameters
Parameter | Description | Type |
---|---|---|
host | The environment URL. For example, https://bots.kore.ai |
string, required |
BotId | Bot ID or Stream ID can be accessed under General Settings on the Bot Builder.
Note: This is required only for Bot Builder API scope of Proactive Messages. |
string, required |
Sample Request
curl --location 'https://{{host}}/api/1.1/public/bot/{{botId}}/saveFeedback' \
--header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"channelUId":"qatesting@vomoto.com",
"name":"Thumb",
"score":0,
"channel":"rtm",
"type":"THUMB",
"language":"en",
"message":""
}'
Request Body Parameters
Parameter | Description | Type |
---|---|---|
channelUId | The ID of the user on the channel where the feedback survey was triggered. Can be the user’s email id or enterprise assigned unique id. | string, required |
name | The name of the survey provided by the user. | string, required |
score | The feedback survey score provided by the user as a response. | number, required |
channel | The channel used for the feedback survey. | string, required |
type | One of the feedback survey types THUMB, NPS, or CSAT. | string, required |
language | The language in which the Feedback survey is triggered. | string, required |
message | The message prompted to the user during the feedback survey. | string, required |
Sample Response
{
"botId": "st-053cd130-f983-577a-8aad-2504aebd60b9",
"channel": "rtm",
"language": "en",
"score": 0,
"timestamp": "2023-03-23T07:07:43.538Z",
"createdOn": "2023-03-23T07:07:43.538Z",
"timestampValue": 1679555263538,
"type": "THUMB",
"name": "Thumb",
"channelUId": "qatesting@vomoto.com",
"orgId": "o-89b0abd5-19af-5017-a80a-6fc6bfc7a638",
"accountId": "60dbef1bc2f5c25106cdb57d",
"userId": "u-f5d97fb8-8767-5b6c-a28d-09e9ac281e12",
"_id": "641bfabf0353f52d915f7a87",
"__v": 0
}
Response Body Parameters
Parameter | Description | Type |
---|---|---|
botId | The ID of the virtual assistant for which feedback was given. You can access it from the virtual assistant’s General Settings page. | string, required |
channel | The channel on which the user responds to the feedback survey. | string, required |
language | The language in which the feedback survey is triggered. | string, required |
score | The feedback score. | number, required |
timestamp | Feedback response date converted into timestamp format. | date (ISO Date format YYYY-MM-DDThh:mm:ss.mmmZ), required |
createdOn | Feedback creation date converted into timestamp format. | date (ISO Date format YYYY-MM-DDThh:mm:ss.mmmZ), required |
timestampValue | Creation date converted into timestamp numeric format. | number, required |
type | The feedback survey type. | string, required |
name | The feedback survey name. | string, required |
channelUId | The end-user’s channel user identifier. | string, required |
orgId | Organization id the bot belongs to. | string, required |
accountId | Account id the bot belongs to. | string, required |
userId | User id the bot belongs to. | string, required |
_Id | Unique identifier for the message record. | string, required |
__v | The value is always 0. Does not have any significance as of now. | integer, optional |