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
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
Data Source Payload
{
"result": [
{
"label": "Sales Onboarding",
"key": "3843152912968920037"
}
]
}
Fetch Workspaces
Fetch an array of Workspaces | key: workspaces | type: picklist
Data Source Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"data": {
"requestId": "4al018gzaztcr8nbukw"
}
}
Delete Gong Meeting
Deletes an existing Gong Meeting | key: deleteMeeting
Output Example Payload
{
"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
Output Example Payload
{
"data": {
"requestId": "4al018gzaztcr8nbukw"
}
}
Get Call
Retrieve data for a specific call (/v2/calls/{id}) | key: getCallUsingGet
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"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
Output Example Payload
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"workspaces": [
{
"id": "623457276584334",
"name": "Some Workspace",
"description": "This is one of our workspaces"
}
]
}
}
Raw Request
Send raw HTTP request to Gong's API | key: rawRequest
Update Gong Meeting
Updates an existing Gong Meeting | key: updateGongMeeting
Output Example Payload
{
"data": {
"requestId": "4al018gzaztcr8nbukw",
"meetingId": "7782342274025937895",
"meetingUrl": "https://join.gong.io/my-company/jon.snow?tkn=MoNpS9tMNt8BK7EZxQpSJl",
"additionalInvitees": [
{
"displayName": "Gong Assistant",
"email": "assistant@gong.io"
}
]
}
}