Menu

Expand
Rate this page:

Feedback Resource

The call Feedback subresource describes the quality experienced during a phone call.

Users can rate a call with a quality score of 5, if it was perfect, or lower, if not. If it was less than perfect, they can describe the problem they experienced, such as diminished audio quality, dropped call, or incorrect caller id.

This makes it easier to build feedback interfaces into your application such as these to display after a call.

Possible UI for collecting call quality feedback

CallFeedback properties

Resource Properties in REST API format
account_sid
sid<AC> Not PII

The unique id of the Account responsible for this resource.

date_created
date_time<rfc2822> Not PII

The date that this resource was created, given in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date that this resource was last updated, given in RFC 2822 format.

issues
enum:issues[] Not PII

A list of issues experienced during the call. The issues can be: imperfect-audio, dropped-call, incorrect-caller-id, post-dial-delay, digits-not-captured, audio-latency, unsolicited-call, or one-way-audio.

quality_score
integer Not PII

1 to 5 quality score where 1 represents imperfect experience and 5 represents a perfect call.

sid
sid<CA> Not PII

A 34 character string that uniquely identifies this resource.

Create a call Feedback resource

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Feedback.json

Each feedback entry must have a quality_score and it can also have zero or more issue entries.

Parameters
Parameters in REST API format
account_sid
Path
post sid<AC> Not PII

The unique id of the Account responsible for this resource.

call_sid
Path
post sid<CA> Not PII

The call sid that uniquely identifies the call

quality_score
Required
post integer Not PII

The call quality expressed as an integer from 1 to 5 where 1 represents very poor call quality and 5 represents a perfect call.

issue
Optional
post enum:issues[] Not PII

A list of one or more issues experienced during the call. Issues can be: imperfect-audio, dropped-call, incorrect-caller-id, post-dial-delay, digits-not-captured, audio-latency, unsolicited-call, or one-way-audio.

Example 1
        
        
        
        

        Fetch a call Feedback resource

        get
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Feedback.json
        Parameters
        Parameters in REST API format
        account_sid
        Path
        get sid<AC> Not PII

        The unique id of the Account responsible for this resource.

        call_sid
        Path
        get sid<CA> Not PII

        The call sid that uniquely identifies the call

        Example 1
              
              
              
              

              Update a call Feedback resource

              post
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Feedback.json

              Each feedback entry must have a quality_score and it can also have zero or more issue entries.

              Parameters
              Parameters in REST API format
              account_sid
              Path
              post sid<AC> Not PII

              The unique id of the Account responsible for this resource.

              call_sid
              Path
              post sid<CA> Not PII

              The call sid that uniquely identifies the call

              quality_score
              Required
              post integer Not PII

              The call quality expressed as an integer from 1 to 5 where 1 represents very poor call quality and 5 represents a perfect call.

              issue
              Optional
              post enum:issues[] Not PII

              One or more issues experienced during the call. The issues can be: imperfect-audio, dropped-call, incorrect-caller-id, post-dial-delay, digits-not-captured, audio-latency, unsolicited-call, or one-way-audio.

              Example 1
                    
                    
                    
                    
                    Rate this page:

                    Need some help?

                    We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

                          
                          
                          

                          Thank you for your feedback!

                          We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                          Sending your feedback...
                          🎉 Thank you for your feedback!
                          Something went wrong. Please try again.

                          Thanks for your feedback!

                          Refer us and get $10 in 3 simple steps!

                          Step 1

                          Get link

                          Get a free personal referral link here

                          Step 2

                          Give $10

                          Your user signs up and upgrade using link

                          Step 3

                          Get $10

                          1,250 free SMSes
                          OR 1,000 free voice mins
                          OR 12,000 chats
                          OR more