Open CTI Developer Guide

Get Started with Open CTI
Call Center Definition Files
Working with Open CTI
Methods for Lightning Experience
disableClickToDial() for Lightning Experience for Lightning Experience
enableClickToDial() for Lightning Experience for Lightning Experience
getAppViewInfo() for Lightning Experience for Lightning Experience
getCallCenterSettings() for Lightning Experience for Lightning Experience
getSoftphoneLayout() for Lightning Experience for Lightning Experience
Sales Engagement Methods for Lightning Experience
isSoftphonePanelVisible() for Lightning Experience for Lightning Experience
notifyInitializationComplete() for Lightning Experience for Lightning Experience
onClickToDial() for Lightning Experience for Lightning Experience
onNavigationChange() for Lightning Experience for Lightning Experience
refreshView() for Lightning Experience for Lightning Experience
runApex() for Lightning Experience for Lightning Experience
saveLog() for Lightning Experience for Lightning Experience
screenPop() for Lightning Experience for Lightning Experience
searchAndScreenPop() for Lightning Experience for Lightning Experience
setSoftphoneItemIcon() for Lightning Experience for Lightning Experience
setSoftphoneItemLabel() for Lightning Experience for Lightning Experience
setSoftphonePanelHeight() for Lightning Experience for Lightning Experience
setSoftphonePanelIcon() for Lightning Experience for Lightning Experience
setSoftphonePanelLabel() for Lightning Experience for Lightning Experience
setSoftphonePanelVisibility() for Lightning Experience for Lightning Experience
setSoftphonePanelWidth() for Lightning Experience for Lightning Experience
Lightning Message Service Methods for Lightning Experience
Common Error Messages for Lightning Experience Methods
Methods for Salesforce Classic
Other Resources
PDF

saveLog() for Lightning Experience for Lightning Experience

Usage

Saves or updates an object in Salesforce. This method is available in API version 38.0 or later.

  • To update using this method, include Id.
  • To create using this method, include entityApiName.
  • If an object uses recordType, pass the recordTypeId in the saveLog call. If you don’t pass the recordType, the record is created using the default recordType for the profile. To create a person account, you can pass the person account recordType if the profile's default is to a business account.
  • To refresh after you update or create using this method, call the refreshView method in the callback method.

Note

Syntax

1sforce.opencti.saveLog({
2    value:{
3        entityApiName:string, //Optional
4        Id:string, //Optional
5        param:value //Optional
6        }, 
7    callback:function //Optional
8})

Arguments

Name Type Description
value object Specifies the fields to save or update on the object.
If the object’s ID is specified, a record is updated. For example: 
1{Id:"00QR0000000yN5iMAE", LastName:"New lastname" }
If the object’s ID isn’t specified, a new record is created. For example:
1{entityApiName:"Contact", LastName:"LastName" },callback:callback}

To create a record, ensure all the required fields are specified.

Note
callback function JavaScript method executed when the API method call is completed.

Sample Code–HTML and JavaScript

1<html>
2<head>
3   <script type="text/javascript" src="http://domain:port/support/api/66.0/lightning/opencti_min.js"></script>
4   <script type="text/javascript">
5      var callback = function (response) {
6         if (response.result) {
7            console.log('API method call executed successfully! returnValue:', response.returnValue);
8         } else { 
9            console.error('Something went wrong! Errors:', response.errors);
10         }
11      } 
12      function saveLog() {
13         //Update an existing object with the ID specified               
14         sforce.opencti.saveLog({value:{Id:"00QR0000000yN5iMAE", LastName:"New lastname" }, callback:callback});
15         //Create a contact
16         sforce.opencti.saveLog({value:{entityApiName:"Contact", LastName:"LastName" },callback:callback});
17         //Update a lead
18         sforce.opencti.saveLog({value:{Id:"00QR0000000yN5iMAE", LastName:"New lastname" },callback:callback});
19      } 
20   </script>
21</head>
22<body>
23   <button onclick="saveLog();">saveLog</button>
24</body>
25</html>

Response

This method is asynchronous. The response is returned in an object passed to a callback method. The response object contains the following fields.
Name Type Description
success boolean Returns true if the API method call was invoked successfully, false otherwise.
returnValue object ID of object if creating or updating the object was successful; null if creating or updating the object wasn’t successful.
errors array If the API call was successful, this variable is null. If the API call failed, this variable returns an array of error messages.