Skip to main content

 

 
8x8 Support

Gong.io Integration Guide

Objective

This document describes the process and requirements for integrating 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-Icon.png

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 available at: https://www.8x8.com/terms-and-conditions/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 accounts, only
  • Gong.io

Creating API Access credentials

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

clipboard_eadb8f59cbecb53bbe86796f5403b0e3c.png

Obtaining 8x8 CSS API keys

Important-Icon.png

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 here.

  1. In 8x8 Admin Console, click on the top-left control menu and navigate to Roles & permissions > Assignments.

clipboard_e255c8a3de01fb7b16a48b4da611b5f60.png

  1. Click + Create Assignment.

clipboard_e693613289b9bafa7d793d585ce2cfa3a.png

  1. Assign the following to yourself (the Super Admin):
    • Role: Storage Api
    • Scope: Storage Admin
  2. Click Save.
  3. Log out of Admin Console and log back in, or refresh your web browser for the new permissions to take effect.

clipboard_ee7ac7e6713090e52710581084f9f73cd.png

  1. From the Admin Console Home or service menu at the top-left, click API Keys.

clipboard_e344ce8eb4c27209f84e7b7d66cf91392.png

  1. Click Create app.
  2. In App Details, enter a Name for your application. The name cannot contain spaces or special characters.
  3. In API Products, select Call recordings and Storage.
  4. Click Save.

clipboard_e0a760ed19ab2fe46699322bdaf95ec0c.png

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

  1. Click the eye icon clipboard_ec81a393698dfb00307ad73323cfa980a.png at the far right to display your application's Key and Secret.
  2. 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:

Note-Icon.png

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 HomeIdentity Management.
  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
Important-Icon.png

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

  • Was this article helpful?