Menu

Expand
Rate this page:

Feedback Resource

Feedback for the /Calls resource is deprecated and will stop responding to requests after 12/31/2023. The Call Annotation resource supersedes and replaces the 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
Loading Code Sample...
        
        

        Create a call Feedback resource

        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
        Loading Code Sample...
              
              

              Fetch a call Feedback resource

              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_like<CA> Not PII

              The call sid that uniquely identifies the call

              quality_score
              Optional
              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
              Loading Code Sample...
                    
                    

                    Update a call Feedback resource

                    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 by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

                    Loading Code Sample...
                          
                          
                          

                          Thank you for your feedback!

                          Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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

                          Thanks for your feedback!

                          thanks-feedback-gif