Call Summary is a collection of call data sent to your application at the end of a phone call. Call Summaries are formatted in XML. A Call Summary is sent over HTTP/HTTPS to a URL.
Call Summaries are sent at the end of both inbound and outbound calls. For inbound phone calls, the Call Summary is sent immediately upon hang-up. For outbound phone calls, a Call Summary is sent immediately upon hang-up or after the last delivery attempt if the call is not answered.
In general, when an application receives a Call Summary, it inserts the data contained in the Call Summary into a database table, creating a call log. Call Summaries many times also serve as triggers that kick off other processes within customer applications.
Call Summaries can contain the following call information:
|
Attribute |
Inbound Call |
Outbound Call |
|
|
|
|
|
|
|
|
|
|
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
||
|
|
|
|
|
|
Table 1: Call Summary attributes
To enable Call Summary, enter the URL to which you want the Call Summaries sent:
|
|
|
|
Figure 4.9: Configuring Call Summary
Example 1: Call Summary for an inbound call
|
Example 2: Call Summary for an outbound call
|
Note on Security
A combination of secure and authenticated communications can be used between VoiceShot and your application. If the Call Events URL you enter in your VoiceShot account begins with "HTTPS://", VoiceShot will use industry standard Secure Socket Layer (SSL) encryption to send your Call Events. Additionally, you can require username and password authentication in order for VoiceShot to access your Call Events URL. If you do, you will need to enter the username and password in your VoiceShot account so VoiceShot will be able to log in to the Call Events URL you provide. The authentication type used is basic authentication. Normally in basic authentication, the login credentials are placed in the HTTP header in clear text. However, when combined with HTTPS, the login credentials are sent over the secure channel.