Menu

Rate this page:

Thanks for rating this page!

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

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

Names in PHP format
accountSid
sid<AC> Not PII

The unique id of the Account responsible for this resource.

dateCreated
date_time<rfc2822> Not PII

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

dateUpdated
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.

qualityScore
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
Names in None format
account_sid
Required
post sid<AC> Not PII

The unique id of the Account responsible for this resource.

call_sid
Required
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
        Names in None format
        account_sid
        Required
        get sid<AC> Not PII

        The unique id of the Account responsible for this resource.

        call_sid
        Required
        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
              Names in None format
              account_sid
              Required
              post sid<AC> Not PII

              The unique id of the Account responsible for this resource.

              call_sid
              Required
              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.