Develop and graduate your application in sandbox
Introducing RingCentral Embeddable 2.0 beta
Consider building your Embeddable application on the next version of RingCentral Embeddable to take full advantage of the new features and capabilities it brings.
Upon successfully registering your application you will be provided with a unique client ID to identify your application on the network. Your next step will be to develop your application using this unique client ID in the RingCentral developer sandbox environment.
Learn more RingCentral's developer sandbox environment
Initializing your application in sandbox
To develop your application in sandbox, you will need to update two of RingCentral Embeddable's configuration parameters. Set the following parameters:
Parameter | Value |
---|---|
clientId |
Your sandbox client ID |
appServer |
https://platform.devtest.ringcentral.com |
Example using a <script>
tag
<script>
(function() {
var rcs = document.createElement("script");
var clientId = "YOUR CLIENT ID";
var appServer = "https://platform.devtest.ringcentral.com"
rcs.src = "https://apps.ringcentral.com/integration/ringcentral-embeddable/latest/adapter.js?clientId="+clientId+"&appServer="+appServer;
var rcs0 = document.getElementsByTagName("script")[0];
rcs0.parentNode.insertBefore(rcs, rcs0);
})();
</script>
Example using an iframe
<iframe width="300" height="500" id="rc-widget" allow="microphone"
src="https://apps.ringcentral.com/integration/ringcentral-embeddable/latest/app.html?clientId=your_app_client_id&appServer=https://platform.devtest.ringcentral.com">
</iframe>
Graduate your app to production
Sandbox is used by developers when building and testing applications. In order to use the app in production, developers must "graduate" their app. For RingCentral Embeddable apps, the following should be done in sandbox to quality for graduation:
- Send more than 5 SMS messages
- Send more than 5 internal messages (SMS message to extension number in current account)
- Read more than 5 unread inbound messages
- Update presence more than 5 times in setting page
- Go to Contacts page, and click refresh button more than 5 times
- Login and logout more than 5 times
- Make 5 outbound web phone (Browser based) calls
- Make 5 inbound web phone (Browser based) calls
- Make 5 Ringout calls
- Control(end/hold) Ringout call in widget more than 5 times in widget
Once you have completed the above steps within a 24-hour period, you should be able to "Apply for production" from the Graduation tab in the Developer Console. If you have successfully fulfilled all requirements, you will obtain a new client ID which can be used in production.
Having difficulty graduating your app?
Please create developer support ticket if you experience issues during the app graduation process.
Update your client ID and server URL
Once you have successfully graduated your app, update your Embeddable application's clientId
and appServer
configuration parameters to point your application to RingCentral's production environment.