Skip to main content

Gong Integration - Setup Guide

Connect your Gong account to Goodweek to access call recordings, transcripts, and conversation intelligence data directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Gong account to Goodweek to access call recordings, transcripts, and conversation intelligence data directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Gong, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Gong integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

⚠️ Gong Technical Admin required — this step cannot be skipped

Unlike most integrations, Gong requires a Gong Technical Admin to complete the OAuth connection. This is a mandatory requirement enforced by Gong, not by Goodweek. Regular users and even Business Admins cannot authorize the connection — only a Technical Admin can. If a non-Technical Admin attempts to connect, they will see an "Insufficient permissions" error.

Gong handles OAuth at the organization level, meaning one authorized connection provides access to data across users and teams in your organization. A Gong Technical Admin must complete the following steps:

  1. Log in to Gong with a Technical Admin account.

  2. In Goodweek, go to Integrations and find Gong.

  3. Click Connect. You will be redirected to Gong's OAuth consent screen.

  4. In Gong, open the sidebar and click Admin centre at the bottom of the navigation menu. Note: Admin centre is only visible to users with Technical Admin permissions.

  5. Review the OAuth app registration and the requested scopes.

  6. Approve the connection from Admin centre → Ecosystem.

  7. Return to Goodweek and complete the authorization flow by clicking Allow.

Who is a Gong Technical Admin?

A Technical Admin in Gong is a specific role distinct from Business Admin or regular user roles. If you are unsure who the Technical Admin is, go to Gong → Admin centre → Users and look for users with the Technical Admin role.

User Connection

Because Gong authorizes at the organization level, the connection is completed by the Technical Admin on behalf of the organization. Individual users do not need to complete a separate connection flow.

Important Notes

  • Only a Gong Technical Admin can authorize this integration. Business Admins and regular users will receive an "Insufficient permissions" error.

  • Gong's OAuth is organization-level, not per-user. The authorized connection provides access to data within the approved scopes across your organization.

  • You can revoke Goodweek's access from Gong → Admin centre → Ecosystem → Connected apps.


Available Tools

Tool

Description

Type

Get Call By ID

Retrieves detailed metadata for a specific Gong call by its ID.

Read

Get Call Transcript

Retrieves the full transcript of a Gong call including speaker information, timestamps, and topic categories.

Read

Retrieve Call Data by Date Range

Lists calls that took place within a specified date range.

Read

Retrieve Filtered Call Details

Lists detailed call data filtered by date range, specific call IDs, or hosting user.

Read

List Folder Calls

Retrieves a list of calls within a specific Gong folder.

Read

Aggregate User Activity Statistics

Lists the aggregated activity of multiple users within Gong for a defined period.

Read

Aggregate Activity by Period

Lists aggregated user activity across time periods within a defined date range.

Read

Get Interaction Statistics

Retrieves interaction trend statistics for users based on calls with Whisper enabled.

Read

List Scorecards

Lists all scorecard configurations and their associated assessment questions in Gong.

Read

Retrieve Activity Scorecards Report

Retrieves all scorecard answers reviewed during a specified date range for calls in a given period.

Write

List Call Outcomes

Lists all call outcome configurations defined in Gong, including categories and sequences.

Read

List All Users

Lists all users in the Gong organization.

Read

Get User By ID

Retrieves individual user details by user ID including profile data and settings.

Read

List Gong Engage Flows

Lists all Engage flows available in the organization with their visibility types.

Read

List Tasks

Retrieves Engage tasks assigned to a specific user with filtering options.

Read

Assign Prospects to Flow

Assigns a list of CRM prospects to a specific Gong Engage flow.

Read

Retrieve Tracker Details

Retrieves details of all keyword trackers in the system or a specific workspace.

Read

List All Workspaces

Lists all Gong workspaces including their details.

Read

Retrieve Library Folders

Lists public library folders in Gong.

Read

Add Call Media

Adds a call recording from an external telephony system or media facility to Gong.

Write

Create a Gong Meeting

Creates a new Gong meeting.

Write

Update a Gong Meeting

Updates an existing Gong meeting by its ID.

Write

Erase Data for Email Address

Erases all data associated with an email address from Gong for GDPR compliance. This action is permanent.

Read

Delete Meeting

Deletes a Gong meeting created via the Meetings API.

⚠️ Destructive

Use Cases

  • Retrieve and review call transcripts. Pull the transcript of any Gong call by ID or date range directly in Goodweek to review what was said, extract key points, or surface specific moments from a conversation.

  • Analyse team call activity. Retrieve aggregated activity statistics for your sales team or individual reps across a time period to understand call volume, engagement, and interaction patterns.

  • Review scorecard results for calls. Access the scorecard answers for calls reviewed during a given period to evaluate call quality and coaching outcomes across the team.

  • Manage Engage tasks and flows. List tasks assigned to reps, check the status of Engage flows, and assign prospects to specific sequences directly from Goodweek.


Troubleshooting

"Insufficient permissions" error when connecting

The account attempting the connection does not have the Gong Technical Admin role. Only a Technical Admin can authorize this integration. Ask your Gong Technical Admin to complete the connection.

I don't know who the Gong Technical Admin is

Go to Gong → Admin centre → Users and look for users with the Technical Admin role. If you do not have access to Admin centre, ask your workspace admin or contact Gong Support.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Gong integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?