8x8 Community

My Services Express Jitsi as a Service 8x8 Connect 8x8 Work for Web

Gong.io Integration Guide for 8x8 Services

Updated: 09/18/2024

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:

Obtaining 8x8 CSS API Keys

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.
    clipboard_ee7ac7e6713090e52710581084f9f73cd.png
  6. From the Admin Console Home or service menu at the top-left, click API Keys.
  7. Click Create app.
  8. In App Details, enter a Name for your application. The name cannot contain spaces or special characters.
  9. In API Products, select Call recordings and Storage.
  10. Click Save.
    clipboard_e0a760ed19ab2fe46699322bdaf95ec0c.png

    You will now see the application you created on your API Keys Dashboard.
  11. Click the eye icon
    clipboard_ec81a393698dfb00307ad73323cfa980a.png
     at the far right to display your application's Key and Secret.
  12. And finally, safely and securely communicate the following API credentials to Gong:
    • SCIM API: URL and Access Token
    • CSS API: Key and Secret
      clipboard_ee72d9d377fdbf160b2894f2fb8dd0698.png

Obtaining 8x8 API Token for SCIM API

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) 
    clipboard_efb2ab6d236534126ba11e6aa88f2dcd2.png
    , 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.
  4. 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.
  5. In the <provider> SCIM Provisioning section, individually click the Copy icon
    clipboard_e75e3a876adef08b7d8aa8297de1203a4.png
     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.
    clipboard_e3cf39d6a29d152a103dce7bddcaeb991.png

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.
clipboard_e54768c693514b128ff1a6eb610e47d6d.png

Additional Information