Create Ring Central Application
Log into https://service.ringcentral.com/application/adminHome. Click More. Click Apps and Resources. Click Developer Portal. Click Create App.
"What type of app are you creating?" -> "API App for RingCentral Office" -> "Web browser (Javascript)".
"Do you intend to promote your app in our App Gallery? (for internal use only)" -> "No".
Click Next.
Enter an App Name.
Enter an App Description.
Add Ring Out and Read Accounts permissions.
Enter your OAuth Redirect URI. It should be your Manitou Central Station URI (not BoldNet) ending in /landingpage. You can enter multiple URIs if you have multiple Manitou Central Station endpoints.
Click Create.
After you've created your application, you will see a screen like this:
You will need the Client ID and Client Secret for the web.config steps below.
You will also need to communicate with your Ring Central administrator to create a user and a phone that is associated with that user that is also associated to the sandbox account. https://service.devtest.ringcentral.com/application/adminHome
Ring Central Phone
Download and install Ring Central Phone (softphone) and log in with your sandbox credentials. You should be able to make a call to an external phone number with the softphone. https://www.ringcentral.com/apps/rc-phone
Licensing
The system must have a non-zero number of Autodialer lines.
MWC
Web.config
Set the RingCentralClientId. This is Client ID assigned to the customer from Ring Central (https://developers.ringcentral.com/my-account.html#/applications).
Set the RingCentralRedirectUri. This is setup in the Ring Central administration (https://developers.ringcentral.com/my-account.html#/applications). It should be your base URL/landingpage. For example, mine is https://dev-12.boldgroup.int/manitou/landingpage.
Set the RingCentralSandbox. If you are testing with your sandbox account then set this to true. If false then you will be using the production endpoints in Ring Central.
Set the RingCentralPlayAudioPrompt. If true then Ring Central will play an audio prompt telling the operator to hit the 1 key to place the call. If false then Ring Central will not play an audio prompt and will place the call after the operator has answered their phone.
API
Web.config
Set the RingCentralClientSecret. This is the Client Secret assigned to the customer from Ring Central when setting up an OAuth Client (https://developers.ringcentral.com/my-account.html#/applications).
Set the RingCentralSandbox. If you are testing with your sandbox account then set this to true. If false then you will be using the production endpoints in Ring Central.
Firewall
MWC users will need to be able to reach https://platform.devtest.ringcentral.com (sandbox) and https://api.ringcentral.com (production).
API will need to be able to reach https://platform.devtest.ringcentral.com/restapi/oauth/token (sandbox) and https://api.ringcentral.com/restapi/oauth/token (production).
Testing Your Application
You'll need to test your sandbox credentials in MWC for 48 hours. After that you will need to Apply for Production for your app.
Graduation requirements are:
To achieve this, log into MWC and say yes to get Ring Central credentials. Go to menu->Tools->Get Ring Central Credentials. Do this at least 5 times. Autodial at least 5 times. Hang up at least 5 times. After a while, you can check on your graduation requirements (they take a while to update). You will have to do this the next day too (don't skip a day!) so that Ring Central has 48 hours of your sandbox account working properly before they will let you apply for production.
After you apply for production, they review your app and should approve it. After that, you will need to update the web.configs with the production Client ID and Client Secret. Operators should then be able to use the Ring Central interface with their phones (after they've selected their line in the autodialer config in MWC).
