Who can do this?
Notes
UserGems x Salesloft Configuration
Purpose: Configuring Salesloft or UserGems has two important benefits:
- It allows UserGems to push templated cadences directly to your Salesloft so you don’t need to build messaging from scratch
- It allows, if preferred, for UserGems to automatically add job change records directly to the right cadence
Steps:
1. Connect Admin Salesloft User
→ this gives UserGems the API access needed to create cadences and add records to cadences
2. Map “UG - Past Company” field to Salesforce
-> pull in the contact’s past company to Salesloft automatically
- Click settings → click “field configuration” → click “+ create custom field”.
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/655bd1cb6d0bf83ab8d6e7c4_YbC38JfBn5VA73SIc0uMB4F1nGxUYODcBfAwh0NvO4hKjf3UNAC1AYguxzWX-ny1HwBTRVhjKaE7VHKlCQYJe9ZgFtPYPdn-cxoXGPWF7IJuW04BIFDFufG8W2NkJTjllPguG2yszhalZJWtbtyeWg4.png)
- 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/lead check-box
- CRM Contact/Lead Field Name, search and select “UG - Past Company”
- Direction = Salesloft ← CRM (screenshot below)
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/655bd1cbf0277d13b3f7d3b9_oHFeXK-Ur4emWlId09VMvf6qfzNK__z0RJGAsSu2Is2cHpaULlz1izupDiEEoOdi4erDslwF1zct7ZS7jSzz_1ay9lvjbakR3F0dwck8c5eOb1jkXL2O-FTB2O6dPtoBR1nMeDVZnQxp-NkYawerzoU.png)
3. Ensure Salesforce & Salesloft Sync is Configured
→ this ensures UserGems contacts/leads will be synced to Salesloft
Click the drop down with your name 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/655bd1cb2fa112ff5138b8b7_bh8CUF-VVh5k6HKz_08YkJfNlNFSeTsNq97uAaN5nVUm2-tFM_lV5ORATeTkREYvN3hGljzDBwzRN-BDxUZym02uCwHDrCgjns-AG9-bG2GSb9MZmpk-ajOqGsntvaF2cKHRBig_jTgkr8O5vLTp4Uc.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/655bd1cb3876d8da82bc4f5d_CfD-p4fVdHS1Y2uS5SnZFcLcsOHQLBF9bBOnDOVtUWgKsvppCFzS6P6iw_wCVLwv7gmp2BIyILgo3nMoENF9gb2MsopFWLVCcRSo8wMXJElug_CilXqh0EPpD-_qnqd8GLdTE8AI0ntyPMzAvd7glXs.png)
Make sure there is an automation to add UserGems contacts in Salesforce to Salesloft. Salesloft doesn’t sync all contacts by default. Select “settings” → select “automation rules” → select “create new rules”
- 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
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" - this should be ordered AFTER the "create person" from Contact automation
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/65b92fcaabcfde9a4b753ab8_Settings___Salesloft.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 - this ensures that unintended automations don't override them.
- The View Logs in Automation Rules can also be used to identify why automation rules failed to run.
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/6622df4a527dac8b445faa0c_Screenshot%202024-04-19%20at%203.16.37%E2%80%AFPM.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/655bd1cbcd3a41265bf7c3d4__VSvGK7RDHel90eFGblNXRxILg4jhX47Ma59I-w3jHZqrXGeVijT0dkmGbWBLmrHeT8mxMfvGzLOduYN21F3DVRMLRhu7uAFNjDnUrMNCmCaK6hpGxMxoQNa1LN23sgEjnZ0o-eKHGDyAIyXQnHkvZ4.png)
Troubleshooting
- Picklist configuration:
- Field Configuration -> Person Stage -> editsome text
- If the picklist values are different than the ones coming from Salesforce, it could prevent a record from getting created
- Field Configuration -> Person Stage -> editsome text
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/66423531692c994a04cf7a2c_Screenshot%202024-05-13%20at%209.43.30%E2%80%AFAM.png)
- If you need to debug:
- CRM Sync -> Sync Management -> 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)