> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gong

> Connect Gong to Orbb with OAuth 2.0 for access to call recordings, transcripts and user data from your Gong workspace.

This integration enables Orbb to connect with Gong, allowing access to call recordings, transcripts, and user data from your Gong workspace. The integration uses OAuth2 authentication to securely connect to your Gong account and provide comprehensive access to conversation intelligence data.

## Prerequisites

* A Gong account with administrative access
* Permission to authorize OAuth2 applications in your Gong workspace

> [!WARNING]
>
> Only users with **admin** privileges can perform these actions. Ensure you have the necessary permissions before proceeding.

## OAuth Scopes

The following OAuth scopes are required for the integration to function properly:

```text theme={"system"}
api:calls:read:basic
api:calls:read:extensive
api:users:read
api:calls:read:transcript
```

> [!NOTE]
>
> **OAuth Scopes Explanation**
>
> Here's what each scope enables:
>
> * **Call-related scopes:**
>   * `api:calls:read:basic`: View basic call metadata including call IDs, dates, durations, and participants
>   * `api:calls:read:extensive`: View detailed call information including advanced analytics, topics, and action items
>   * `api:calls:read:transcript`: Access full call transcripts for analysis and review
> * **User-related scopes:**
>   * `api:users:read`: View basic information about users in your Gong workspace

## Integration Steps

### 1. Start OAuth2 Authorization

1. In your Orbb dashboard, navigate to **Admin Center** → **Calls Integrations** → **Gong.io**
2. Click **Connect**
3. You will be redirected to Gong's authorization page

### 2. Authorize Orbb

1. Review the requested permissions (scopes)
2. Click **Allow** to authorize Orbb
3. You will be redirected back to Orbb with the integration configured

> [!TIP]
>
> After authorization is complete, click the **Test** button to verify the connection. A green icon will appear if everything is working correctly.

## Security Considerations

* The OAuth2 connection is secure and can be revoked at any time from your Gong workspace settings
* Orbb uses token-based authentication and does not store your Gong user credentials

## Troubleshooting

If you encounter any issues:

1. Verify that the OAuth2 authorization was successful
2. Ensure your Gong account has the necessary administrative privileges
3. Verify that the required scopes were granted during authorization
4. Try disconnecting and reconnecting the integration if issues persist


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.