View the Voice Insights Summary for a Call

The Voice Insights Call Summary allows users to easily see the carriers or providers for the call, which side hung up, Post-Dial Delay (PDD), and other helpful troubleshooting details. This guide is intended to walk users through accessing Voice Insights call summary data.

Click a section heading to skip to it:

Access the Insights Summary via Console

  1. Access the Call Logs page in Console.
  2. Click the Timestamp to view the desired call log.
    Insights_Summary_01_400px.png 
  3. From the Call Details page, click the Insights Summary Tab.
    Insights_Summary_02_400px.png 
  4. The Insights Summary page will be displayed.

Access the Insights Summary via the REST API

Advanced Voice Insights customers have access to their insights data via HTTP GET requests to a Call SID's Summary sub-resource.Here’s an example cURL script:

curl -X GET https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Summary \
-u "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token"

This example request the Insights Summary data for call CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, and return it in a .JSON response. To make this script work for you, make the following updates, and then paste it into a terminal window:

For full details, including a list of properties and code samples, please see Voice Insights: Call Summary Resources (Twilio Docs).

Insights Summary Data Overview

Here's a selection of the important call data points listed in the Voice Insights Call Summary. For full details, please see Voice Insights Call Summary (Twilio Docs).

  • To / From: Details about the caller and calling party, including the phone number, the connection used to contact Twilio, country of origin, and registered carrier, and more. Different calling products (Client, Elastic SIP, etc.) may have different data here.
    Insights_Summary_03-B_400px.png
  • Properties: Details about the signaling and status.
    Insights_Summary_03-C_400px.png
    Who hung up Which side - the caller or callee - sent the signal to end the call
    Post-Dial Delay The wait between when the call connection is requested, and the call begins to ring. For help with PDD over 6 seconds, please see Troubleshooting Post Dial Delay.
    Last SIP Response The final SIP signal received - 200 OK for a successfully connected call. For other responses, see Common SIP Response Codes below.
    Call state The final call status - completed for a successfully connected call. For other statuses, see Final Call Statuses below.
    Twilio RTP Latency (MS) The time RTP (media) packets spent transiting Twilio's infrastructure. For help with latency, please see Troubleshooting Latency and Delayed Audio.
      
  • Metrics (Carrier Edge): Details about the media transmitted on the call.
    Insights_Summary_03-D_400px.png
    Codec The audio codec used - PCMU (G.711) for most Twilio calls.
    Packet Loss Detected A notification for consecutive samples with packet loss - False or True with the detected packet loss percentage.
    Jitter Detected A notification for jitter threshold detection - False or True with the average and max jitter in ms.

Common SIP Response Codes

The following table contains common SIP response codes for calls that do not complete.

SIP Response Message Description
401 
Unauthorized
  
407 
Proxy Authentication Required
The request requires user authentication. These responses should be automatically responded to with an ACK and another INVITE that includes the required credentials. If not, verify your SIP Trunk or Domain credentials are correct.
403 
Forbidden
The request can't be fulfilled. Request is valid, but the destination may have rejected or blocked the incoming call. Have the callee check their side to make sure calls aren't blocked.
404 
Not Found
The destination doesn't exist, or can't be found. The destination number may not be valid, or not in service. Double check the destination number.
480 
Temporarily Unavailable
The destination is currently unavailable. The destination number is not answering, or unable to answer. They may be out of service, roaming, or not accepting calls. Often seen when calling wireless phones that don't answer and don't have voicemail.
486 
Busy Here
The destination is busy. The destination number is returning a busy signal. Try again later.

Additional information on SIP response codes can be found at the following resources:

Final Call Statuses

After a call has finished, the following final status options are possible:

Completed A successfully connected call has now been disconnected. Completed calls will remain in this state in going forward.
Busy Twilio dialed the number, but received a busy response.
No-answer Twilio dialed the number but no one answered before the timeout parameter value elapsed. This can be configured for each call, but by default is set to 60 seconds on outbound API calls, and 30 seconds on outbound <Dial> calls.
Canceled Prior to being answered, an outbound call was cancelled via an HTTP POST request to the REST API, or an incoming call was disconnected by the calling party.
Failed Twilio's carriers could not connect the call. Possible causes include the destination is unreachable, or the number may have been input incorrectly. Check the Last SIP Response for more information.
Have more questions? Submit a request
Powered by Zendesk