Adding your RingCentral credentials to Oomnitza

Best practice
For the integration with Oomnitza, create a dedicated user account.

To integrate with RingCentral, you need to add the following information to Oomnitza:

• API URL. This can be either your test or production URL. For example, https://platform.ringcentral.com or https://platform.devtest.ringcentral.com
• Client ID 
• Client Secret

You can generate the Client ID and Secret by creating an app in the RingCentral developer portal. Note that trial users are only enabled access to the https://platform.devtest.ringcentral.comAPI.

When you generate the app, ensure the following:

1. Select REST API app
2. For the authentication type select:
   1. 3-legged OAuth flow authorization code
   2. Server-side web app (most common)
   3. Set the redirect URL to https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url
   4. Select Yes to issue refresh tokens.
3. Select the scopes relevant to the information you want to retrieve. 

For further information, refer to the RingCentral Developers portal: Registering an application.

Adding your credentials

To stream RingCentral data into Oomnitza, add the credentials that you obtained to Oomnitza:

Make life easier and add your credentials to Oomnitza before you create the integration.  

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration.
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. In the INFORMATION tab, add a name for the connection and choose an owner. The owner must have been added to the People page in Oomnitza.
2. In the AUTHORIZATION tab, complete these actions:
   1. Ensure that OAuth 2.0 is selected as the Authorization type.
   2. Ensure that RingCentral is selected from the SaaS list.
   3. Enter your credentials and API URL. 
3. Authenticate and click Create.