Documentation Index
Fetch the complete documentation index at: https://docs.4minds.ai/llms.txt
Use this file to discover all available pages before exploring further.
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
- Open Integrations from the main navigation bar in 4MINDS.
- Find the Gong integration and click Connect.
- Select the API Token tab.
- 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.
- Click Test Connection to verify your credentials.
- 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
- Open Integrations from the main navigation bar in 4MINDS.
- Find the Gong integration and click Connect.
- Select the OAuth tab.
- Click Connect with Gong. A popup window will open.
- Log in to your Gong account and authorize 4MINDS when prompted.
- 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, open Integrations from the main navigation bar, 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 Type | Description | Example Output |
|---|
| Calls | Call recordings and metadata — title, date, duration, direction, attendees, topics, and trackers | gong_calls_20260409_120000.txt |
| Transcripts | Full call transcripts with timestamped speaker turns | gong_transcripts_20260409_120000.txt |
| Users | Gong user profiles — name, email, title, role, and account status | gong_users_20260409_120000.txt |
| User Stats | Daily user activity and interaction statistics | gong_user-stats_20260409_120000.txt |
| Scorecards | Call scoring and evaluation template definitions | gong_scorecards_20260409_120000.txt |
| Answered Scorecards | Completed call scores and evaluations | gong_answered-scorecards_20260409_120000.txt |
| Libraries | Saved call libraries and snippet collections | gong_libraries_20260409_120000.txt |
| Trackers | Keyword and topic trackers being monitored | gong_trackers_20260409_120000.txt |
| CRM Deals | Deal data synced from your CRM into Gong | gong_crm-deals_20260409_120000.txt |
| CRM Contacts | Contact records synced from your CRM into Gong | gong_crm-contacts_20260409_120000.txt |
| CRM Accounts | Account/company data synced from your CRM into Gong | gong_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
- Create a new dataset (or edit an existing one).
- Select Gong as a data source.
- The platform checks your Gong connection. If not connected, you will be prompted to set up the connection first.
- A list of all available data types is displayed with checkboxes.
- Use Select All to choose all data types, or select individual types.
- Click Add to stage the selected data types for import.
- The staged items appear in your attached files list with estimated file sizes.
- 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:
- Toggle Dataset Sync on before completing the dataset.
- Choose the sync frequency (e.g., daily, weekly).
- 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 Type | Required Gong Scope |
|---|
| Calls | api:calls:read:extensive |
| Transcripts | api:calls:read:transcript |
| Users | api:users:read |
| User Stats | api:stats:user-actions |
| Scorecards | api:settings:scorecards:read |
| Answered Scorecards | api:stats:scorecards |
| Libraries | api:library:read |
| Trackers | api:settings:trackers:read |
| CRM Deals / Contacts / Accounts | api: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
| Issue | Solution |
|---|
| ”No Gong connection found” | Open Integrations from the main nav and connect your Gong account using API Token or OAuth. |
| Permission error for a data type | Your 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 error | Your credentials may have expired or been revoked. Disconnect and reconnect your Gong account. |
| No data returned for a data type | The data type may be empty in your Gong account (e.g., no calls recorded, no CRM data synced). |
| User Stats returns no data | User 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 expired | For 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 OAuth | Enable popups for the 4MINDS site in your browser settings, then try again. |
| Import takes a long time | Some 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.
