Newer Version Available

This content describes an older version of this product. View Latest

onCallBegin()

Registers a function that is called when a call begins (comes in). This method is for computer-telephony integration (CTI); it’s only available in API version 24.0 or later.

Syntax

1sforce.console.cti.onCallBegin( eventHandler:Function )

Arguments

Name Type Description
eventHandler function JavaScript method called when a call begins.

Sample Code–Visualforce

1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<apex:page>
18    <apex:includeScript value="/support/console/24.0/integration.js"/>
19     <script type="text/javascript">
20
21           var callback = function (result) {
22              alert('Call ' + result.id + 'Just came in!');
23           };
24
25          //Note that we are using the CTI submodule here
26           sforce.console.cti.onCallBegin(callback);
27     </script>
28</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
id string The call object ID of the call which has begun.