RingCentral
Connect RingCentral to Ploy to see every user in your RingCentral account, whether they are active, not yet activated or suspended, and the roles each one holds. Ploy can also add users, suspend and re-enable them, change their roles and remove them.
This integration is in beta. It was built from RingCentral's API documentation and has not yet been run against a live RingCentral account. Everything works the same way as any other integration, but expect us to refine it as the first customers connect.
Before you start
You need:
A RingCentral administrator who can sign in to the RingCentral Developer Console (developers.ringcentral.com) with your company account.
To let Ploy change roles, RingCentral must grant your app the Role Management permission, which it gives on request.
Step 1: Create an app in the RingCentral Developer Console
Sign in to the RingCentral Developer Console as an administrator of your company account.
Create a new REST API App.
Under authentication, choose JWT auth flow.
Give the app these permissions:
Read Accounts: needed to scan users and roles.
Edit Accounts: lets Ploy add and remove users.
Edit Extensions: lets Ploy suspend and re-enable users.
Role Management: lets Ploy give and remove roles. RingCentral grants this one on request.
Create the app, then open its Credentials page and copy the Client ID and Client Secret.
Step 2: Create a JWT credential
In the Developer Console, open your profile's Credentials page.
Create a JWT, and allow it for the app you created in Step 1.
Copy the JWT. Ploy acts with the permissions of the administrator who owns it, so use an administrator who can view and manage users.
Step 3: Connect RingCentral in Ploy
In Ploy, open Integrations and choose RingCentral.
Tick the beta consent box. Because this integration is in beta, Ploy asks your permission to keep redacted error data: when RingCentral answers a request with an error, Ploy records that error with personal details and secrets removed, so we can fix problems quickly. Nothing is recorded when requests succeed.
Choose your environment. Choose Production for your company's live account; choose Developer sandbox only for a RingCentral developer test account.
Paste the Client ID, Client Secret and JWT, then continue.
On the next page, confirm your RingCentral account. If it is not listed, go back and check the environment and the credentials.
Save. Ploy tests the connection by reading one user from your account.
What Ploy reads
Every user in your RingCentral account, with their name and email address.
Whether each user is active, not yet activated, or suspended. Suspended users are shown as blocked and lose their access in Ploy straight away.
The roles each user holds, including custom roles your company has created.
Ploy does not read call logs, messages, voicemail or personal contacts, and does not scan departments, call queues or other phone system extensions that are not people.
What Ploy can change
Add a user with their email address and name. Their phone number, licence and starting role follow your account's defaults.
Suspend and re-enable a user.
Remove a user from the account.
Change roles: give or remove one role at a time, or move a user to a single role. A user always keeps at least one role, so Ploy will not remove their last one.
Troubleshooting
"RingCentral rejected those credentials": check the client ID, client secret and JWT were copied in full, and that the JWT has not expired or been revoked.
"Those credentials cannot read users": the app needs the Read Accounts permission, and the JWT must belong to an administrator who can view users.
A role change is refused: ask RingCentral to grant your app the Role Management permission.