Skip to main content

​
Overview

The 4MINDS platform integrates with Gong, allowing you to import conversation intelligence data directly into your 4MINDS datasets. You can pull in call recordings, transcripts, user profiles, activity statistics, scorecards, keyword trackers, and CRM data — all converted into readable text files for analysis.

​
Getting Started

​
Prerequisites

  • A Gong account with API access enabled
  • Either a Gong API key pair (Access Key + Access Key Secret) or an OAuth-enabled Gong account
  • Appropriate Gong permissions for the data types you want to access (see Gong API Scopes below)

​
Connecting Your Gong Account

The Gong integration supports two authentication methods: API Token and OAuth.

​
Option A: API Token

  1. Navigate to Settings > Integrations in the 4MINDS platform.
  2. Find the Gong integration and click Connect.
  3. Select the API Token tab.
  4. Enter your Access Key and Access Key Secret.
    • To find these: log in to Gong, go to Company Settings > API, and create a new API key if you don’t have one.
  5. Click Test Connection to verify your credentials.
  6. Click Save Credentials to complete the setup.
Note: The Access Key Secret is only shown when creating a new API key in Gong. Store it securely — you cannot retrieve it later.

​
Option B: OAuth

  1. Navigate to Settings > Integrations in the 4MINDS platform.
  2. Find the Gong integration and click Connect.
  3. Select the OAuth tab.
  4. Click Connect with Gong. A popup window will open.
  5. Log in to your Gong account and authorize 4MINDS when prompted.
  6. The popup will close automatically once authorization is complete.
Note: OAuth uses secure OAuth 2.0 authentication. Your Gong password is never stored by 4MINDS. Access tokens are encrypted and refreshed automatically.

​
Disconnecting

To disconnect your Gong account, go to Settings > Integrations, find Gong, and click Disconnect. This removes your stored credentials and revokes access.

​
Available Data Types

Unlike file-based integrations, Gong provides data categories that are fetched from the Gong API and converted into readable text files. Each data type produces a .txt file with a descriptive header and structured records.
Data TypeDescriptionExample Output
CallsCall recordings and metadata — title, date, duration, direction, attendees, topics, and trackersgong_calls_20260409_120000.txt
TranscriptsFull call transcripts with timestamped speaker turnsgong_transcripts_20260409_120000.txt
UsersGong user profiles — name, email, title, role, and account statusgong_users_20260409_120000.txt
User StatsDaily user activity and interaction statisticsgong_user-stats_20260409_120000.txt
ScorecardsCall scoring and evaluation template definitionsgong_scorecards_20260409_120000.txt
Answered ScorecardsCompleted call scores and evaluationsgong_answered-scorecards_20260409_120000.txt
LibrariesSaved call libraries and snippet collectionsgong_libraries_20260409_120000.txt
TrackersKeyword and topic trackers being monitoredgong_trackers_20260409_120000.txt
CRM DealsDeal data synced from your CRM into Gonggong_crm-deals_20260409_120000.txt
CRM ContactsContact records synced from your CRM into Gonggong_crm-contacts_20260409_120000.txt
CRM AccountsAccount/company data synced from your CRM into Gonggong_crm-accounts_20260409_120000.txt

​
Import Limits

Each data type imports up to 100 records per request. For data types with pagination (calls, transcripts, users, etc.), the platform fetches multiple pages until reaching the limit.

​
Importing Data

​
Creating a Dataset with Gong Data

  1. Create a new dataset (or edit an existing one).
  2. Select Gong as a data source.
  3. The platform checks your Gong connection. If not connected, you will be prompted to set up the connection first.
  4. A list of all available data types is displayed with checkboxes.
  5. Use Select All to choose all data types, or select individual types.
  6. Click Add to stage the selected data types for import.
  7. The staged items appear in your attached files list with estimated file sizes.
  8. Complete the dataset creation to trigger the import.

​
Combining with Other Sources

Gong data can be combined with files from other sources in the same dataset. For example, you can import Gong call transcripts alongside Google Drive documents or uploaded files.

​
Dataset Sync

Once you have imported Gong data into a dataset, you can set up automatic syncing to keep your dataset up to date with the latest data from Gong.

​
How Sync Works

  • Each Gong data type is synced independently. For example, you can sync Calls and Transcripts without syncing Users.
  • On each sync cycle, the platform fetches the latest data from Gong, converts it to text, and updates the corresponding file in your dataset.
  • The text file is fully regenerated on each sync (not appended), so it always reflects the current state of your Gong data.

​
Sync Options

  • Sync specific data types: Choose which data types to keep in sync.
  • Sync all: Automatically sync all data types that were originally imported.

​
Configuring Sync

When creating a dataset with Gong data:
  1. Toggle Dataset Sync on before completing the dataset.
  2. Choose the sync frequency (e.g., daily, weekly).
  3. Optionally deselect specific data types from syncing.

