Introduction & Background
Thank you for your interest in UserGems! This guide will take you through the configuration of UserGems New Hires & Promotions signal, which automatically adds missing key new hires and promotions to your CRM.
You will be partnered with a dedicated Customer Success Manager for the duration of your contract. You can expect a smooth and fully supported onboarding experience where we will cover everything in the guide below and more, including:
- Connecting a UserGems Integration User
- Adding Key Account Reports
- Configuring Personas
- Salesforce Settings
- Testing & QA
- Full team training run by UserGems (or we can train-the-trainer)
- Go-live & ongoing program management
Step 1 - Determine Your Salesforce Integration Strategy
- If you are an existing Customer using Champion Job Change tracking, you are likely already connected to UserGems with an integration user and can skip to Step 2
- If you are not utilizing the Champion Job Change signal yet, then your CSM will provide you with a signup link that you can use to connect your Salesforce Integration user to UserGems. UserGems will need read access to your Users, Leads/Contacts, Accounts, Opportunities, & Reports as well as write access to the Lead/Contact fields that you would like to set for the records that we deliver.
Step 2 - Configure Key Account Reports & Personas
Create Salesforce Reports of Key Accounts
- Columns needed: AccountId, Account Name, Website
- Ensure that report is saved in a folder the integration user has access to (cannot be in any user’s private folder)
Upload Key Account Reports to relevant Categories in the UserGems Web App
- Provide Report Id
- Configure Report Settings
- Map AccountId, Account Name, and Website to the related UserGems headers
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/65e9d34ca633faff3cbc505c_OTXWEzZRD5p5A0XS4D3p_HdLx48gQkwb0s0fGOtoTRjz27abN2QjV3Zlvg4cjO4HeisBq_zDumerLf_CC5MQ_pheMQuFhZK56UIWW4U4HHlAHhdvdhs60EQJDcbvn-vP2Mu9O-HzkJZT2w-pPK1Bc9o.png)
Configure Persona(s) in UserGems and map them to Key Account Reports (more here on configuring Personas)
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/65e9d5eb90a937beea453597_Screenshot%202024-03-07%20at%207.57.30%E2%80%AFAM.png)
For each account list, admins configure refresh intervals, limits, and default ownership for new leads/contacts(generally assign to account owner)
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/65e9d7e366c99780cd3d5f22_Screenshot%202024-03-07%20at%208.05.57%E2%80%AFAM.png)
Step 3 - Configure Salesforce Mappings
Decide how records are created and which fields are updated when UserGems surfaces a new persona-matching contact to a key account.
Navigation: Account Tracking -> Settings -> Salesforce -> "Add new configuration"
![](https://cdn.prod.website-files.com/621ffb9987a4890ced10ab9b/65e9d34c644ed9444734d3d3_rG8Lx8zcJfj3niGKVYy0RR8dUKqBi4zwlA97dDsY7RkBEVRj0XiWzXbwRTapfp204avrIjj4Mm51wGeYvLLME2jcfPXJYkKrcMm2B_XYMHXkbrD8dZ5bTk6djrEhUeCk_gTk0P7FJkygEOU8npVeJlw.png)
Step 4 - Decide Your Rep Handoff Strategy and Create Workflows
Out of the box, we will generally assign new hires & promotion contacts to the existing account owner. However, admins can also optionally build powerful workflows directly in the UserGems web app for these contacts to help with things like:
- Advanced/situational routing
- Field updates
- Email and/or Slack notifications
- Auto-sequencing to Salesloft or Outreach