Determining Install Version

The Salesforce.com Connector offers various installation methods tailored to distinct use cases. The appropriate installation method should be chosen based on your specific requirements. The table below outlines the three (3) primary use cases, each represented in its own column. Should a section pertain to a particular use case, a notification box will be prominently displayed at the beginning of that section.

Installation Overview

Lead Liaison is installed into Salesforce.com in a few easy steps. Here's an overview of the installation process:

1. Setup a CRM sync user by adding your CRM credentials into Lead Liaison.

2. Install Lead Liaison's Salesforce.com package through Salesforce.com's AppExchange.

3. Add fields into your Salesforce.com Lead and Contact Layouts. 

4. Setup Lead <> Contact field mappings in Salesforce.com.

5. Use Lead Liaison's CRM configuration wizard and sync your Salesforce.com data to Lead Liaison.

Lead Liaison's Salesforce.com package will make the following changes to your Salesforce.com account:

1. Add two new sections to your Leads and Contacts page layouts

   1. Lead Liaison (Native force.com module) to display activities, nurturing, scoring, grading, etc.

   2. Lead Liaison Marketing Data to display important marketing information such as total website visits, last website visit, lead score, and more.

2. Create a new layout for the Leads and Contacts pages (optional to use).

Connect Salesforce.com to Lead Liaison

Follow these step by step instructions to connect your Salesforce.com account to Lead Liaison. 

Step 1: Add CRM Sync User

Lead Liaison requires one Salesforce.com user account be used as a master sync account. The sync account is the account used to send data bidirectionally, from Salesforce.com to Lead Liaison and from Lead Liaison to Salesforce.com. The sync account is required for operation and has no material impact on leads, contacts, opportunities or any other event.

Follow the steps below to enter your CRM sync user:

1. Login to Lead Liaison at https://app.leadliaison.com/login.php using the account you'd like to use as your sync user. This should be a Lead Liaison user with Admin privileges. 

2. Go to Settings > Integrations > Connectors
   

3. Look for the "Salesforce.com" section and enter your Salesforce.com credentials. Your password is your CRM password followed by your security token. See this post on Salesforce.com for help finding your security token. 

Once you've connected your Lead Liaison account to your Salesforce.com account successfully you'll see a success prompt similar to the one below:

Step 2 (Optional): Install Lead Liaison's Plugin into Salesforce.com

Install URL

Lead Liaison's Salesforce.com plugin is live on Salesforce's AppExchange portal. Access the plugin here: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tA0000000KP72

Follow the instructions below:

• After install, and to view the package contents at a later point show all installed package contents under 'Setup' > 'Installed Packages'.

• Proceed to Step 3 to integrate Lead Liaison into your layout.

Step 3: Add Lead Liaison's Custom Fields/Sections to your Salesforce.com Layout

During this step you will add two sections, "Lead Liaison Marketing Data" and "Lead Liaison", to the Lead and Contact layouts.

• Open the Leads page layout by going to Setup > Object Manager > Lead > Page Layouts.

• Click on the layout you'd like to add Lead Liaison's custom fields/sections to

• You will see a page similar to the one below.

• Drag the "Section" box into the page below in the location you desire.

• In the popup enter "Lead Liaison Marketing Data" as the "Section Name". Leave "Layout" and "Tab-key Order" with the default settings unless you need to change them.

• Start dragging and dropping Lead Liaison's custom fields to the newly created "Lead Liaison Marketing Data" section.

• Keep going until you've added all of the following fields (15 in total):

  1. Lead Liaison Score

  2. Total Activity

  3. Total Web Visits

  4. Total Time Spent on Last Visit

  5. Last Sync to Lead Liaison Web App

  6. Last Web Visit

  7. Last Search Engine

  8. Last Search Phrase

  9. Original Referral Source

  10. Bounced

  11. Email Opt Out

  12. Lead Liaison Grade

  13. Lead Liaison Campaign

  14. Lead Liaison Program

  15. Profile ID

• When your section looks like the "Lead Liaison Marketing Data" section in the screen shot below click the 'Save' button to finish.

• Repeat the process of adding the new fields to your Lead Page Layout for the Contact Page Layout. 

• Next, install the "Lead Liaison" section into your Lead and Contact Layout. This is a Visualforce page customized for Salesforce.com. 

