fireOnCallEnd()

Usage

Fires an event that notifies a call has ended. Use to get information or send information between an interaction log and a custom console component. This method is only available in API version 31.0 or later.

Syntax

1sforce.console.cti.fireOnCallEnd( callObjectId:String, callDuration:Number, callDisposition:String, (optional)callback:Function )

Arguments

Name	Type	Description
callObjectId	string	The object ID of the call.
callDuration	number	Number specifying the duration of the call.
callDisposition	string	String representing the call’s disposition, such as call successful, left voicemail, or disconnected.
callback	function	JavaScript method called upon completion of the method.

Sample Code–Visualforce

1swfobject.registerObject("clippy.codeblock-1", "9");<apex:page>
2    <A HREF="#" onClick="testFireOnCallEnd();return false">
3             Click here to end a call</A>
4
5    <apex:includeScript value="/support/console/31.0/integration.js"/>
6    <script type="text/javascript">
7
8        function testFireOnCallEnd() {
9            //Here, 'call.1' refers to a call that is in progress.
10            sforce.console.cti.fireOnCallEnd('call.1', 60, 'Set Appointment');
11        }
12
13    </script>
14</apex:page>

Response

This method is asynchronous so it returns its response in an object in a callback method. The response object contains the following field:

Name	Type	Description
success	boolean	`true` if firing the event is successful, `false` otherwise.

Salesforce Console Integration Toolkit Developer's Guide