Salesforce quick setup guide

Who should read this article: All users

This guide is for experienced Salesforce administrators who do not require a full set of steps to configure objects in Salesforce related to integrating with third-party applications.

Introduction

Integrating Voiso with Salesforce is simple and only requires a few easy steps on both platforms:

1. Install the Voiso Softphone Package from the Salesforce AppExchange
2. Configure an integration user
3. Create and assign a permission set to the integration user
4. Connect Voiso to your Salesforce org
5. Configure and embed the Voiso softphone (Agent Panel) inside Salesforce
6. Set up a call center in Salesforce
7. Add the Voiso phone component to the Salesforce Utility Bar
8. Configure the Voiso call logging and history features.

Prerequisites

Ensure that the following prerequisites are in place before beginning:

1. The Salesforce CRM integration is activated for your contact center.
2. Your agents and other users use Salesforce Lightning Experience.
3. For users who create Dialer campaigns and import calling lists from Salesforce, ensure their account email addresses are the same in both Voiso and Salesforce.
4. The edition of Salesforce organization you are using has API access available and active.
5. Your administrator's Salesforce user account must have REST API Enabled permissions and Administrator privileges set.

Integration

Follow these numbered steps to set up, configure, and connect Voiso to Salesforce.

Step 1: Install the Voiso Softphone Package from AppExchange

Click the link in step 1 of the Salesforce CRM settings section to open the Voiso Softphone Package page on the Salesforce AppExchange.

1. Click Get It Now.
2. Select a Salesforce account associated with your contact center.
3. Choose either Install in a Production Environment or Install in a Sandbox.
4. Select the connected Salesforce Account from the drop-down menu.
5. Review and confirm the installation details.
6. Choose which user to install for, then click Install.

Step 2: Configure an Integration User

Grant the required permissions to the integration user by creating your own permission set, as recommended by Salesforce, or by modifying an existing user profile. Refer to Step 2.1) for details.

Step 2.1: Create a Permission Set

Perform the following steps:

1. Create a new permission set.
   • Label: Voiso Integration User (System & User Permissions)
   • API name: VoisoIntegrationUser
2. After saving the set, click Edit, then select the following options:
   • Apex REST Services (Voiso uses the Apex REST Endpoints for both the Call Logging feature and authentication).
   • Customize Application (Voiso uses Custom Settings to cache static Voiso call center settings in your org).

Step 2.2: Assign the permission sets to the Integration User

Perform the following steps:

1. From Setup, navigate to the user who will be the integration user with Voiso.
2. Assign the following two permission sets to the integration user:
   • Voiso Integration User (System & User Permissions) – the one you created in Step 2.1
   • Voiso Integration User – the one provided by the Voiso Software package

Step 3: Connect Voiso to Salesforce org

From the Voiso navigation bar, select Administration > Integrations.

Follow these steps to connect Voiso to Salesforce org:

1. In the Integrations page, click Connect on the Salesforce tile.
2. Review the About and Prerequisites sections and ensure all prerequisites are met in your contact center.
3. Click Connect.
4. In the Integration setup panel, click either Connect to Salesforce or Connect to Salesforce Sandbox, depending on your choice in step 1.
5. Follow the on-screen instructions.
6. When the Voiso Allow Access? page displays, click Allow to complete the connection.

The following video walks you through the integration process.

Step 4: Complete configuration

In this step you configure the embedded softphone component into Salesforce.

• Set up a Call Center by importing a Call Center Definition file.
• Add the Voiso softphone directly into the Salesforce Utility Bar.
• Configure the Voiso contact center features you want to use.

Step 4.1: Set up a call Center in Salesforce

Follow these steps to set up a call center in Salesforce Lightning:

1. Create a Call Center Definition .xml file using the following contents:

<callCenter>
    <section sortOrder="0" name="reqGeneralInfo" label="General information">
        <item sortOrder="0" name="reqInternalName" label="Internal name">VoisoPhoneCTI</item>
        <item sortOrder="1" name="reqDisplayName" label="Display name">VoisoPhoneCTI</item>
        <item sortOrder="2" name="reqAdapterUrl" label="Container URL">https://my-domain--c.container.force.com</item>
        <item sortOrder="3" name="reqVoisoClusterUrl" label="Voiso Cluster URL">https://yourcc.voiso.com</item>
        <item sortOrder="4" name="reqUseApi" label="Use Open CTI API">true</item>
        <item sortOrder="5" name="reqSoftphoneHeight" label="Voiso Phone height">472</item>
        <item sortOrder="6" name="reqSoftphoneWidth" label="Voiso Phone width">264</item>
        <item sortOrder="7" name="reqSalesforceCompatibilityMode" label="Compatibility Mode">Lightning</item>
    </section>
</callCenter>

2. Import the Call Center Definition file into Salesforce.
3. In the All Call Centers view, next to your contact center, click Edit, then:
   1. Modify the Voiso Cluster URL by replacing https://yourcc.voiso.com with your fully qualified cluster URL. For example, https://cluster.voiso.com.
   2. Modify the Container URL by replacing https://my-domain--c.container.force.com with your fully qualified container URL. For example, commerce2-dev-ed--c.develop.container.force.com.
4. Add users to the call center.

Step 4.2: Add the Voiso Phone component to the Utility Bar in Salesforce

Follow these steps to add the Voiso softphone directly into the Salesforce Utility Bar:

1. In App Manager, choose the Salesforce Lightning app to which you want to add the Voiso softphone, such as LightningSales, then click Edit.
2. Add the Voiso Phone component as a Utility Item with the following parameters:
   • Label: Voiso Phone (or any other label you choose)
   • Icon: Select a call icon of your choice (any icon is supported)
   • Panel Width: 264 (264 to 360 is supported)
   • Panel Height: 472 (472 to 600 is supported)
   • Enable Start automatically (it's required for Click-to-Call and receiving inbound calls).
     
3. Click Save.

Enable Track Activities

The Track Activities feature is enabled by default. For Activities to link to records, define which objects handle external contacts and store phone numbers.

Enable Call History

Unlike the Track Activities feature, Call History is not linked to records through lookup relationships. You can add Call History to any Record Details page using the App Builder. This component collects and displays call history records based on phone fields accessible to the current user, sorted by call start time.

Follow these steps to add the Voiso Call History Related List component to the Record Details page:

1. Choose the Salesforce object to which you want to add a component and navigate to any record details page for that object.
2. From the gear icon menu, select Edit Page.
3. From the component list (left sidebar), drag and drop the Voiso Call History Related List component onto the page canvas. Tip: Voiso recommends experimenting with different locations on the page to find the best placement for your environment.
4. From Setup, navigate to Permission Sets.
5. Find Voiso User in the list, then click its label to open it.
6. Click Manage Assignments at the top of the page, then click Add Assignment to display a list of users to whom this set of permissions can be assigned.
7. Select the users who should have access to the component.
8. Click Next, then click Assign.

Enable Screen pop

To enable screen pop for agents, on the CRM Integration page, scroll down to Salesforce CRM settings, and select Enable Screen Popup on Call.

Enable Click-to-call

Once you complete the following steps in the integration procedure, Click-to-call is enabled automatically after an agent logs in to the softphone:

• Set up a call center in Salesforce
• Add the Voiso Phone component to the Utility Bar in Salesforce

The Click-to-Call feature can be used with standard Salesforce objects (Lead, Contact, Account, and others) and custom objects. Ensure that Track Activities is enabled for custom objects in Salesforce to link Task records correctly.