HomeSign In

Gong

Integrate with Gong to retrieve call data, transcripts, and manage call records in your workflows

The Gong Integration allows you to access call recordings, transcripts, and call metadata from your Gong workspace. Use this integration to analyze sales conversations, extract insights from call data, and automate workflows based on call information.

Gong captures and analyzes sales conversations across your team. By connecting Gong to AirOps, you can build workflows that leverage call transcripts for content creation, extract key insights from conversations, analyze call performance, and integrate call data with other business systems.

Configuring the Gong Integration

Authentication

To connect your Gong account to AirOps:

  1. In your AirOps workspace, navigate to Account → Integrations → Add New → Gong

  2. You will be prompted to sign in to Gong

  3. Make sure you have access to sign in and connect your Gong account to AirOps

Once connected, you can select your Gong account when configuring Gong steps in your workflows. You can also create multiple Gong connections if you need to access different Gong workspaces.

Note: The Gong integration is at the user level. This means that while any user can add the Gong integration to your AirOps workspace, the data you can retrieve will be limited to that user's access permissions in the Gong workspace.

For example, if the user who added the integration to AirOps has limited access in the Gong workspace, the data retrieved via the Gong step in AirOps will also be limited accordingly.

Available Actions

The Gong integration provides four main actions for working with call data:

  1. Retrieve Transcripts of Calls

  2. List Calls

  3. Get Extensive Data

  4. Add New Call

Retrieve Transcripts Of Calls

Retrieve transcripts of calls for analysis and processing.

Required Parameters

None - all parameters are optional for this action.

Optional Parameters

From Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) from which to list recorded calls

  • Returns calls that started on or after the specified date and time

  • If not provided, list starts with earliest call

To Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) until which to list recorded calls

  • Returns calls that started up to but excluding specified date and time

  • If not provided, list ends with most recent call

Workspace ID

  • The ID of the workspace

  • Optional identifier to filter calls by workspace

Call IDs

  • List of call IDs to be filtered

  • If not supplied, returns all calls between From Date Time and To Date Time

Return Simplified Transcript

  • Toggle option (true/false)

  • If true, returns a simplified version of the transcript with normalized speaker IDs and formatted timestamps

List Calls

List calls from your Gong workspace with optional filtering.

Required Parameters

None - all parameters are optional for this action.

Optional Parameters

From Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) from which to list recorded calls

  • Returns calls that started on or after the specified date and time

  • If not provided, list starts with earliest call

To Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) until which to list recorded calls

  • Returns calls that started up to but excluding specified date and time

  • If not provided, list ends with most recent call

Cursor

  • The cursor to start from

  • This is returned by the previous step for pagination

Get Extensive Data

Lists detailed call data including context, parties, comments, and media.

Required Parameters

None - all parameters are optional for this action.

Optional Parameters

From Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) from which to list recorded calls

  • Returns calls that started on or after the specified date and time

  • If not provided, list starts with earliest call

To Date Time

  • Date and time (in ISO-8601 format: 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC) until which to list recorded calls

  • Returns calls that started up to but excluding specified date and time

  • If not provided, list ends with most recent call

Workspace ID

  • The ID of the workspace

  • Optional identifier to filter calls by workspace

Call IDs

  • List of call IDs to be filtered

  • If not supplied, returns all calls between From Date Time and To Date Time

Primary User IDs

  • List of user identifiers

  • If supplied, the API will return only the calls hosted by the specified users

  • The identifiers in this field match the primaryUserId field of the calls

Max Results

  • The maximum number or results to return

  • Use this to limit the response size

Context

  • Dropdown selection: Basic or Extended

  • If 'Basic', add links to external systems (context objects) such as CRM, Telephony System, Case Management

  • If 'Extended', include also data (context fields) for these links

Context Timing

  • Comma separated values: Now, TimeOfCall

  • Allowed values that can be selected together

  • Timing for the context data

  • The field is optional and can contain either 'Now' or 'TimeOfCall' or both

  • The default value is ['Now']

  • Can be provided only when the context field is set to 'Extended'

Include Parties

  • Toggle option (true/false)

  • Whether to include parties in the response

Include Public Comments

  • Toggle option (true/false)

  • Whether to include public comments in the response

Include Media

  • Toggle option (true/false)

  • Whether to include media in the response

Add New Call

Add a new call record to Gong.

Required Parameters

Client Unique ID

  • A call's unique identifier in the PBX or the recording system

  • Gong uses this identifier to prevent repeated attempts to upload the same recording

Actual Start

  • The actual date and time when the call started in ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC)

Direction

  • Dropdown selection

  • Whether the call is inbound (someone called the company), outbound (a rep dialed someone outside the company), or a conference call

Primary User

  • Dropdown selection

  • The Gong internal user ID of the team member who hosted the call

Parties

  • Comma separated values

  • A list of the call's participants

  • A party must be provided for the Primary User

  • Each party can have a JSON structure like this example: { "phoneNumber": "123123", "emailAddress": "[email protected]", "name": "Name", "mediaChannelId": "1" }

Optional Parameters

Title

  • The title of the call

  • This title is available in the Gong system for indexing and search

Purpose

  • The purpose of the call

  • This optional field is a free text of up to 255 characters

Scheduled Start

  • The date and time the call was scheduled to begin in ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC)

Scheduled End

  • The date and time the call was scheduled to end in ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC)

Duration

  • The actual call duration in seconds

Disposition

  • The disposition of the call

  • The disposition is free text of up to 255 characters

Meeting URL

  • The URL of the conference call by which users join the meeting

Call Provider Code

  • Dropdown selection

  • The code identifies the provider conferencing or telephony system

  • For example: zoom, clearslide, gotomeeting, ringcentral, outreach, insidesales, etc.

  • These values are predefined by Gong

  • Please contact [email protected] to find the proper value for your system

Download Media URL

  • The URL from which Gong can download the media file

  • The URL must be unique, the audio or video file must be a maximum of 1.5GB

  • If you provide this URL, you should not perform the Add call media step

Workspace ID

  • Optional workspace identifier

  • If specified, the call will be placed into this workspace

  • Otherwise, the default algorithm for workspace placement will be applied

Language Code

  • Dropdown selection

  • The language code the call should be transcribed to

  • This field is optional as Gong automatically detects the language spoken in the call and transcribes it accordingly

  • Set this field only if you are sure of the language the call is in

Use Case Example

The Gong integration enables various workflow automation scenarios:

Call Analysis and Content Creation

  • Extract transcripts from sales calls to create case studies and success stories

  • Analyze common objections across calls to improve sales enablement content

  • Generate call summaries for internal documentation

  • Create training materials based on top-performing calls

Notes

  • All date and time parameters use ISO-8601 format

  • Workspace IDs and Call IDs can be found in your Gong workspace

  • For pagination with large datasets, use the Cursor parameter returned from previous requests

  • Media file uploads are limited to 1.5GB

Last updated

Was this helpful?