Gong.io Integration Guide for 8x8 Services

Gong.io Integration Guide for 8x8 Services

Objective

Integrate Gong.io with 8x8 X Series accounts, allowing Gong.io to access customer call recordings and user data on the 8x8 platform.

This process must be performed by each customer wishing to implement this integration.

IMPORTANT:

  • The 8x8 SCIM and CSS APIs allow full read & write access to the underlying resources of the customer account. Access details for these resources should only be shared with trusted parties.
  • Access to and use of 8x8 APIs is subject to the 8x8 API License Agreement.
  • 8x8 is not liable or responsible for any act or omission of customer or any of its third party providers (e.g., any accessing, modification, or deletion of data).

Applies To

  • 8x8 Admin Console
  • 8x8 X Series
  • Gong.io

Procedure

Creating API Access Credentials

The following procedures will be applied in 8x8 Admin Console as part of this process:

IMPORTANT: The following process must be performed by an 8x8 Admin Console Super Admin (the primary/initially created user). More information about Admin Console roles can be found in Viewing and Creating X Series User Roles.
  1. In 8x8 Admin Console, click on the top-left control menu and navigate to Roles & Permissions > Assignments.
  2. Click + Create Assignment.
  3. Assign the following to yourself (the Super Admin):
    • Role: Storage Api
    • Scope: Storage Admin
  4. Click Save.
  5. Log out of Admin Console and log back in, or refresh your web browser for the new permissions to take effect.

A screenshot of a computer AI-generated content may be incorrect.

  1. From the Admin Console Home or service menu at the top-left, click API Keys.
  2. Click Create app.
  3. In App Details, enter a Name for your application. The name cannot contain spaces or special characters.
  4. In API Products, select Call recordings and Storage.
  5. Click Save.

A screenshot of a computer AI-generated content may be incorrect.


You will now see the application you created on your API Keys Dashboard.

  1. Click the eye icon  at the far right to display your application's Key and Secret.

  1. And finally, safely and securely communicate the following API credentials to Gong:
    • SCIM API: URL and Access Token
    • CSS API: Key and Secret

A screenshot of a computer AI-generated content may be incorrect.

8x8 Admin Console provides separate processes for configuring Single Sign-On Integration (SSO) and User Provisioning Integration (SCIM). See the screenshot, below.

SCIM API will allow Gong to get a listing of basic 8x8 User profile information, as stored in the 8x8 Admin Console:

Single Sign-On Integration (SSO)

  • This provides users the ability to sign into their 8x8 applications using their corporate IT credentials. It is not required to be enabled for the Gong.io integration. It also will have no bearing on the Gong.io integration if it is enabled.

User Provisioning Integration (SCIM)

  • User provisioning integration uses SCIM 2.0 and allows you to automate employee onboarding & offboarding by having the users in your enterprise directory synchronized into Admin Console.
  • SCIM API also provides create/edit/disable access. However: X Series license, phone number assignment, and user profile deletion are not accessible from the API.

To obtain the SCIM API URL and Access token:

  1. Log in to the 8x8 Admin Console as an administrator.
  2. Navigate to Home > Identity & Security.
  3. In the User Provisioning Integration (SCIM), click the switch at the right to enable it (blue) , if it is not already enabled.

    • Note that by design, Single Sign-On Integration (SSO) and User Provisioning Integration (SCIM) can be configured to implement different identity providers, if needed.
  1. Select the SCIM provider you are obtaining API information for:
    • Microsoft Azure AD
    • Okta
    • Other SCIM Provider: You must select this option if you do not use Azure or Okta, and you are enabling SCIM only for Gong integration.
  2. In the <provider> SCIM Provisioning section, individually click the Copy icon  for each of the following, paste it into a text editor, and securely store the information:

    • 8x8 URL: URL for SCIM API
    • 8x8 API Token: Access Token

If some or all of your users were manually created in Admin Console, you must follow these steps:

  1. Click Advanced settings at the bottom to expand the section.
  2. In Users that can be retrieved by your identity provider, click the drop-down arrow and select All users.
  1. Click Save to complete the process.

A screenshot of a computer AI-generated content may be incorrect.

Gong.io SCIM and CSS API Connect Form

Once you have the information obtained using the processes above, you can apply it to your Gong.io account configuration.

A screenshot of a phone AI-generated content may be incorrect.

Additional Information

    • Related Articles

    • 8x8 Admin Console Administrator Guide for Migrated Services

      Overview Welcome to Admin Console! This page provides a brief overview of your new system management platform. Any settings changes previously made in Account Manager will now be done in Admin Console. Comprehensive information is available in the ...

    • X Series Metered & Pro Services Table

      Overview Customers moving from our Legacy offering may see the additional X Series Metered or Pro packages listed in their bill after their account is upgraded. The newly migrated X Series services may include the features below. Service Offerings ...

    • CRM Integration Profiles FAQ

      Overview The new CRM Integration Profiles feature in 8x8 Admin Console gives 8x8 administrators the ability to create CRM integration profiles, which allows admins to set preferences that govern the behavior of 8x8 integrations in select CRMs, ...

    • Emergency Services Overview

      Overview Being able to dial local emergency services when required is an essential and safety critical element of 8x8’s UC service. This article gives an overview of 8x8 emergency calling features. Applies To X Series Admin Console Nomadic 911 Your ...

    • X Series Upgrade FAQ

      Overview If you've been contacted about a pending or recently completed system upgrade to 8x8 X Series, congratulations! X Series and Admin Console bring you a new, easier, and more intuitive way to manage your users and services. Check out the ...