Skip to main content
This method lets you post feedback for calls. You can access call quality feedback information received through this API on the Call Debug UI, and view aggregated reports on the Call Insights Reporting dashboard.

​
API Endpoint

POST
https://stats.plivo.com/v1/Call/{call_uuid}/Feedback/

​
Arguments

ParameterTypeDescription
call_uuidstring (Required)The call UUID of the call for which feedback is being posted.
ratingfloat (Required)Quality rating for the call.
Allowed values: float between [1, 5]. For integers, both x and x.0 are accepted.
issueslist<string> (Required only if rating < 5)List of issues observed on the call. One or more of the following:
AUDIO_LAG, BROKEN_AUDIO, CALL_DROPPED, CALLERID_ISSUE, DIGITS_NOT_CAPTURED, ECHO, HIGH_CONNECT_TIME, LOW_AUDIO_LEVEL, ONE_WAY_AUDIO, OTHERS, ROBOTIC_AUDIO
Notesstring (Optional)Free text field to provide descriptive feedback for the call.

​
HTTP responses we send

Status codeDescription
201Feedback has been posted
401Authentication failed
404Resource cannot be found*
404Please check the Call UUID**
405HTTP method not allowed
422Rating has to be a float between 1 -5
422Issues have to be an array of one or more than one of the following: AUDIO_LAG, BROKEN_AUDIO, CALL_DROPPPED, CALLERID_ISSUES, DIGITS_NOT_CAPTURED, ECHO, HIGH_CONNECT_TIME, LOW_AUDIO_LEVEL, ONE_WAY_AUDIO, OTHERS, ROBOTIC_AUDIO
500Server error
*Generic response indicating error in resource used in the Post API call**Specific response indicating the error in call UUID used in Post API call

​
Response attributes

HTTP status codeHTTP status code from the list above
api_idIdentifies the request
errorIndicates there’s an error and provides information regarding the error
messageProvides information regarding the feedback post
#
# Example for Call Feedback creation
#
import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.call_feedback.create(
    call_uuid="b38149eb-b8fe-45d5-85b2-78ee4424788f", 
    rating="4", 
    issues=["AUDIO_LAG"], 
    notes="Call quality was good")
print(response)

curl -i --user AUTH_ID:AUTH_TOKEN \
    -H "Content-Type: application/json" \
    -d '{"issues": ["AUDIO_LAG"], "rating": "4", "notes": "Call quality was good"}' \
    https://stats.plivo.com/v1/Call/f6bf3c48-afdf-4e42-a30e-9e00fda351d/Feedback/