How it works

Image Removed   Salesforce integration is used to automatically open a task for every call according the conditions (Queue, Call status or Outbound) set in the trigger: the Salesforce Task or Case that will be created automatically, will be populated with information about the call and displayed to the agent in the Salesforce environment.

The following is a list of operations to do to make the integration work:

1. Download and use the XCALLY Motion Phonebar Windows App and the XCALLY Motion Dialpad Chrome Extension. This step is mandatory only if you choose to define the Salesforce Account as an Integration Tab type (OpenCTI Integration). On the contrary, if you choose to define the Salesforce Account as a New Tab type, you can use an external phone (of course, in this case you must login in the XCALLY Motion Omnidesktop interface) or WebRTC. Learn more about this topic here

2. Create a Connected App in Salesforce

3. Create Salesforce Account in XCALLY Motion 

4. Create Salesforce Configuration for the account created in XCALLY Motion

5. Create a Trigger (Tools → Triggers) for both inbound and outbound, set the conditions you want to trigger for this integration and add integrations action, by selecting theSalesforce integration, Salesforce Account and the Configuration you want to use. As an alternative for only outbound you can configure a Click-to-Call integration 

6. Configure Salesforce for OpenCTI Integration (Optional: this step is mandatory only if you want to use the Integration Tab type otherwise you don't need to do it

7. Test the Integration

8. Login Agent in Salesforce and/or Motion and start!

After the configuration steps listed above, every time there is an outgoing/incoming call the trigger conditions are checked and a Salesforce task is created and assigned to the agent managing the call (if the conditions are met).

Requirements - What to know before starting 

In order to have the integration working correctly, please be sure to:

install and use the XCALLY Motion Dialpad Chrome Extension, to allow Phone functionality in Salesforce Console App (only for OpenCTI Integration). Using it, you can:

• Click-to-Dial from Salesforce Tab

• Answer/Hangup calls directly from embedded phone in Salesforce

install and use the XCALLY Motion Phonebar

• Install a valid HTTPS certificate

• Agent's Email in Salesforce profile is exactly the same as Agent's Email in Motion

• Agents can access to all properties inside the Task object

As for the Integration Type: 

For New Tab the Agent must be logged in XCALLY Motion Phonebar, XCALLY OmniDesktop Interface and Salesforce Web Interface. In this case the Agent must ENABLE the browser pop-ups, when he/she receives the first call.

Image Removed

Image Removed

The Salesforce Accounts Section

The Salesforce Accounts Section is under the Integrations Menu:

Image Removed

Image Removed

The following are the configuration steps described above:

1-Create Connected App in Salesforce

First of all, create a new Connected App in Salesforce to make Salesforce-Motion integration work. If you are in Lightening Experience, make sure to switch to Salesforce Classic and then follow the steps below in order to create the XCALLY Motion Connected App. 

• Login to Salesforce with an administrator account and go under the Admin Setup section. In the menu, on the left, click on Build -> Create -> Apps 

Image Removed

and then on the New button in the Connected Apps section:

Image Removed

• Insert the following data into the New Connected App:

Image Removed

• Connected App Name: xCally Motion

• API Name: xCally Motion

• Contact Email: your company mail address

• Enable OAuth Settings: Enabled

• Insert the Callback URL: https://login.salesforce.com/services/oauth2/callback

• Select and add the following OAuth Scopes:

  • Access and manage your Chatter feed (chatter_api)

  • Access and manage your data (api)

  • Access custom permissions (custom_permissions)

  • Access your basic information (id, profile, email, address, phone)

  • Allow access to your unique identifier (openid)

  • Full access (full)

  • Perform requests on your behalf at any time (refresh_token, offline_access)

  • Provide access to custom applications (visualforce)

  • Provide access to your data via the Web (web)

2-Create a Salesforce Account

To create a new Salesforce Account go in the Integrations Section → Salesforce Accounts and click on Image Removed

Image Removed

Enter the following details and click on Add Salesforce Account:

Type: chose between Integration Tab or New Tab

After the Account is created, you can view it in the list of accounts, edit the account parameters and remove the account. 

You can verify if the account credentials are correct by clicking on Test Salesforce Account.

Image Removed

How to Find the Client ID and Secret

Image Removed

How to Find the Token

Image Removed

You will receive the token via email.

Please note that any time you change the Salesforce user password, the Token becomes invalid and must be reset: remember to insert the new one on the XCally Motion Salesforce Account to make integration work!

3-Create a Salesforce Configuration

Find the account from the accounts list and Click on Edit Salesforce Account:

Image Removed

You will see two tabs: Account and Configurations:

Image Removed

In the Account tab, you can modify the account parameters and in the Configurations tab, you can create, update or delete Salesforce configurations. 

A Salesforce configuration is used to design the content of the Salesforce task (Subject, Description and Fields) that is created and displayed for the agent managing calls.

You can create multiple configurations for a single Salesforce Account and use them in different triggers. In this way, for example, you will be able to use different task layout for outbound and inbound calls.

To create a new configuration, Edit the Salesforce account, go under configurations tab and click on Image Removed

Image Removed

Image Removed

Choose a Name, Channel (e.g. Voice).

Choose a Type:

• Inbound in Queue 

• Outbound Call 

Image Removed

Choose a Ticket Type:

• Task

• Case

        Image Removed

Then, click on Add Salesforce Configuration.

This value is used during the startup of the configuration and is used by the system to generate the template: the configuration will be created with default Subject and Description settings that you can simply use without any modification.

You can also edit the configuration and customize the Subject, Description and Fields of the Salesforce Task according to your needs.

Image Removed

By default, you will find the following three fields already configured

• the String [XCALLY Ticket]

• the Queue Variable

• the Caller number Variable

You can add more than one field in the Subject and all fields will be joined by the blank space.

Use Image Removedbutton to add a new fields. New fields are added at the end of the field list.

You can insert 3 different type of fields:

1. String: static string e.g. a label as [xCALLY Ticket]

2. Variable: Motion System Variable, e.g. queue or calleridnum (see V3 Motion Variable List)

3. Custom Variable: any dynamic variable created under Tools > V3 Variables

Image Removed

You can add more than one field in the Description. All fields will be joined by new line.

Use Image Removedbutton to add a new Description (it will be added at the bottom of the list).

You can insert two different type of fields:

1. String: static string e.g. *** Call Info ***

2. Key Value: name-value item in the form name: value

where the first field is a static string (e.g. Caller Number) and the second field could be filled with the following:

• String: static string

• Variable: System Variable like Caller Number (see V3 Motion Variable List)

• Custom Variable: dynamic variable created under  Tools > Variables

The colon character in the Key Value type is automatically added by the system

Image Removed

In the drop-down list you can find the complete list of fields available in your Salesforce account: Standard and Custom fields.

Use Image Removedbutton to add a new field, choose the Standard or Custom field by scrolling the list of the values:

Column
width 50%
Image Removed

Column
width 50%
Image Removed

and define the Type:

Image Removed

• String: static string (you must insert it)

• Variable: a System Variable (choose it from the list: e.g. Queue, uniqueid, calleridnum, etc.)

• Custom Variable: one of the dynamic variables (created under Tools > Variables)

• Picklist: choose among the list of the integrated Application Fields. You can only select one of the predefined values available for that field (if any).

Repeat the steps above to add more fields.

Image Removed

In this section you can set:

• how to Search the Module as: Account, Lead, Contact, Contact&Lead, Contact&Lead&Account

Image Removed

• how and if (nothing=no creation) to Create the Module as: Contact, Lead or Account

Image Removed

• Lead Id, where to insert the Lead name (this field will be shown only if the Module Search field is or contains Lead):

Image Removed

• an additional field where to search the customer phone number in the:

  • Account, if the Module Search value chosen is (or contains) Account

  • Contact, if the Module Search value chosen is (or contains) Contact 

  • Lead, if the Module Search value chosen is (or contains) Lead

Image Removed

4a-Configure Salesforce for OpenCTI Integration Type (Lightning Version)

 You need to perform the following steps to make the OpenCTI integration work: 

• Create a call center adapter

• Create lightning experience app

• Install chrome extension

• Login agents

Create a call center adapter 

• Login to Salesforce with an administrator account and switch to lightning experience

Image Removed

• Click on Setup

Image Removed

• Create a Call Centers: Go to Feature Settings -> Service -> Call center and click Continue

Image Removed

• Click on Import and upload call_center.xml  (Remember to insert the real IP address of your XCALLY Motion Server)

Image Removed

Image Removed

You will see the imported Call Center, called MotionAdapter. 

Image Removed

Image Removed

Create lightning experience app

• Go under Apps -> App Manager and click on New lightning App

Image Removed

• Fill the required setting as shown below and click Next

Image Removed

• Select Console navigation and click Next

Image Removed

• Click on Add and select openCTI softphone. 

Image Removed

• Customize the layout of the softphone as you desire and then click Next

Image Removed

• Add items to use in the app: Select Leads, Contacts and Tasks

Image Removed

• Select user profiles to give them permission to use and see the app. Choose the profiles your agents belongs to and click Finish

Image Removed

• Click on App launcher button at the top left of the screen and you will see the new Motion app in the app launcher as shown below

Image Removed

• Click on the Motion app, to see the ligthning app with the softphone embedded inside. 

Install the Motion Dialpad Chrome extension 

You need to install xCALLY Motion Dialpad Chrome extension to use Phone functionality in Salesforce Console App.

The Chrome Extension is available here in the Chrome Web Store.

4b-Configure Salesforce for OpenCTI Integration Type (Classic Version)

Use this integration type if you don't want to use a double login (Salesforce and Motion) and the the Integration Tab mode.

You need to perform the following steps to make the OpenCTI integration work:  

• Create a call center adapter

• Create Console App

• Install chrome extension

• Login agents

Create a call center adapter 

• Login to Salesforce with an administrator account

Image Removed

• Click on Setup

• Create a Call Centers: Go to Build -> Customize -> Call Center → Call Centers and click Continue

Image Removed

• Click on Import and upload call_center.xml (Remember to change the IP address of your Xcally Motion Server)

Image Removed

Image Removed

You will see the imported Call Center, called MotionAdapter. 

Image Removed

Image Removed

Create Console app

• Go under Build → Create → Apps and click on New

Image Removed

• Select Console as App Type and click Next

Image Removed

• Fill the required setting as shown below and click Next

Image Removed

• Click on Next. 

Image Removed

• Select Navigation Tab Items that you want to display and then click Next

Image Removed

• Click Next

Image Removed

• Select user profiles to give them permission to use and see the app. Choose the profiles your agents belongs to and click Finish

Image Removed

• Click on Force.com App Menu button at the top right of the screen and you will see the new xCALLY Motion app in the list as shown below

Image Removed

• Click on the xCALLY Motion, to see the console app with the softphone embedded inside the app. 

Install the Motion Dialpad Chrome extension 

You need to install xCALLY Motion Dialpad Chrome extension to use Phone functionality in Salesforce Console App.

The Chrome Extension is available here in the Chrome Web Store.

Integration using Trigger

It is mandatory to create a Trigger to make the Salesforce integration work.

Go to Tools -> Triggers Section and click on New Trigger.

Image Removed

Enter the trigger Name, select Voice Channel and click on Add Trigger. 

Edit the trigger to define the trigger's Conditions and Actions.

Add Trigger Conditions

You can use properties like Queue, Call status or outbound to define the conditions you want to trigger the Salesforce integration.

E.g.: in the following example the conditions set mean that the integration will be active for Calls in Sales Queue and when the call is answered. 

Image Removed

For more information on trigger conditions, take a look at Voice Trigger Conditions.

Add Trigger Action

To execute the Salesforce integration when the conditions are met, click on Add Action and select Integrations and Salesforce.

You can then select one of the the Salesforce account you have created and the configuration you want to use.

Image Removed

Integration using Click-to-Call

The main goal of the LogCall integration is to perform the creation of a task each time a dial event is triggered, using the ClickToCall tool.

For instance, from a customer tab you can just click on the telephone number and start a conversation with the contact: in this case, a new Task object will be created and opened in a dedicated tab, containing all updated information regarding the phone call.

Image Removed

Configuration Steps for Lightning Version

We have already created a Call Center Adapter in the previous section: now we can edit its parameters.

Image Removed

Change the Manage Task parameters in order to:

• Create a task during the phone call (true or false): create a Task object during a click to call action

• Create the task on the customer answer (true or false): create the task, but only in case the customer has answered to the phone call

• Update the task fields on hangup (true or false): update the information registered inside the Task object after the hangup event (end of phonecall)

• Refresh the task page on hangup (true or false): immediately refresh the task tab after the hangup event

• Default status of created task (Not Started, In Progress ecc…): set the default status of Task object after the object is created

• Default status of updated task (In Progress, Completed…): set the default status of the Task object after the object is updated

In the Field Mapping section, you'll find eleven fields available, each related to an Asterisk* environment variable, that you can use to fill your own custom fields created for the Activity / Task object (these fields are absolutely not mandatory for the ClickToCall LogCall function to work properly):

Image Removed

In order to visualize the Asterisk* variable content inside a custom field:

• create a custom field of type String (255) 

Image Removed

• copy the Field Name (ID_Name on Salesforce Classic Version) inside the input field of the related Asterisk* variable

• save

Now the Activity Task Tab created by LogCall will show the Asterisk* variable content inside your own custom field.

Return on the main page and click on the colored dots-button on the far left to access to all the registered app.

Click on your dedicated Motion Lightning console app:

Image Removed

Now you can see that you are logged in as Agent on the XCALLY Motion Phonebar.

Click on the PHONE button on the bottom left on the main page, and open the softphone. You will see you are online as an Agent:

Image Removed

If a phone call is already active on the phonebar, you will see the same information on the softphone, and you will have to wait for the phone call to end before performing a new dial event (from the phonebar or the softphone, as well as by clicking a phone number inside the Contact object tab):

Image Removed

If no phonecall is active, it means you are ready to do a new one. To do it as a ClickToCall event, go to Contact / Lead / Account object tab, search a phone number, and click it:

Image Removed

and the XCALLY Motion Phonebar will perform a phone call usng the clicked phone number as target:

Image Removed

You can see the same information regarding the phonecall on the upper part of the sofphone, but in the same time a new event has been triggered and a new Task object regarding an Outbound call to the customer phone has been created and opened in a dedicated tab:

Image Removed

According the configuration fields you managed in the Call Center section, three events can be fired on ClickToCall:

• no Task object is created (Create a task during the phonecall = false)

• a new Task object is created when you clicked on the contact phone number (Create a task during the phonecall = true & Create the task on customer answer = false)

• a new Task object is created when the customer answered the phonecall (Create a task during the phonecall = true & Create the task on customer answer = true).

In case a new Task object has been created, you’ll see all the updated information regarding the phonecall (by default, the field Description is the one that receives information from the remote server):

Image Removed

When hanging up (performed by you or by the contact), three possible events can be triggered:

• no events at all and the Task object will not be updated with new information regarding the phonecall (Update the task fields on hangup = false)

• the Task object will be updated with the new information. You can see the updated information once you will enter again the tab or refresh it (Update the task fields on hangup = true & Refresh the task page on hangup = false)

• the Task object will be updated and the Task object tab will be refreshed, so that the updated information will be immediately visible (Update the task fields on hangup = true & Refresh the task page on hangup = true).

In case the Task object has been updated, you will read the new updated information regarding the phonecall (like hold time, end time, duration, and billable seconds):

Image Removed

The softphone is now ready to perform a new phonecall, and the ClickToCall integration is again ready to dial a call by clicking on a phone number visible in the Contact / Lead / Account tab.

Configuration Steps for Classic Version

We have already created a Call Center Adapter in the previous section: now we can edit its parameters.

Image Removed

Change the Manage Task parameters in order to:

• Create a task during the phone call (true or false): create a Task object during a click to call action

• Create the task on the customer answer (true or false): create the task, but only in case the customer has answered to the phone call

• Update the task fields on hangup (true or false): update the information registered inside the Task object after the hangup event (end of phonecall)

• Refresh the task page on hangup (true or false): immediately refresh the task tab after the hangup event

• Default status of created task (Not Started, In Progress ecc…): set the default status of Task object after the object is created

• Default status of updated task (In Progress, Completed…): set the default status of the Task object after the object is updated

In the Field Mapping section, you'll find eleven fields available, each related to an Asterisk* environment variable, that you can use to fill your own custom fields created for the Activity / Task object (these fields are absolutely not mandatory for the ClickToCall LogCall function to work properly):

Image Removed

In order to visualize the Asterisk* variable content inside a custom field:

• create a custom field of type String (255) 

• copy the Field Name (ID_Name on Salesforce Classic Version) inside the input field of the related Asterisk* variable

• save

Now the Activity Task Tab created by LogCall will show the Asterisk* variable content inside your own custom field.

On the Motion Call Center Dialpad form, in the Salesforce Compatibility mode enter the value Classic_and_Lightning to make the XCALLY Motion Softphone compatible both on Classic and on Lightning version:

Image Removed

If all Call Center configuration parameters have been correctly managed, you'll will find the SoftPhone loaded and ready in the dedicated Motion Classic console app section:

Image Removed

• Open a Contact / Lead / Account tab

• Click the PHONE button you find on the bottom right of main page, and open the softphone and on the top of main page, you will see the XCALLY Motion Phonebar ready to perform phone calls.

• Find a phone number, and click it to trigger a ClickToCall action.

According the configuration parameters you have chosen in Call Center Section, the ClickToCall  action can trigger the creation of a Task object, on dial or on customer answer, with information about the phonecall (LogCall integration):

Image Removed

In the same way, the hangup event can trigger an update of the informations visible on the Task object tab. The tab can automatically be refreshed on the hangup event:

Image Removed

Using Salesforce & Phonebar

Login agents in Salesforce interface and in Motion Phonebar (motion server must be the same as the host configured in the call center adapter settings)

Image Removed

and experience the integration, as in the following two examples:

Test the Integration - Classic Version

• the Agent (John Doe), that is configured on the XCally Motion Queue Support and on Salesforce, receives a call from a Customer, Jane Miller

Image Removed

and  this will cause the opening of a task, according the conditions (e.g. queue) set in the trigger:

Image Removed

• the Agent (John Doe) calls a Customer number and this will cause the opening of a task, according the conditions (e.g. Outbound route) set in the trigger:

Image Removed

Test the Integration - Lightning Version

• the Agent (John Doe), that is configured on the XCally Motion Queue Support and on Salesforce, receives a call from a Customer, Jane Miller

Image Removed

and  this will cause the opening of a task, according the conditions (e.g. queue) set in the trigger:

Image Removed

• the Agent (John Doe) calls a Customer number and this will cause the opening of a task, according the conditions (e.g. Outbound route) set in the trigger:

Image Removed

TIP

If the agent is logged with the Motion Phonebar and logged on Salesforce and the Salesforce Task is not opened:

Check that the agent can reach your Motion GUI via https