​
Text File Format

Each imported file includes a descriptive header followed by structured records. Here is an example of a Calls import: 
Gong Calls Import — 5 calls
Imported: April 09, 2026 at 14:00 UTC

This file contains call recordings and metadata imported from the organization's Gong account.
Each call includes the title, date, duration, direction, attendees, topics, and trackers.
----------------------------------------

=== CALL ===
Title: Q2 Pipeline Review
Date: 2026-04-08 10:30:00 UTC
Duration: 45m 00s
Direction: Outbound
Attendees:
  - Alice Smith (Internal)
  - Bob Johnson (External)
Topics: Pricing, Timeline
Trackers: Competitor Mention

=== CALL ===
Title: Product Demo — Acme Corp
...

​
Gong API Scopes

Different data types require different API permission scopes in Gong. If your API key or OAuth token does not have the required scope, that data type will return a permission error and be skipped — other data types will still import successfully.
Data TypeRequired Gong Scope
Callsapi:calls:read:extensive
Transcriptsapi:calls:read:transcript
Usersapi:users:read
User Statsapi:stats:user-actions
Scorecardsapi:settings:scorecards:read
Answered Scorecardsapi:stats:scorecards
Librariesapi:library:read
Trackersapi:settings:trackers:read
CRM Deals / Contacts / Accountsapi:crm:read
Tip: If you see a “permission” error for a specific data type, check your Gong API key scopes in Gong > Company Settings > API and ensure the required scope is enabled.

​
Navigation & UI Features

​
Data Type Selection

When importing from Gong, each data type is displayed as a card with an icon, name, and description. Select data types using the checkboxes.

​
Select All / Deselect All

Use the Select All button at the top of the data type list to quickly select or deselect all types.

​
Size Estimation

When you add Gong data types to your dataset, the platform fetches a preview to estimate the file size. The estimated size is displayed in the attached files list.

​
Troubleshooting

IssueSolution
”No Gong connection found”Go to Settings > Integrations and connect your Gong account using API Token or OAuth.
Permission error for a data typeYour Gong API key may not have the required scope. Check Gong > Company Settings > API and enable the needed permissions. See the scopes table above.
401 Unauthorized errorYour credentials may have expired or been revoked. Disconnect and reconnect your Gong account.
No data returned for a data typeThe data type may be empty in your Gong account (e.g., no calls recorded, no CRM data synced).
User Stats returns no dataUser Stats requires a date range. The platform defaults to the last 30 days. If your account is new, there may be no activity data yet.
Connection expiredFor OAuth connections, the platform automatically refreshes tokens. If issues persist, disconnect and reconnect. For API Token connections, verify your key has not been revoked in Gong.
Popup blocked during OAuthEnable popups for the 4MINDS site in your browser settings, then try again.
Import takes a long timeSome data types (calls, transcripts) may take longer to fetch if your Gong account has many records. The import fetches up to 100 records per data type.

​
Security & Privacy

  • OAuth 2.0: OAuth connections use industry-standard OAuth 2.0. Your Gong credentials are never stored by 4MINDS.
  • Encrypted tokens: All access tokens and API key secrets are encrypted at rest.
  • Automatic token refresh: OAuth tokens are refreshed automatically before they expire, so you stay connected without re-authenticating.
  • Per-user access: Each user connects their own Gong account. Your Gong connection is not shared with other users on the platform.
  • Data conversion: Gong data is fetched in real time and converted to text files. Raw API responses are not stored — only the formatted text content is saved in your dataset.

​
FAQ

Q: What Gong data can I access? A: You can access any data type that your Gong API key or OAuth token has permissions for. See the data types table for the full list. Q: Can I import Gong data into an existing dataset? A: Yes. You can add Gong data to both new and existing datasets, and combine it with data from other sources. Q: How often does dataset sync run? A: Sync frequency depends on your dataset’s sync configuration. You can also trigger a manual sync at any time. Q: What happens to my data if I disconnect my Gong account? A: Previously imported data remains in your datasets. However, automatic syncing will stop, and you will not be able to import new data from Gong until you reconnect. Q: Can I choose which data types to sync? A: Yes. When setting up dataset sync, you can select or deselect individual data types. Only selected types will be refreshed on each sync cycle. Q: Are call audio recordings imported? A: No. The integration imports call metadata (title, duration, attendees, etc.) and transcripts as text. Audio files are not downloaded or stored. Q: How much data is imported per data type? A: Each data type imports up to 100 records. For calls and transcripts, this means the 100 most recent entries. For CRM data, up to 100 objects per type. Q: Can I connect multiple Gong accounts? A: Each user account on 4MINDS supports one Gong connection at a time. To switch accounts, disconnect the current one and connect with a different Gong account.