• Follow the screenshots below to repeat the process for both your Lead and Contact Layout.

• Set the following section properties:

• Click the settings icon (wrench) in the top-right of the Visualforge page (blue section)

• Set the Page Properties as follows:

Step 4: Map Lead Custom Fields to Contact Custom Fields

Next, map the custom fields added by the Lead Liaison plug-in. Mapping custom fields ensures information added to a Lead is transferred to a Contact when the lead is converted in Salesforce.com. To map fields do the following:

1. Go to Setup > Object Manager > Lead > Fields and Relationships.

2. Scroll to the bottom and click the "Map Lead Fields" button in the "Lead Custom Fields & Relationships" section.

3. Click on the 'Contact' Tab.

4. Map each custom Lead field to the related Contact field. Your results should look similar to the image below:

Step 5: Change Field Accessibility to Allow Syncing

To allow Lead Liaison's software to view and interact with certain Salesforce.com fields visibility permissions must be changed for each field listed below under the respective object. Five (5) objects contain fields that need updated visibility permissions. The 5 objects are:

1. Leads

2. Contacts

3. Accounts

4. Tasks

5. Opportunities

6. Campaigns (if you're using them)

How to Change Visibility Permissions

1. Go to Setup> Users > Profiles

2. Click on the profile of the CRM sync account

3. Click "Object Settings". Find the "Leads" object and click on it.

4. Click the 'edit' button.

5. Make sure to check all the checkboxes under "Visible" (or "Read" and "Edit" columns) then save. 

6. Repeat the same process for the Contacts, Accounts, Opportunities and Tasks objects

Step 6: Create Custom Fields in Lead Liaison

To create custom fields in Lead Liaison follow these instructions. 

Note, custom fields can automatically be created for you as shown in the steps below.

Step 7: Configure Lead Liaison and Sync your Salesforce.com Data

You're now done with setup inside Salesforce.com. Next, go to Lead Liaison and finalize setup from Lead Liaison's web application.

Complete Lead Liaison's CRM Configuration Wizard:

Lead Liaison synchronizes data between Lead Liaison's local database and Salesforce.com in real-time. To configure your CRM settings for Lead Liaison:

1. Login to Lead Liaison at https://app.leadliaison.com/login.php

2. Click the Settings > Integrations > CRM

3. Follow the wizard step by step to get your CRM account configurations complete

• Select your Salesforce.com account edition.

• Check the "Automatically import data for new SFDC fields (make them Active) box if you want to begin pulling in data for all new custom fields automatically. When checked, any data in a custom field created in Salesforce.com will automatically be imported into Lead Liaison even if the field is not mapped to a Lead Liaison field. If this setting is turned off new custom fields will not be marked as "Active" in Lead Liaison by default (on the field mapping pages) and the data will not be imported into Lead Liaison. The custom field could be mapped later on; however, data import will start from the time the field is mapped and made "Active" and will not import older data. You may want to uncheck this field if you have confidential information (passwords, data, keys, etc.) you do not want to expose to Lead Liaison or your employees. 

  • For Enterprise and Unlimited Editions: Make sure to configure proper permissions for all custom fields per the permission section above. If permissions are not configured properly for a custom field correct the permissions or uncheck the "Active" column on the map fields page. 

  • For Group or Professional Editions: Make sure to add the new fields to your layout. 

• Note, this setting is turned on by default for all new accounts. 

• Click "Save" when done.

• When you see the success prompt click "Next" to proceed to Step 2, Install Plug-in

• Assuming you've installed Lead Liaison's plug-in into Salesforce.com, enable the toggle to Verify the package install and click "Continue" on Step 2. Your plug-in installation should be validated and you'll see a success prompt similar to the one below. Click the "Next" button and proceed to Step 3 of the wizard.

• If you see an error prompt similar to the one below then the system is trying to access a field in the Lead or Contact Layout but the system is unable to do so since the respective field is not present in the Layout. Add the field to the Layout, save the Layout and proceed. In the screen shot below, the "Number of Employees" field needs to be added to the Lead Layout. 

• • If you are keeping the standard Salesforce.com layout and would like Lead Liaison to automatically add our custom fields to the standard layout then the wizard will display a page similar to the one below. Check the box and click "Next" to proceed to Step 3 of the wizard.

• Lead Liaison automatically imports all active users from Salesforce.com and creates an equivalent Lead Liaison user for each Salesforce.com user. For larger accounts, or accounts using items like "Profile Users", there might be tens of thousands of users. For this purpose, Lead Liaison provides the ability to sync only user with specific Salesforce.com User Profiles. Select which User Profiles you want to sync with. When the wizard initially loads all existing profiles are pulled in. If new profiles are added, click the "Refresh Profiles" button. Users with Salesforce.com profiles that no longer match User Profiles authorized to sync will get removed. 

• The only Salesforce.com standard field that Lead Liaison adds values to is the "Lead Source" field. By default, Lead Liaison's "Original Lead Source" field is mapped to Salesforce.com's "Lead Source" field. If you do not want Lead Liaison's Original Lead Source data to be integrated with the Lead Source field then uncheck the "Deploy Lead Liaison custom Lead Source values" checkbox. If you want to separate Salesforce.com's Lead Source and Lead Liaison's Original Lead Source values do the following:

  • Create a new SFDC Lead and Contact Custom field called "Lead Liaison Lead Source"

  • Create a new custom field in Lead Liaison called "SFDC Lead Source"

  • In Lead Liaison change the Lead and Contact field mappings:

    • Map the SFDC standard field "Lead Source" to the new custom field called "SFDC Lead Source" with bi-directional sync.

    • Map the new custom field in SFDC, "Lead Liaison Lead Source", to Lead Liaison's "Original Lead Source" field with one-way syncing from Lead Liaison to Salesforce.com.

• Click "Run Now" to import metadata required for setup.

• If the import ran successfully you'll see green check marks on the ensuing popup. Click the "Done" button to proceed.

• In Step 4 you can map your Lead, Contact and Account fields to Lead Liaison's Standard and/or Custom fields.

• A field mapping allows Salesforce.com and Lead Liaison to share data between the mapped fields.

• It's possible to pull in only a subset of your CRM data by using the "Sync Criteria" section at the top of each mapping page. Filtering which CRM data to bring into and sync with Lead Liaison is helpful if you're using Lead Liaison for specific products or your license is limited to a certain amount of prospects. In the example below, we're pulling in only Saleforce.com Leads in the Finance and Software industry who are also in Texas. 

• Checking the "Active" box allows data to be imported from Salesforce.com into Lead Liaison from the time the field is made Active, regardless if the field is mapped to a Lead Liaison field or not. 

• Instead of manually creating new custom fields in Lead Liaison the fields can automatically be created by checking the "Create New" box next to the field. 

• Once you've mapped fields for leads, contacts and accounts make sure to return to the CRM setup wizard by clicking the link at the top of each mapping page.

• Note, you'll see some new SFDC fields on the left-hand side such as the ones inside the red boxes below. These SFDC fields are not Lead Liaison custom or standard fields; however, they are internal Lead Liaison fields and mapped automatically in the background. You can optionally create Lead Liaison custom fields and map this information from SFDC to Lead Liaison for any purpose. 

• Proceed to Step 5 by clicking "Next" on the wizard.
  
  

• Click "Run Now" to securely import CRM data into your Lead Liaison instance. 

• Please be patient if you have lots of data/records. You'll see four (4) green check marks similar to the ones below if the data import was successful.

• Finally, verify your data import by viewing the data from within Lead Liaison. 

• Click the "Contacts", "Leads",and "Accounts" buttons to verify your records.

Once you are done, then your CRM configurations are complete and the bi-directional sync process between Salesforce.com and Lead Liaison will work automatically.

Salesforce.com Password Profiles

We recommend using your Administrator User for the sync account. Disable resetting of your password for your sync account by doing one of the following:

System Administrators can disable password expiration in two ways:

1. For all users:

Administration Setup | Security Controls | Password Policies

2. For User Profiles:

In each case, multiple users may be affected which is not recommended for security purposes. If a particular user needs to have password expiration disabled, a new profile specific for that user will need to be created:

1. Open the profile associated to the user that needs password expiration disabled.

2. Click on the 'Clone' button to create an identical profile to the user's current profile.

3. Once the new profile has been created, edit the profile and check the 'Password Never Expires' option under the Administrative Permissions section.

4. Save the profile.

5. Edit the user record and associate the user to the newly created profile. Trying to change your own user profile? This might help. 

In the end, the user will have the same profile as before except with the password expiration set to never expire.

Connecting Multiple Captello Accounts to a Single Salesforce Instance

You can connect multiple Captello accounts to the same http://Salesforce.com instance. When doing so, do not verify the plugin from the CRM integration wizard on more than one Captello instance. In other words, do not enable the toggle, as shown below, on more than one instance of Captello that is connected to your http://Salesforce.com account.

Enable Automatic Lead Creation (optional)

Lead Liaison offers the ability to automatically create a lead in Salesforce.com from visitors to your website that come from Connector (E-mail Marketing solution) or Send & Track (Microsoft Outlook Plug-in).

1. Login to Lead Liaison at https://app.leadliaison.com/login.php

2. Click Setup on the top right of the page.

3. Navigate to Account > Settings from the left side.

4. Turn on the switch next to "Auto-create CRM lead from email campaigns" and "Auto-create CRM lead from Send & Track emails" to enable automatic lead creation.

SFDC Custom Objects

The integration can include pushing Salesforce.com custom fields into Lead Liaison; however, does not include pushing Salesforce.com custom objects into Lead Liaison. As a workaround, the data from the Salesforce.com custom objects can be configured into a custom report and that report extract can then be imported into Lead Liaison.

Removing Fields 

Removing Custom SFDC Fields

Sometimes it's necessary to remove a custom field previously created in Salesforce.com. If a custom field is removed it will disrupt the synchronization process between Lead Liaison and Salesforce.com until one of the following two events occur, whichever occurs first. 

1. Automatically = Once at night during an automated process. 

2. Manually = By running Step 3 of the CRM Configuration Wizard. 

To avoid a disruption in service we suggest doing the following:

1. Delete custom field in SFDC and remove from SFDC lead/contact layout
2. Run Step 3 of the CRM Configuration Wizard (Import Metadata) immediately after deleting/remove custom field

Removing Lead Liaison Fields Under "Lead Liaison Marketing Data"

Any field in the Lead Liaison Marketing Data section can be renamed or removed. When removing a field in this section make sure to follow the same steps as mentioned above in the Removing Custom SFDC Fields section. Basically, run Step 3 of the CRM Configuration Wizard right away to avoid breaking the synchronization process. 

Removing the Lead Liaison Package

• First, remove all dependencies. Dependencies must be removed first before uninstalling. For example, assigning the Lead Liaison Lead Layout to a profile is a dependency. Change the layout profile to another profile or the standard profile first.

• Inside Salesforce.com go to 'Setup' > 'View Installed Packages'. If there are any dependencies removal will fail.

Alternative Ways to Add Lead Liaison's Sections to Lead/Contact Layouts

There are two additional ways to add Lead Liaison's sections to your Salesforce.com layout. 

1. Assign Lead Liaison's layout to your profiles

2. Automatically during the "Install Package" step of Lead Liaison's Configure CRM wizard (recommended for people using a standard Salesforce.com layout)

#1 Assigning Lead Liaison's layout to your profiles

To view the newly created Lead Liaison fields and sections assign the 'Lead Liaison Layout' to each profile which needs to see the data.

• Open the profiles page by going to 'Setup' > 'Administration Setup' > 'Manage Users' > 'Profiles'. In this example, we'll assign the Lead Liaison Layout to the Salesforce.com 'Standard Profile'.

• Click on the 'Standard User' link.

• Under the 'Page Layouts' section under 'Lead' click the 'View Assignment' link.

• Click the 'Edit Assignment' button.

• Next to "Page Layout To Use:" select 'Lead Liaison Lead Layout' and click 'Save'.

• Now you have successfully assigned the Lead Liaison layout to your profile.

• Repeat the same procedure for the Contacts section and assign the 'Lead Liaison Contact Layout' layout to the appropriate profiles.

#2 Automatically during the "Install Package" step of Lead Liaison's Configure CRM wizard

Go to the CRM configuration wizard:

• Click Settings > Integrations > CRM

Begin by selecting your CRM version. You can find your CRM version by hovering your mouse over your browser's tab.

In Step 2 of the CRM Wizard, simply turn in the switch in the "Plug-in" section at the bottom of your screen.