Creating an extended integration for Gong users

Let Oomnitza be your single source of truth!

You'll get complete visibility of your users as data from Gong is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Gong in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key user information
• Configurable reports to share information about users with your colleagues and management

Navigation

Add OAuth 2.0 credentials

Create the user integration

Before you start

To stream Gong user data into Oomnitza, you must add Gong credentials to the credentials vault in Oomnitza.

You can use one of the following types of authentication to connect Gong to Oomnitza:

• Basic authentication. You'll need your Gong username and password. 
• OAuth 2.0. You must contact Gong Support to enable OAuth 2.0 for your account and you'll need your Gong client ID and your Gong secret.  

Best practice
Use OAuth 2.0 to authenticate with Oomnitza.

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and Gong, complete these steps:

1. Log into Oomnitza.
2. Click Settings > Credentials, and then click Add new credential (+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. Choose one of the following types of authorization:

OAuth 2.0	Basic Auth
Select GongGong OAuth 2.0 from the SaaS list. Enter you client ID and secret. Authenticate the connection. Click CREATE.	Enter your username. Enter your password. Click SAVE.

Next

You use the credentials that you added to create and customize your Gong integrations with Oomnitza.

Create the user integration

Info and connect details

1. 1. 1. From the menu, click Settings.
      2. On the Integrations page, scroll down to the Extended section for User Integrations.
      3. Click NEW INTEGRATION.
      4. In the New User Integration sidebar, click Gong.
      5. To integrate Oomnitza with Gong, choose one of the following options:
         • Gong User Load to use basic authentication credentials.
         • Gong User Load OAuth 2.0 to use OAuth 2.0 credentials.  
      6. Click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from Gong to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

1. Enter a descriptive name for the integration such as Gong Users. That'll be the name of the user integration that is shown on the Integrations page.
2. From the User Selection list, select User plus SaaS User.
3. From the installation type list, select Cloud.
4. From the Credentials list, select the credentials for Gong.
5. From the Integration Preferences list, select Update only.   
6. Enter the name of the user of the integration.
7. Click Next.

Mappings

Map the Gong fields to Oomnitza fields and create custom mappings to get the user information that you need.

Complete these actions:

1. Click SMART MAPPINGS.
2. Crate custom mappings to map the Gong fields that you want to add to Oomnitza:
   1. Click the down arrow on the field that you want to map.
   2. Select Add new Oomnitza users field.
   3. Change the name of the field. For example, you can change the name of the Title field to Gong Title.
   4. Click CREATE. 
3. Assign an Oomnitza role to the users such as Employee.
4. Assign a sync key to one of the fields such as the Email field.
5. Click NEXT.   

Custom Gong to Oomnitza mappings

The following Gong fields can be mapped to Oomnitza:

• Active
• Connector Sync Time
• Email
• First Name
• Last Name
• Phone Number
• Title
• User Id

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the Gong to Oomnitza fields, click NEXT.

Schedule

By default, Gong user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets and software
• Configure custom reports about your assets and software

 Getting started