Developing in Sandbox

Last updated: 2020-09-02 Contributors Byrne Reese
Edit this page

RingCentral provides developers with both a Sandbox and Production environment in which to develop and test your app. Upon creating an application, a sandbox account is generated automatically if you do not already have one.

Access to the production environment is made available after your application has been reviewed and approved. As a result, sandbox accounts are required in order to develop your application. That being said, sandbox accounts come also with the following benefits:

  • Data Segregation - developers are free to make additions and changes without fear of littering the production account with test and dummy data.
  • Change Control - developers are free to create and develop applications in sandbox without fear of interfering with applications safely running in our production environment . This is especially important for our HIPAA-compliant customers.
  • Cost - API calls to our sandbox environment are not metered, or count against any allottments your account may be limited by.
  • Compliance - by requiring developers to apply for access to production, we can put in place steps to reduce the risk of developers unknowingly violating our company's EULA or TOS.

Sandbox URLs

Product URL
Glip https://glip.devtest.ringcentral.com
RingCentral Account Portal https://service.devtest.ringcentral.com
RingCentral API https://platform.devtest.ringcentral.com

Please note: Glip App (mobile or desktop) does NOT have:

  • Support for the RingCentral Sandbox API (cannot switch to 'developer mode')
  • Support for a 'Sandbox version'

How Sandbox Accounts Are Organized

Sandbox accounts are currently shared across all users within the same account. We do not currently support creating multiple user level Sandbox accounts within a single RingCentral account. Within that account, developers can easily collaborate on the applications created within that account.

If you need to simulate two different users from two different organizations during development, you may need to create additional RingCentral accounts in order to do so.

Limitations

In order to ensure that our sandbox environment is used for testing purposes only, we add the following watermarks to messages and voice calls eminating from that environment:

  • SMS (Inbound/Outbound) - a text watermark of "Test SMS using a RingCentral Developer account"

  • Voice calls (Inbound/Outbound) - a voice watermark of "Test call using a RingCentral Developer account"

  • Faxes (Outbound) - an image watermark of "Test fax using a RingCentral Developer account', for example:

Configuring Sandbox

To configure your Sandbox environment please follow the steps:

  1. Go to https://service.devtest.ringcentral.com

  2. Login with your sandbox account username (main company number) and password that are available on your App page:

    • in 'Sandbox Credentials' section on the 'Dashboard' tab (see above);
    • in 'User Account Credentials' section on the 'Credentials' tab (see below)

  3. Configure your user account phone system to emulate your target user environment:

    • set auto-receptionist and company info;
    • add extensions and phone numbers;
    • add and set devices;
    • etc.

    For more details please visit our Learning Center.

Your Sandbox account is now ready to be used. You can now direct API calls to https://platform.devtest.ringcentral.com.

Deactivation of idle sandbox accounts

Use it or lose it

Sandbox accounts are provided to developers completely free of charge. As long as a sandbox is in active use, developers can rely on the sandbox being available. However, if a sandbox account becomes idle for 90 days within an account, we will deactivate the sandbox account in order to put those phone numbers back into circulation for others to use.

What happens if I lose access to my sandbox?

If you find yourself in the circumstance where your sandbox account has been deactivated, you can easily create a new one by following the prompts inside of the Developer Console.

Once the new sandbox account has been created then you may need to update the configuration of any apps that connect to your sandbox account, as your authentication credentials may have changed.