Who can do this?
Notes
Purpose: Configuring Salesloft for UserGems has two important benefits:
- It allows UserGems to push templated cadences directly into your Salesloft so you don’t need to build cadences and messaging from scratch
- It allows UserGems to automatically add Contacts directly to the right cadence to reduce the manual work for your reps
Steps:
1. Connect Admin Salesloft User
→ this will give UserGems the API access we need to create cadences and add records to cadences
2. Map 'UG - Past Company'
-> pull in the contact’s past company to Salesloft automatically
- Click your initials or photo in the top right -> click "Settings" → click “Field Configuration” → click “+ Create Custom Field"
- Map the following for contacts, leads, or both (depending on what you’re using)
- Salesloft field name: UG - Past Company
- Field type: Text
- Check the “Map to CRM” contact and/or lead check-box depending on your setup
- CRM Contact/Lead Field Name, search and select “UG - Past Company”
- Direction = Salesloft ← CRM
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772ed6a66ef328ef2a457ae_6772ed2b79b5e782a06782f6_salesloft-past-company.gif)
3. Ensure Salesforce & Salesloft Sync is Configured
→ this ensures UserGems contacts/leads will be synced to Salesloft
- Click your initials or photo in the top right -> click “Settings” → click “CRM Sync” → on the “settings” page make sure the “Linking People” section is set to pull in leads/contacts
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772ef2297167b0480371578_6772ee6cad0a2ba9fb5ad805_Screenshot%25202024-12-30%2520at%25202.00.44%25E2%2580%25AFPM.png)
Click the “Sync Management” tab at the top of the page → make sure data is enabled to sync bi-directionally between Salesloft and Salesforce.
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772ef2297167b0480371573_6772eeec5a6344d941de52f6_Screenshot%25202024-12-30%2520at%25202.04.28%25E2%2580%25AFPM.png)
Create an automation to add UserGems contacts in Salesforce to Salesloft. Salesloft doesn’t sync all contacts by default.
Select “Settings” → click "Automation Rules” → click “Create New Rules” then:
- Name = “Create UserGems Person”
- Trigger Category = CRM Data Sync
- Trigger = "When a contact is not found in Salesloft"
- Criteria = UG - Past Company = is not null
- Action = Create Person
- Toggle on "Enable Rule after saving"
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772f9bdde84bc1129ef0524_6772f8e2c06a6a1c68a39126_create-ug-person.gif)
If adding UserGems Leads in addition to Contacts, repeat the steps above to create a separate automation rule with the Trigger = "When a lead is not found in Salesloft" (screenshot below) - this should be ordered AFTER the "create person" from Contact automation
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772f9bdde84bc1129ef051c_6772f940c06a6a1c68a3fb10_Screenshot%25202024-12-30%2520at%25202.48.50%25E2%2580%25AFPM.png)
Some additional notes on these automations:
- Since automations run in order from top down, we recommend positioning these "Create person" automations at the top of your automation list to ensure that unintended automations don't override them
- Click "View Rule Logs" in Automation Rules to identify why automation rules failed to run
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772f9bdde84bc1129ef051f_6772f9b6e0d6f98bc38f8a1a_Screenshot%25202024-12-30%2520at%25202.50.24%25E2%2580%25AFPM.png)
4. Add the custom variable “UG - Past Company” to your UserGems cadences
→ this way reps don’t need to manually find the past company and type it in
- Search your UserGems cadences → for each email step, click in and see if there are any prompts [[! replace with customer variable past company]] → delete → click the add “{}” variables button → search and select “UG - Past Company” → repeat for all email steps in UserGems cadences
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6772fdf8dba4276561134355_6772fde65a7d15a92d518b15_Screenshot%25202024-12-30%2520at%25203.08.39%25E2%2580%25AFPM.png)
Troubleshooting
- Picklist configuration: picklist values must match exactly between Salesforce and Salesloft for records to be created
- Under "Settings" -> "Field Configuration" -> we'll use the example of the "Account Type" field but this applies to any picklist -> click the Dropdown arrow next to it -> click "Edit Field"
- Make sure that the Active Picklist Options exactly match the ones coming from Salesforce; mismatches here can prevent a lead or contact record from being created
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6773045fae0ac73509ed3616_677304350db2c28cb4c62de2_Screenshot%25202024-12-30%2520at%25203.33.10%25E2%2580%25AFPM.png)
- If you need to debug:
- Navigate to "Settings" -> Click "CRM Sync" -> click "Sync Management" -> under "CRM Sync log" click "View Logs". Check Status: Failed
- Automation Rules has a “View Rule Logs”. Check Status: Failed
- The individual Automation Rule has a “View Logs” (need to edit the rule to view)
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/677300b8fddc1666bab147be_67730072a56767da386ad2b8_Screenshot%25202024-12-30%2520at%25203.19.39%25E2%2580%25AFPM.png)