# Ring Central

The Infraon Ring Central marketplace integration creates a seamless connection between the requester and the technicians while resolving tickets. This will be achieved through a cloud-based communication system that combines calling features with collaboration tools, allowing for faster issue resolution and ultimately leading to faster resolution for customers.

## How to Install <a href="#toc202351343" id="toc202351343"></a>

### Installation Steps

#### **STEP 1: Installing the integration**

**STEP 1.1:** Log in to your Infraon account. On the left panel, click on the Marketplace tab and select **“Ring Central”** integration.&#x20;

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FYl25lxUntnelFHaKpuuG%2F0.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 1.2:** After clicking the tab, click on Install.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FqU3MWxUZ19qwi3U1z9vR%2F1.png?alt=media)

**STEP 1.3:** Once the installation is done, click on the Ring Central-Infraon configuration tab.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FRGb06OVQsEh4iKP8un5t%2F2.png?alt=media)

**STEP 1.4:** Enter the credentials as prompted in the respective call-out boxes.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2Fwdl7BmhozKxHl4oBQYfO%2F3.png?alt=media)

<table data-header-hidden><thead><tr><th width="199.00006103515625"></th><th></th></tr></thead><tbody><tr><td>Label</td><td><strong>Description / Example</strong></td></tr><tr><td><strong>Client ID*</strong></td><td><p>The unique identifier generated in your RingCentral developer account for API authentication.</p><p><strong>Example:</strong> a1b2c3d4e5f6g7h8</p></td></tr><tr><td><strong>Client Secret Key</strong>*</td><td><p>A secure key paired with the Client ID to authenticate API requests.</p><p><strong>Example:</strong> x9y8z7w6v5u4t3s2</p></td></tr><tr><td><strong>Server</strong>*</td><td><p>The RingCentral API server URL or environment (e.g., Sandbox or Production).</p><p><strong>Example:</strong> <a href="https://platform.ringcentral.com/">https://platform.ringcentral.com</a></p></td></tr><tr><td><strong>User</strong>*</td><td>The Infraon platform user account will be linked with the RingCentral integration and selected from the drop-down list.</td></tr><tr><td><strong>JWT Token</strong>*</td><td><p>JSON Web Token is for secure authentication without using a username/password. Obtained from the RingCentral admin portal.</p><p><strong>Example:</strong> eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...</p></td></tr><tr><td><strong>Add</strong></td><td>Allows you to add and configure additional user credentials for multi-user setup within the same organization.</td></tr></tbody></table>

Follow the steps below to add the credentials.

#### **STEP 2: Register an App**

**STEP 2.1:** Log in to the Ring Central webpage.

**STEP 2.2:** After logging in, go to the developer guides. Navigate to the "Voice" section and find the "Getting Started" page. Click the **"Create RingOut App"** button to begin.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FrTyPOvLBpPaApx0C3AaQ%2F4.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 2.3:** Begin the app registration process by clicking **"Register App."**

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2F9pLLmlfiJyo9veCobP2m%2F5.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 2.4:** Select the app type and click on **‘Next’** to continue.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FSmZFRG38OG4CcHa5JTyR%2F6.png?alt=media)

**STEP 2.5:** Now, enter the app name, description, and primary contact information in the ‘Add properties’ section. Click on the **(i)** button for more details.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2Fk8nwsKvkwwFmgaQlDyql%2F7.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 2.6:** In the ‘App Card’ section, shape the app's appearance on the App Gallery. Use these fields to configure its presentation. For more help, click on the **(i)** button to learn how to customize profiles for partners' app galleries.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2F2vd5qulkv6eA5RvV6Sxq%2F8.png?alt=media)

**STEP 2.7:** In the ‘Auth’ section, locate and choose the authentication type that aligns with the organization’s security protocols.

Select **‘Yes’** to issue refresh tokens.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FklKl5Wtpkbls59xVUfQA%2F9.png?alt=media)

**STEP 2.8:** Add the required security scopes and configure security by specifying access levels in the security section. **“Public”** grants unrestricted access, while **“Private”** limits access only to authorized users.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2F8WBHeWzIljR4kLFOFCl7%2F10.png?alt=media)

**STEP 2.9:** Select the app features as per the requirements and click **“Create”** to register the app.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2Fd1IdSIkpA0FmbDOQFMOw%2F11.png?alt=media)

The app has now been registered.

#### **STEP 3: Obtaining the Access Credentials**

**STEP 3.1:** Navigate to **Step 2.3** and click the newly created app to access its details.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FsYK3SUVNOyU93p3LAXKW%2F12.png?alt=media)

**STEP 3.2:** On the panel, select the **Dashboard** tab.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FMMG5iyg5sjsaU6tl4fUp%2F13.png?alt=media)

**STEP 3.3:** Copy and paste the **API server URL**, **Client ID**, and **Client Secret** into the Infraon portal's configuration page. (STEP 1.4)

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2Feyh8k6sbTF5THB8TfXTB%2F14.png?alt=media)

#### **STEP 4: Generating the JWT Token**

**STEP 4.1:** Click on the user account icon, then navigate to the **Credentials** tab to continue.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FcP7KW4y4ZW4WO3OPj8pd%2F15.png?alt=media)

**STEP 4.2:** Click **Create JWT** to generate a unique JWT for each specific user. Make sure to save the generated token securely for later use in the configuration.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FEcQOPCw9lD2A90vYU8or%2F16.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 4.3:** On the **Create JWT** page, enter a descriptive label (e.g., Infraon Call Credentials) and choose the environment that matches your server URL—**Production** or **Sandbox**.

Then, proceed to configure the allowed applications as needed.

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2F8LI65TPo9g9u9DFB6KMq%2F17.png?alt=media" alt=""><figcaption></figcaption></figure>

**STEP 4.4:** Check the required selection

<figure><img src="https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FSeRhzguKdWii1iv8dRsO%2F18.png?alt=media" alt=""><figcaption></figcaption></figure>

Now open the same downloaded JSON file, access the JWT token, and paste it into the Infraon portal's configuration page.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2F6vzSCldmsp4B5QtsYmta%2F19.png?alt=media)

**STEP 4.3:** After adding the required credentials, click **"Verify"** to complete the Ring Central and Infraon integration.

![](https://8249392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE4mkwSP8a1BSD9BFNFav%2Fuploads%2FyQgmB9foPt9G4tymZaV1%2F20.png?alt=media)

The above process is now completed.