Integrating RingCentral with BetterCloud

Follow

When integrating a new application with your BetterCloud instance, the overall installation process is consistent. However, each integration is different, and may require varying levels and types of authentication. This article provides instructions for configuring and collecting all the information you need in order to add the RingCentral integration in BetterCloud.

BetterCloud requires the following authentication type when integrating with RingCentral:

  • Username and Password (Basic HTTP Authentication)

You will also need to enter the following additional headers in order to successfully connect:

  • clientSecret
  • clientId
  • instanceUrl

*Please note the following important requirements for RingCentral:

  • The SCIM API is only available to RingCentral accounts on Office Premium and Ultimate plans.
  • You must request the “Edit Accounts” SCIM API permission from RingCentral Support before you will be able to carry out the following steps.
  • SCIM must be set as the current Directory Provider in your RingCentral Admin Portal Account Settings
  • In order to successfully integrate you will need to create an app in RingCentral. New apps must first be created in a sandbox environment and have several API calls run against the sandbox before you will be able to move the app to production. This process may take some time, and is described below.

Username and Password

The username and password of the account you are using to authenticate. This account must have the ability both to edit and read accounts, as well as the permissions to create an app in the RingCentral developer portal.

Client Secret, Client ID, and Instance URL

To begin the process of creating an app in RingCentral, navigate to the developer portal and login. Head to “Console” from the top menu. 

 image-0__1_.png

Click “Create App.”

image-1.png

Provide an application name and description - these fields are both required.

image-2.png

On the next page set your Application Type to “Private” and your Platform Type to “Server-only (No UI).” This information is not editable later on, so be sure to set it correctly now.

image-3.png

Under the OAuth Settings you will be required to specify which permissions your app needs. We require that “Edit Accounts” and “Read Accounts” both be selected.

*Please Note: If you do not see the option to add “Edit Accounts,” you will need to contact RingCentral Support to enable the option.

image-4.png

Once you have created your app, its production status will be set to “Inactive.” RingCentral has several requirements for making API calls in your sandbox environment with a new app before it can be promoted to production. See the graduation requirements below:

image-5.png

In order to get started making the required API calls, head to the API reference section of RingCentral, under “Resources” in the developer console.

image-6.png

You will need to authorize the correct app before you can make calls.

image-7.png

The easiest call to make is a GET call, which uses the “Read Accounts” permission. This is the first option under the “Account” section. You can make as many repetitive calls here as you’d like - this will both help you meet your 20+ call requirement, and ensure you have a high percentage of successful calls.

image-8__1_.png

Click “Try it out” to run the call. Using a “~” under “Input” runs the call against your own account. Ensure that you receive a 200 OK response in the Metadata on the right side of the page.image-9.png

You will need to also exercise the “Edit Accounts” permission. The easiest way to do this is to simply delete a sandbox user (if you have a test user available). You may use other calls if you would prefer, but the following steps will show you how to delete a test user in your sandbox.

Navigate to “Provisioning” > “SCIM” > “Delete User.”

image-10__1_.png

The ID of the user to delete can be found in the URL after clicking into a user's account settings in your sandbox. To navigate to your sandbox admin portal, open a separate window and head to the "Console" section of the developer portal, and select "Sandbox Accounts." Then click to open the "Online Account Portal."

 Image_2019-10-08_at_3.06.37_PM.png

From the sandbox portal, select "Users."

Image_2019-10-08_at_3.07.43_PM.png

Then select the user you will be deleting. Their ID will populate in the URL.

urlringcentral.png

Back in the API Resources, enter that value in the “Input” field, and click “Try it out” to delete the user.

image-12.png

You are required to make at least 5 calls from each endpoint, so in order to make enough calls from the SCIM endpoint, run at least 4 additional GET user calls. You may either enter an ID, or use the “~” symbol to retrieve your own account.

image-13.png

The graduation requirements are updated approximately every 15 minutes, so you may need to wait until your most recent calls are reflected.

Once you have met the graduation requirements, apply for production from the app’s dashboard.

image-14.png

When your app has been approved, your production credentials will revealed. The API server URL (instance URL), Client ID, and Client Secret are all included. For the URL, enter only the information after “https://”.

image-15.png

Set SCIM as your Directory Provider

Navigate to “Admin Portal” > “Tools” > “Account Settings” > “Directory Integration”

image-16.png

Set your Current Directory Provider to “SCIM”

image-17.png

Once you have added your integration, your username, password, Client Secret, Client ID, and Instance URL can be updated at any time, if necessary.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request