Ring Central Integration with Shape

Disclaimer: Please note, this integration does not support all of the powerful features available in the native Shape phone system. Examples of features not included are: inbound call routing, IVR, texting, call recording, reporting, etc. If you are looking for a more integrated solution, consider using our built in telephony platform.

With the RingCentral integration, users can seamlessly click to call through RingCentral directly from within Shape. This integration supports outbound click to call functionality through the RingCentral RingOut app. You will need to create a RingOut app in your RingCentral account.

Integration Capabilities

What you Need for the Integration

Setting Up the Integration

To get started with the connection you will need to navigate to Settings > Integrations. Once there, scroll down and find RingCentral. Click “Connect” and enter your API Secret and API Key and save this information.

To get this, you’ll need to create a RingOut App within your RingCentral account and provide us with your Client ID and secret.

Login or create an account if you have not done so already.
If you don’t use the link above – select “API App for RingCentral Office” under “What type of app are you creating?”
Select “Other Non-UI” under “Where will you be calling the API from?”
Select “Only members of my organization/company” under “Who will be authorized to access your app?”
On the second page of the create app wizard (see image), enter your app’s name and description. Then select the permission: RingOut
Fill in the field “OAuth Redirect URL” with: https://secure.setshape.com/ringcentral (this step is not on newer RingCentral accounts and is not required)

Password Flow Rules

Shape makes an OAuth 2.0 request using the OAuth 2.0 password grant (grant_type=password), also known as “Password flow” in the RingCentral Developer Portal and formally as the “Resource Owner Password Credentials” grant in the OAuth 2.0 IETF RFC 6749 standard.

To use this grant type, they need to make sure the app is configured to have the Password flow grant in the RingCentral Developer Portal as shown below:

Create App Wizard

When creating an app, make sure to ensure “Password flow” is selected. Your options are based on on the “Application type” and “Platform type” for your app, which in turn are related to the security specifications of your app.

App Settings Page

To verify an existing app has “Password flow” enabled, go to the app’s “Settings” page’s “OAuth Settings” section and verify Password flow is present.

Adding User Credentials

Once the integration has been connected in the Integrations page, each user will need to enter in their username, password, and extension in their user profile. Users can click on their name in the upper right hand corner in the gradient navigation bar and click on “Profile.” The RingCentral username, password, and extension fields appear in the “Personal Info” tab.

Note: Once RingCentral is connected in both the integrations page and the users’ profiles, users will notice a RingCentral icon next to phone numbers. Click on the “R” RingCentral icon to place outbound calls. Shape support cannot support the Ring Central system. You must work with Ring Central support team for any issues related to Ring Central services.

Keywords: Ringcentral, telephone, call, integration, OAuth, RingOut app, outbound calling, app properties