Salesforce Lightning Console Integration

Overview

When your customers start a new conversation, the Quiq system can create a new Salesforce Case, Lead or Task for the conversation, depending on your company's business needs. You may create a System Administrator account for a Quiq employee to complete this setup, or you can proceed with these steps on your own.

The instructions below are specific to the Lightning Experience interface. It is assumed that your Salesforce site will have lightning experienced enabled and that your team(s) will be using a console navigation application within the lightning experience. If your Salesforce org is not setup for lightning experience, please see Salesforce Integration (Classic Console).

Quiq is happy to make a test site available to match with a Salesforce Sandbox site. Whether your Salesforce admin or Quiq accomplishes the configuration, your admin should be available and work with Quiq through the process.

Set Up Steps

🚧

NOTE

YOUR_QUIQ_TENANT is a placeholder for the name of your tenant in the Quiq system. It is often your organization name and is the first part of the URL to your Quiq site. Confirm this with Quiq support before you continue. YOUR_SALESFORCE_SITE is the full name of your Salesforce site, typically ending in salesforce.com.
Quiq connects to Salesforce via a Connected App.

1: Integration Account

Salesforce requires API calls to go through a Connected App as well as through a user account. You will need to create a user account in your Salesforce org(s) for the Quiq Integration user. In order to prevent disruption in your integration service, it is advised that you set the integration user with the "password never expires" system permission.

1. In Salesforce, navigate to Setup > Users > Profiles

2. Create a new profile by cloning from the "System Administrator" profile*

3. Name this profile “Quiq Integration” and save

4. In the new profile navigate to System Permissions

5. Click Edit and update the "Password Never Expires" to true and save

6. Navigate to Users > Users > New User

7. Create a new user with the “Quiq Integration” profile. For email/username use “[email protected]”.

8. Your Quiq implementation specialist will receive your new user email and will continue to proceed with the integration setup

📘

NOTE

If you prefer not to create a new profile or clone the system administrator profile you may set up the Integration user with an existing profile (Salesforce license) and instead create a new permission set specific for Quiq.

Quiq will need access to Accounts, Contacts, and Leads for phone number and email matching as well as to any objects and records (e.g., Cases and Tasks) that you desire to have Quiq create and update.

Depending on your Salesforce security and permission settings using this method may require you to update record sharing rules as well. Work with your Implementation Specialist to ensure all the proper access has been granted.

2: Connected App

1. In Salesforce, navigate to Apps > App Manager > New Connected App

2. Under Connected App Name type "Quiq Backend Integration"

3. For Contact Email input "[email protected]"

4. Check the Enable OAuth Settings box.

5. For Callback URL put in two values separated by a new line.

6. For Selected OAuth Scopes choose Full Access (full)

7. Securely share your Consumer Key and Consumer Secret with your Quiq Implementation specialist

8. Click Manage > Edit Policies > Navigate to OAuth Policies

9. Change Permitted Users to "Admin approved users are pre-authorized"

10. Change IP Relaxation to "Relax IP restrictions"

11. Save

12. Click the "Manage Profiles" and/or "Manage Permission Sets" buttons and add the appropriate profiles or permission sets that your agents / end users who will be using Quiq in Salesforce are in.
The connected app configuration should look similar to this:

3: Install the Quiq Package

Log into Salesforce as a user with adequate (admin) permissions, then open a new browser tab and place the Quiq Package URL provided by your Quiq implementation specialist. This will open a package installer interface and allow selection of target users. Ensure that “Install for all users” is selected. This will grant access to the lightning components and classes that are needed to run Quiq inside of Salesforce.

400

When the installation has completed, select Done.

4: Add Quiq Components to Consoles

Quiq components are designed to fit into Lightning apps in both the Utility bar and Lightning Record Page layouts.

242

Utility Bar

1. In Salesforce, navigate to Setup > Apps > App Manager

2. Find the Lightning console navigation App to which you wish to add the Quiq components (or create a new application), and choose Edit from the dropdown menu in the last column

3. In the Lightning App Builder screen, select Utility Items on the left side menu

4. Click the "Add Utility Item" button

5. Scroll down to the Custom - Managed sections and choose Quiq Messaging

6. Confirm the Utility Item Properties as follows:

7. Save

Pages

Once the page has been activated, open the app and select a record to view the result. The Quiq Conversation component may reside in any page layout, but should be given adequate room for the conversation and collaboration sections to display correctly.

1. Navigate to your object (e.g., Cases) and create or modify an existing lightning Record Page

2. In the lighting page editor, find the "Quiq Conversation" custom managed component from the left hand

3. Label - Quiq Case or Quiq Lead (depending upon record type)

4. Object - Case or Lead

5. Click Next, and select a desired layout (suggest “Header and Right Sidebar”)

6. Click Finish

7. Under Components, locate the Custom - Managed components section and drag the "Quiq Conversation" component to your desired location on the record page layout.

8. Under the component configuration add the following:On the right side enter the following:

  • Height = 800

9. Save and Activate the Page

600

CUSTOM SETTINGS

1. In Setup search for Custom Settings

2. Click Manage in the Quiq Settings custom setting

3. Click New to create the Default Organization Level Values

4. For Quiq URL, enter the URL of the your base Quiq site. E.g. https://tenant.goquiq.com. Ensure you don't have a trailing slash.

5. Click Save