Gong

Connect to your users' Gong accounts.

Setup Guide

Note: You'll need to create a new Gong app if you don't already have one.

You can find your Gong app credentials in your Gong Developer Account.

You'll need the following information to set up your Gong App with Paragon Connect:

  • Client ID

  • Client Secret

  • Scopes Requested

Add the Redirect URL to your Calendly app

Paragon provides a redirect URL to send information to your Calendly app. To add the redirect URL to your Calendly app:

1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:

https://passport.useparagon.com/oauth

2. Log into your Gong Developer Portal.

3. Select your app from the list of apps.

5. Under Redirect URL, paste-in the redirect URL from Paragon. The redirect URL can be found in Step 1.

6. Press the Save button to confirm your changes.

Add your Gong app to Paragon

Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from your developer app in their respective sections:

  • Client ID: Found under Client ID on your Gong App page.

  • Client Secret: Found under Client Secret on your Gong App page.

  • Permissions: Select the scopes you've requested for your application.

Leaving the Client ID and Client Secret blank will use Paragon development keys.

Connecting to Gong

Once your users have connected their Gong account, you can use the Paragon SDK to access the Gong API on behalf of connected users.

See the Gong REST API documentation for their full API reference.

Any Gong API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Get all Calls after a specified date
paragon.request("gong", "/v2/calls?fromDateTime=2018-02-18T02:30:00-07:00", {
  method: "GET"
});

// Create a new Call
paragon.request("gong", "/v2/calls", {
  method: "POST",
  body: {
    "actualStart": "2018-02-17T02:30:00-08:00",
    "callProviderCode": "clearslide",
    "clientUniqueId": "123abc",
    "context": [
      {
        "objects": [
          {
            "fields": [
              {
                "name": "name",
                "value": "Gong Inc."
              }
            ],
            "objectId": "0013601230sV7grAAC",
            "objectType": "Account"
          }
        ],
        "system": "Salesforce"
      }
    ],
    "direction": "Conference",
    "duration": 125.8,
    "meetingUrl": "https://www.conference.com/john.smith",
    "parties": [
      {
        "emailAddress": "test@test.com",
        "name": "Test User",
        "userId": "7387268041252473322"
      }
    ],
    "primaryUser": "7387268041252471122",
    "purpose": "Demo Call",
    "scheduledEnd": "2018-02-19T02:30:00-08:00",
    "scheduledStart": "2018-02-17T02:30:00-08:00",
    "title": "Demo Test Call",
    "workspaceId": "623457276584334"
  }
});

// Get Log Data after a specified date
paragon.request("gong", " /v2/logs?fromDateTime=2018-02-18T02:30:00-07:00", {
  method: "GET"
});
  

Building Gong workflows

Once your Gong account is connected, you can add steps to perform the following actions:

  • Add a new Call

  • Get Call by ID

  • Search for Call

When creating or updating records in Gong, you can reference data from previous steps by typing {{ to invoke the variable menu. You can also use the Gong Request step to access any of Gong's API endpoints without the authentication piece.

Last updated