Perform Survey Sentiment Analysis

Create or update the AI Sentiment Result records. You can get insights into the sentiments underlying survey responses and save the sentiment analysis in the SentimentAnalysisResult object.

This action is available in API version 55.0 and later.

Special Access Rules 

To access the Perform Survey Sentiment Analysis action, you must have the Feedback Management - Starter and Feedback Management - Growth licenses.

Supported REST HTTP Methods 

URI: /services/data/v55.0/actions/standard/performSurveySentimentAnalysis

Formats: JSON

HTTP Methods: POST

Authentication: Authorization: Bearer token

Inputs 

InputTypeDescription
surveyIdIDRequired. The ID of the survey containing the questions for whose responses you want to get sentiment insights.
surveyQuestionIdsIDRequired. The IDs of the questions for whose responses you want to get sentiment insights.
startDateDatetimeRequired. The date from when participant responses are processed to get sentiment insights.
endDateDatetimeRequired. The date until when participant responses are processed to get sentiment insights.
typeOfOperationStringRequired. The type of operation to be performed on the survey responses. Use create to bulk process survey responses and create AI Sentiment Result records with Submitted status. Use update to bulk process survey responses that have associated AI Sentiment Result records in Draft status and update them to Submitted status. You can only update a sentiment analysis result record with the Draft status.

Outputs 

None.

Example 

Sample Request

Here’s an example POST request to create or update the AI Sentiment Result records:

1{
2   "inputs":[{
3      "surveyId":"0Kdx00000000GYeCAM",
4      "surveyQuestionIds":["0Kux00000000xDgCAI","0Kux00000000xDiCAI"],
5      "startDate":"1-07-2022",
6      "endDate":"12-07-2022",
7      "typeOfOperation":"create"
8   }]
9}

See Also