Implementation
  • 15 Sep 2023
  • 7 Minutes to read
  • Dark
    Light

Implementation

  • Dark
    Light

Article Summary

Access to G2 CRM Connector for Salesforce must first be provisioned by your G2 representative. If you have not yet discussed G2 CRM Connector with your G2 representative, please contact them before proceeding.

This page details every step you need to take to implement G2 CRM Connector for Salesforce.

Before getting started

The full implementation process should be completed by your organization's Salesforce admin. During the implementation process, you will:

  1. Install the G2 managed package to create the custom objects in your Salesforce environment.
  2. Create a dedicated Integration User account, which will be used to authenticate G2's access to your Salesforce environment.
  3. Configure G2 CRM Connector for your Salesforce environment.
  4. Assign G2 licenses and permission sets to your Salesforce users.

Before proceeding with the following steps, make sure that you’ve received the following information from your G2 representative:

  • The G2 managed package installation URL(s)

Refer to the Installation URLs for G2's managed package section for more information.

  • Your API connection URL
  • A Read / Write API token and a Read Only API token

To implement this integration, your Salesforce user account must have a System Administrator profile.

In the Salesforce User tab, a user must have the User License field set to Salesforce and the Profile field set to System Administrator.

Implementation instructions are for Salesforce Lightning. To switch from Classic to Lightning, select Switch to Lightning Experience from the header of any Salesforce page.

salesforce classic or lightning

1. Install the managed package

G2 CRM Connector is implemented via a Salesforce managed package, which allows G2 to push updates as new features are released.

Installation URLs for G2's managed package

You might opt to demo the implementation process in a Salesforce sandbox before installing in production. G2 offers a unique managed package for both sandbox and production Salesforce environments.

Production

https://login.salesforce.com/packaging/installPackage.apexp?p0=04t4o000001smNS

Sandbox

https://test.salesforce.com/packaging/installPackage.apexp?p0=04t4o000001smNS

install salesforce package for all users

To install the managed package:

  1. In a private browser window, navigate to the managed package installation URL appropriate for your Salesforce environment, then log in to Salesforce using your admin credentials when prompted.
  2. Choose an installation option, then select Install. G2 recommends installing the managed package for All Users.

Selecting Install for Specific Profiles enables you to assign either No Access or Full Access permission sets according to specific Salesforce profiles, such as Marketing or Sales roles, across an organization.

install salesforce package for specific users

You should only use this if you are an experienced Salesforce admin. For more information on permission sets for the G2 CRM Connector for Salesforce, refer to step 7.

  1. Grant G2 access to your Salesforce environment by selecting the Yes, grant access to these third-party web sites checkbox, then select Continue to begin installing G2's custom objects.

Depending on your Salesforce environment, the installation process can take up to one hour. You will receive an email notification when the managed package installation is complete.

2. Create a dedicated Integration User and assign a G2 license

G2 strongly recommends using a dedicated Integration User profile to authenticate G2's access to your Salesforce environment.

While it’s possible to connect an existing user account to this integration, creating a dedicated Integration User makes it easier to troubleshoot Salesforce issues and ensures that you won’t experience any interruptions in data flow when a user leaves your organization.

For more information, refer to Salesforce's The Value of Having A Dedicated Salesforce Integration User blog post.

To create a dedicated Integration User:

  1. In the top-right corner of any any Salesforce page, select the Setup icon, then select Setup.
  2. From the left sidebar, search for and select Users to access the All Users page.

create new user panel salesforce

  1. Select New User, then enter a Last Name, Alias, Email, Username, and Nickname for your Integration User.

Make sure that your team can access the email you associate with the Integration User. In the following example, we created an Integration User with the email address of sysadmins@g2.com.

All other fields listed in step 3 do not impact this integration.

enter basic user information salesforce

  1. Assign a User License of Salesforce, and a Profile of Standard User.

assign salesforce user license

  1. Select Save to create your Integration User.

To assign a G2 license to the Integration User:

  1. From the left sidebar, search for and select Installed Packages.
  2. Find the G2 CRM Connector package, then select Manage Licenses.

access installed packages

  1. From the Licensed Users panel, select Add Users, choose your Integration User, then select Add.

assign g2 license

After assigning a G2 license, log in to the email you associated with the Integration User to access the Salesforce welcome email, then follow the prompts to set a password for your Integration User.

assign g2 license

3. Authenticate G2's access to Salesforce

