Gong Component
Captures customer interactions then delivers insights at scale, empowering teams to make decisions based on data instead of opinions. Use the Gong Component to manage calls, users, libraries, and more.
Component key: gongDescription
Gong captures customer interactions then delivers insights at scale, empowering teams to make decisions based on data instead of opinions.
Use the Gong Component to manage calls, users, libraries, and more.
Connections
API Key
To generate a Gong API key manually:
- Log in to Gong and click Company Settings > Ecosystem > API.
- Click Create to generate an access key and the access key secret.
- Take note of the API Base URL that is displayed next to the access key and access key secret.
Gong OAuth 2.0
To Create an OAuth app for Gong:
- In your company's Settings page, click API and click the Integrations tab.
- Click Create Integration.
- In the Integration details area, enter your integration name and a description.
- In the Required authorization scopes area, select the scopes that your app needs. You can check our API documentation to see which APIs use which scopes.
- Add Redirect URI as https://oauth2.prismatic.io/callback
- Click Save.
A new row appears in the table of apps, containing the Client ID and the Client Secret. Copy and paste these into the connection configuration of your Prismatic integration.
Triggers
Process Automation Trigger
Trigger for handling process automations from Gong | key: webhook
Data Sources
Fetch Folders
Fetch an array of Folders | key: folders | type: picklist
{
"result": [
{
"label": "Sales Onboarding",
"key": "3843152912968920037"
}
]
}
Fetch Workspaces
Fetch an array of Workspaces | key: workspaces | type: picklist
{
"result": [
{
"label": "Sales Onboarding",
"key": "3843152912968920037"
}
]
}
Actions
Add Call Media
Adds a call media, recorded by a telephony system (PBX) or other media recording facility. | key: addMedia
Create New Call
When using this endpoint, either provide a downloadMediaUrl or use the returned callId in a follow-up request to /v2/calls/[id]/media to upload the media file. | key: createNewCall
Create New Gong Meeting
Creates a new Gong Meeting | key: createNewGongMeeting
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"meetingId": "7782342274025937895",
"meetingUrl": "https://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl",
"additionalInvitees": [
{
"displayName": "Gong Assistant",
"email": "assistant@gong.io"
}
]
}
}
Custom Action Event
Push engagement events into Gong and display them as events in Gong's activity timeline, when a content is engaged by an external participant (for example, a contract was 'signed' by the prospect) | key: customActionEvent
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"integrationId": 55170271882342
}
}
Custom Shared Event
Push engagement events into Gong and display them as events in Gong’s activity timeline, when a Gong user shares content with external participants (for example, a contract was “shared” by the account executive with his prospects) | key: customSharedEvent
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"integrationId": 55170271882342
}
}
Custom Viewed Event
Push engagement events into Gong and display them as events in Gong's activity timeline, when a Gong user shares content with external participants (for example, a contract was “shared” by the account executive with his prospects) | key: customViewedEvent
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"integrationId": 55170271882342
}
}
Delete Email Address and Associated Elements
Given an email address, this endpoint deletes from the Gong system any calls or email messages that reference this address. | key: deleteEmailAddressAndAssociatedElements
{
"data": {
"requestId": "4al018gzaztcr8nbukw"
}
}
Delete Gong Meeting
Deletes an existing Gong Meeting | key: deleteMeeting
{
"data": {
"organizerEmail": "test@test.com"
}
}
Delete Phone Number and Associated Elements
Given a phone number, this endpoint deletes from the Gong system any leads or contacts with a matching phone number or mobile phone number. | key: deletePhoneNumberAndAssociatedElements
{
"data": {
"requestId": "4al018gzaztcr8nbukw"
}
}
Get Call
Retrieve data for a specific call (/v2/calls/[id]) | key: getCallUsingGet
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"call": {
"id": "7782342274025937895",
"url": "https://app.gong.io/call?id=7782342274025937895",
"title": "Example call",
"scheduled": 1518863400,
"started": 1518863400,
"duration": 460,
"primaryUserId": "234599484848423",
"direction": "Inbound",
"system": "Outreach",
"scope": "Internal",
"media": "Video",
"language": "eng",
"workspaceId": "623457276584334",
"sdrDisposition": "Got the gatekeeper",
"clientUniqueId": "7JEHFRGXDDZFEW2FC4U",
"customData": "Conference Call",
"purpose": "Demo Call",
"meetingUrl": "https://zoom.us/j/123",
"isPrivate": false,
"calendarEventId": "abcde@google.com"
}
}
}
Get Call Transcript
Returns transcripts for calls that took place during the specified date period. | key: getCallTranscript
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"records": {
"totalRecords": 263,
"currentPageSize": 100,
"currentPageNumber": 0,
"cursor": "eyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM"
},
"callTranscripts": [
{
"callId": "7782342274025937895",
"transcript": [
{
"speakerId": "6432345678555530067",
"topic": "Objections",
"sentences": [
{
"start": 460230,
"end": 462343,
"text": "No wait, I think we should check that out first."
}
]
}
]
}
]
}
}
Get Logs Data by Type and Time Range
List log entries that took place during a specified time range. | key: getLogsDataByTypeAndTimeRange
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"records": {
"totalRecords": 263,
"currentPageSize": 100,
"currentPageNumber": 0,
"cursor": "eyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM"
},
"logEntries": [
{
"userId": "234599484848423",
"userEmailAddress": "test@test.com",
"userFullName": "Jon Snow",
"impersonatorUserId": "234599484848423",
"impersonatorEmailAddress": "test@test.com",
"impersonatorFullName": "Jon Snow",
"impersonatorCompanyId": "234599484848423",
"eventTime": "2018-02-17T02:30:00-08:00",
"logRecord": {}
}
]
}
}
Get User
Retrieve a specific user. | key: getUser
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"user": {
"id": "234599484848423",
"emailAddress": "test@test.com",
"created": "2018-02-17T02:30:00-08:00",
"active": true,
"emailAliases": [
"testAlias@test.com"
],
"trustedEmailAddress": "test@test.com",
"firstName": "Jon",
"lastName": "Snow",
"title": "Enterprise Account Executive",
"phoneNumber": "+1 123-567-8989",
"extension": "123",
"personalMeetingUrls": [
"https://zoom.us/j/123"
],
"settings": {
"webConferencesRecorded": true,
"preventWebConferenceRecording": false,
"telephonyCallsImported": false,
"emailsImported": true,
"preventEmailImport": false,
"nonRecordedMeetingsImported": true,
"gongConnectEnabled": true
},
"managerId": "563515258458745",
"meetingConsentPageUrl": "https://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl",
"spokenLanguages": [
{
"language": "es-ES",
"primary": true
}
]
}
}
}
List Calls
Retrieve call data by date range (/v2/calls) | key: listCallsUsingGet
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"records": {
"totalRecords": 263,
"currentPageSize": 100,
"currentPageNumber": 0,
"cursor": "eyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM"
},
"calls": [
{
"id": "7782342274025937895",
"url": "https://app.gong.io/call?id=7782342274025937895",
"title": "Example call",
"scheduled": 1518863400,
"started": 1518863400,
"duration": 460,
"primaryUserId": "234599484848423",
"direction": "Inbound",
"system": "Outreach",
"scope": "Internal",
"media": "Video",
"language": "eng",
"workspaceId": "623457276584334",
"sdrDisposition": "Got the gatekeeper",
"clientUniqueId": "7JEHFRGXDDZFEW2FC4U",
"customData": "Conference Call",
"purpose": "Demo Call",
"meetingUrl": "https://zoom.us/j/123",
"isPrivate": false,
"calendarEventId": "abcde@google.com"
}
]
}
}
List Calls in Folder
Given a folder id, this endpoint retrieves a list of calls in it. | key: listCallsInFolder
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"id": "3843152912968920037",
"name": "Sales Onboarding",
"createdBy": "234599484848423",
"updated": 1584192600,
"calls": [
{
"id": "7782342274025937895",
"title": "Example call",
"note": "sample note",
"addedBy": "234599484848423",
"created": 1578868200,
"url": "https://app.gong.io/call?id=3636865806219496180&highlights=%5B%7B%22to%22%3A+3240%2C+%22from%22%3A+1200%2C+%22type%22%3A+%22LIBRARY%22%7D%5D",
"snippet": {
"fromSec": 21,
"toSec": 132
}
}
]
}
}
List Library Folders
Use this endpoint to retrieve a list of public library folders. | key: listLibraryFolders
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"folders": [
{
"id": "3843152912968920037",
"name": "Sales Onboarding",
"parentFolderId": "295738305212375930",
"createdBy": "234599484848423",
"updated": 1584192600
}
]
}
}
List References to a Phone Number
Shows the elements in the Gong system that reference the given phone number. | key: listReferencesToAPhoneNumber
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"emails": [
{
"from": "test@test.com",
"id": "223mjfaaqqjuegabiyrmpctvcwwl75oz",
"sentTime": "2019-01-20T00:00:00-08:00",
"mailbox": "test@test.com",
"messageHash": "l3z7w2s7oircdabnkwizmycm6g2uwznc"
}
],
"calls": [
{
"id": "7782342274025937895",
"status": "COMPLETED",
"externalSystems": [
{
"system": "Salesforce",
"objects": [
{
"objectType": "Task",
"externalId": "0013601230sV7grAAC"
}
]
}
]
}
],
"meetings": [
{
"id": "8059707022269524529.sb5gr1tgpt5dd799eh035rb3dk@google.com_2022-06-30T13:00:00Z"
}
],
"customerData": [
{
"system": "Salesforce",
"objects": [
{
"id": "7782342274025937895",
"objectType": "Contact",
"externalId": "0013601230sV7grAAC",
"mirrorId": "\"{\\\"integrationId\\\":\\\"262834820328732\\\",\\\"crmObjectType\\\":\\\"CONTACT\\\",\\\"crmId\\\":\\\"0031Q00002DFhi4QAD\\\"}\"",
"fields": [
{
"name": "name",
"value": "Gong Inc."
}
]
}
]
}
],
"customerEngagement": [
{
"eventType": "ExternalCallViewing",
"timestamp": 1547971200,
"contentId": "7782342274025937895",
"contentUrl": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"reportingSystem": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"eventName": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"sourceEventId": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i"
}
]
}
}
List References to an Email Address
Shows the elements in the Gong system that reference the given email address. | key: listReferencesToAnEmailAddress
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"emails": [
{
"from": "test@test.com",
"id": "223mjfaaqqjuegabiyrmpctvcwwl75oz",
"sentTime": "2019-01-20T00:00:00-08:00",
"mailbox": "test@test.com",
"messageHash": "l3z7w2s7oircdabnkwizmycm6g2uwznc"
}
],
"calls": [
{
"id": "7782342274025937895",
"status": "COMPLETED",
"externalSystems": [
{
"system": "Salesforce",
"objects": [
{
"objectType": "Task",
"externalId": "0013601230sV7grAAC"
}
]
}
]
}
],
"meetings": [
{
"id": "8059707022269524529.sb5gr1tgpt5dd799eh035rb3dk@google.com_2022-06-30T13:00:00Z"
}
],
"customerData": [
{
"system": "Salesforce",
"objects": [
{
"id": "7782342274025937895",
"objectType": "Contact",
"externalId": "0013601230sV7grAAC",
"mirrorId": "\"{\\\"integrationId\\\":\\\"262834820328732\\\",\\\"crmObjectType\\\":\\\"CONTACT\\\",\\\"crmId\\\":\\\"0031Q00002DFhi4QAD\\\"}\"",
"fields": [
{
"name": "name",
"value": "Gong Inc."
}
]
}
]
}
],
"customerEngagement": [
{
"eventType": "ExternalCallViewing",
"timestamp": 1547971200,
"contentId": "7782342274025937895",
"contentUrl": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"reportingSystem": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"eventName": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i",
"sourceEventId": "https://app.gong.io/e/c-share/tkn=5vjaxkqnzmp515b220vlzto2i"
}
]
}
}
List Users
List all of the company's users. | key: listUsers
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"records": {
"totalRecords": 263,
"currentPageSize": 100,
"currentPageNumber": 0,
"cursor": "eyJhbGciOiJIUzI1NiJ9.eyJjYWxsSWQiM1M30.6qKwpOcvnuweTZmFRzYdtjs_YwJphJU4QIwWFM"
},
"users": [
{
"id": "234599484848423",
"emailAddress": "test@test.com",
"created": "2018-02-17T02:30:00-08:00",
"active": true,
"emailAliases": [
"testAlias@test.com"
],
"trustedEmailAddress": "test@test.com",
"firstName": "Jon",
"lastName": "Snow",
"title": "Enterprise Account Executive",
"phoneNumber": "+1 123-567-8989",
"extension": "123",
"personalMeetingUrls": [
"https://zoom.us/j/123"
],
"settings": {
"webConferencesRecorded": true,
"preventWebConferenceRecording": false,
"telephonyCallsImported": false,
"emailsImported": true,
"preventEmailImport": false,
"nonRecordedMeetingsImported": true,
"gongConnectEnabled": true
},
"managerId": "563515258458745",
"meetingConsentPageUrl": "https://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl",
"spokenLanguages": [
{
"language": "es-ES",
"primary": true
}
]
}
]
}
}
List Workspaces
Returns a list of all workspaces including their details. | key: listWorkspaces
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"workspaces": [
{
"id": "623457276584334",
"name": "Some Workspace",
"description": "This is one of our workspaces"
}
]
}
}
Raw Request
Send raw HTTP request to Gong | key: rawRequest
Update Gong Meeting
Updates an existing Gong Meeting | key: updateGongMeeting
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"meetingId": "7782342274025937895",
"meetingUrl": "https://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl",
"additionalInvitees": [
{
"displayName": "Gong Assistant",
"email": "assistant@gong.io"
}
]
}
}