# Gong
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
{% @arcade/embed url="" flowId="FRsO64LnjlYb8Dho3O61" %}
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.
{% hint style="info" %}
***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.*
{% endhint %}
### Available Actions
The Gong integration provides six actions for working with call data and library content:
1. [Retrieve Transcripts of Calls](#retrieve-transcripts-of-calls)
2. [List Calls](#list-calls)
3. [Get Extensive Data](#get-extensive-data)
4. [Add New Call](#add-new-call)
5. [List Library Folders](#list-library-folders)
6. [Get Calls In Folder](#get-calls-in-folder)
### 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@example.com", "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 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
### List Library Folders
List all public library folders in your Gong workspace.
Required Parameters
None - all parameters are optional for this action.
Optional Parameters
**Workspace ID**
* The Gong workspace ID
* Only public folders are returned
### Get Calls In Folder
Retrieve all calls saved in a specific Gong library folder.
Required Parameters
**Folder ID**
* The Gong library folder ID
* Use the **List Library Folders** action to find folder IDs
Optional Parameters
None - all parameters are required for this action.
### 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