G2's access to update the custom objects in your Salesforce environment is authenticated by connecting the Integration User you created in the step 2.

You will use the API connection URL provided by your G2 representative in this step.

Your API connection URL should follow the format https://my.g2.com/salesforce_app_configurations/{product id}.

connect integration user to g2 api

To connect G2 CRM Connector to your Salesforce environment:

  1. In a new private browser window, open the API connection URL link provided by your G2 representative.
  2. Select Connect to Salesforce or Connect to Salesforce Sandbox depending on your Salesforce environment, then log in using the credentials for your Integration User.

If your Salesforce environment uses a custom domain, you might be required to enter it before logging in.

login with custom domain

Your custom domain precedes my.salesforce.com in the URL for your Salesforce environment. For example, in the following URL:

https://empathetic-wolf-178aau-dev-ed.trailblaze.my.salesforce.com/

The custom domain is empathetic-wolf-178aau-dev-ed.trailblaze.

  1. Verify that the email associated with your Integration User appears within the prompt, then select Allow to complete the user authentication process. If successful, you will be returned to the API connection URL landing page and no error messages will be displayed.

If the Allow Access? prompt displays your Salesforce admin email instead of the Integration User email, try logging out of Salesforce, opening a new private browser window, then repeating steps 1-3.

4. Run the Configuration Assistant

The G2 Configuration Assistant helps verify several critical steps to ensure the implementation process is successful, including:

  • Verifying the Integration User has been authenticated
  • Assigning an integration license and G2 permission set to the Integration User
  • Validating your organization’s API tokens

The Configuration Assistant can only be run by a Salesforce admin with the G2 Full Access permission set. If you cannot access the Configuration Assistant, refer to the Assign G2 permission set section for more information.

To run the Configuration Assistant:

  1. In a private browser window, log in to your Salesforce environment using your personal Salesforce admin credentials.
  2. From the App Launcher, search for and select G2 Config Assistant. If you successfully completed the previous implementation steps, you will be brought to the Permission Set Assignment tab.

If you were brought to a different tab, follow the troubleshooting instructions in the Configuration Assistant.

  1. Select Assign Automatically to assign the G2 Full Access permission set to your Integration User.

assign permissions to integration user

  1. From the API Tokens Validated tab, enter the Read / Write and Read Only API tokens provided by your G2 representative into the corresponding fields, then select Continue to complete the implementation process.

enter api keys

If you encounter issues at any step in the Configuration Assistant, select Contact G2 Support and describe your issue. G2's Support team will contact you for further assistance.

Post-implementation management

In order for a member of your organization to access G2 data in Salesforce, they need to be assigned both a G2 CRM Connector license and a G2 permission set.

You must be a Salesforce admin to assign licenses and permission sets.

Assigning G2 licenses

G2 CRM Connector includes 5,000 licenses by default. If your organization requires more licenses, please contact G2 Support for assistance.

To assign licenses to Salesforce users:

  1. In the top-right corner of any any Salesforce page, select the Setup icon, then select Setup.
  2. From the left sidebar, search for and select Installed Packages.
  3. Find the G2 CRM Connector package, then select Manage Licenses.
  4. From the Licensed Users panel, select Add Users, select the checkbox for each user you want to assign a license, then select Add.

You can check the number of licenses in use from the Installed Packages page.

check used licenses

Assigning G2 permission sets

G2 offers several permission sets to help you provide the correct access level to G2 data for different roles in your organization.

G2 permission setAccess level
G2 Full AccessComplete access to G2 CRM Connector.
G2 Read Only
  • View G2 data within Salesforce reports and custom objects, including the Visualforce page that is installed with the G2 managed package.
  • Create personal folders in the G2 Folders tab.
  • Read-only access to shared folders and Reference Pages.
  • G2 Buyer IntentG2 Read Only access, plus access to the G2 Buyer Intent tab.
    G2 Reference BuilderG2 Read Only access, plus access to the G2 Reference Builder tab.
    G2 Shared FoldersG2 Read Only access, plus the ability to create shared folders in the G2 Folders tab.

    To assign G2 permission sets to Salesforce users:

    1. In the top-right corner of any any Salesforce page, select the Setup icon, then select Setup.
    2. From the left sidebar, search for and select Permission Sets.
    3. Search for and select the G2 permission set you want to assign, then select Manage Assignments.
    4. Select Add Assignments, then select the checkbox for each user you want to add.
    5. Select Next, then select Assign to complete the permission set assignment.