Developer Platform, APIs, & Integrations

In the developer sandbox a Ringout call rings the Softphone, there is no physical desktop phone.But when there is a softphone and a desktop phone only the desktop phone is ringing for me.Other incoming calls ring both the desktop and the softphone.

I am trying to make a ringout call using the ringcentral API. The request body I am passing is like this :{ "to": {"phoneNumber": "91*******"},"from": {"phoneNumber": "91*******"},"callerId": {"phoneNumber": "91*******"},"playPrompt": true}The response I am getting is :{ "message": "Forbidden", "errorCode": "InternationalProhibited" }The same call when I try to make with the ringcentral account is successful. Can u tell me what's wrong with that.

This is more of a feedback than a problem report.I've been working on a Web app that sends SMS using your PHP SDK. However, I noticed that the way an error comes back to me is a bit unexpected.When I forget to include SMS text, I would expect either 1) the SMS to be sent with empty body or 2) the error be included in the '$response' response per your suggested code here: https://github.com/ringcentral/ringcentral-phpBut instead, I get a "Fata Error" response that overwrites my calling PHP, like this:"Fatal error: Uncaught exception 'Exception' with message 'Response has unsuccessful status' in /home/mozartdl57/acmemedical.org/lib/RC/http/Request.php:171 Stack trace: #0 /home/mozartdl67/acmemedical.org/lib/RC/platform/Platform.php(221):

I'm also writing an app that can pull call logs from my company's account. However, I believe call log access is limited to a user's own call logs unless the logged in user has admin privilege.I want to throw up a message to my users so they know what their call log access scope is based on whether or not they're an admin. Is there an API that tells me this? Thanks

I'm writing an app where users are asked to input a phone number to send SMS to. I'd like to store that number in a standard format like E164, without the suer having to type in dashes, brackets, and country codes. Is there a piece of JS code that someone can share? Thanks.

We have recently added our call records to the sandbox and are now trying to retrieve the call logs via the API; however, I am getting the following result saying there are 0 records. Can you tell me if call logs are available via API as soon as they are created?Thank you,{ "uri" : "https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/call-log?view=Simple&dateFrom=xxxx-xx-xxT00:00:00.000Z&page=1&perPage=100", "records" : [ ], "paging" : { "page" : 1, "perPage" : 100 }, "navigation" : { "firstPage" : { "uri" : "

How might we mark a voicemail as read (or any type of message for that matter)?Currently, the light still blinks on my desk phone until I either read it on an app, online, or delete the message.

When I get the active calls for a user, it has calls that are not still active. For example, a call that finished a few minutes ago might still be on it. Any idea why this might be?Thanks :)

Before you bring your app integration with RingCentral to production, you will probably want to test it. RingCentral provides developers with a Sandbox environment for testing their integrations. In order to use it, you will need a Sandbox Account, which is just like a regular RingCentral Account, but it is used for testing purposes.You can find your Sandbox Account credentials by following here. RingCentral Sandbox Accounts use real telephone numbers, this is why we only allow one Sandbox Account per developer organization.To configure your Sandbox Account (i.e. create extra extensions, add telephone numbers, etc.), please use the Sandbox version of our servise web site: https://service.devtest.ringcentral.com (and u

Once you've registered your application at the RingCentral for Developers portal, you may notice that it has two statuses: Sandbox status and Production status.All applications are Active in Sandbox by default, which is sufficient for testing them in the RingCentral Sandbox environment. Before a production key is issued and approved for an app, it is considered Blocked in Production.In order to become Active in Production, you need to receive an active production app key. When your app is Active in Production, you are able to use your RingCentral integration with live RingCentral accounts.Sometimes your application can get

To handle possible access or authentication exceptions that may occur while the application is running (after the user has successfully logged in), you can provide a handler for the accessViolation platform event.platform.on(platform.events.accessViolation, function(e){ // do something });A recommended way to handle access or authentication exceptions is to direct the user to the login page or UI. The login page may attempt to automatically re-authenticate the user using stored authentication data (see below).

To log in to RingCentral, get the Platform object and call its authorize method, providing valid username, extension, and password values. Enter your phone number in E.164 format for username. The + may be omitted.A Promise is returned, and you can use its then method to specify your continuation function, and its catch method to specify an error handling function.var platform = rcsdk.getPlatform();platform.authorize({ username: '+18001234567', // your phone number in E.164 format extension: '101', // leave blank if direct number is used password: 'yourpassword' }).then(function(ajax) { // your code here }).catch(function(e) { alert(e.message || 'Server cannot authorize user'); });

If you need help configuring the SalesForce app with HTTPS please read this knowledge base article.

In order to get started using the RingCentral for Developers platform please follow the following steps:First access our Developer Portal and read our documentation and tutorials after logging in with your corporate RingCentral account which has been enabled for you.Familiarize yourself on how to use test accounts in the RingCentralSandbox through this tutorial including setting up your desktop phone todo testing. Also learn how to get started with OAuth 2.0 (see also How to Use Test Accounts in the RingCentral Sandbox,

The SDKs package RingCentral APIs into easy-to-use libraries for each programming language.Often, you can handle all interaction with the RingCentral API using methods provided in the SDKs without ever needing to learn more about the lower level details of the API communication itself.Any communication between an external program and RingCentral is performed through one of our APIs. The APIs are agnostic to development platform and language, allowing you much more flexibility.RingCentral provides documentation for each API we offer. The documentation has details on each API call, including required fields and response details. For a complete list of the RingCentral APIs, visit here.For Python programmers here is our

You may want to know the status of a call while it's in progress. Here is an example of how to do that:function update(next, delay) { if (!rcsdk.getRingoutHelper().isInProgress(ringout)) return; platform.apiCall(rcsdk.getRingoutHelper().loadRequest(prevRingoutData)) .then(function(ajax) { // also save ajax.data as, for example, prevRingoutData console.log(ajax.data); // updated status of ringout timeout = next(delay); // you can increase delay here }) .catch(handleError); } var timeout = rcsdk.getUtils().poll(update, 3000); // stay in RPS limits To stop polling: rcsdk.getUtils().stopPolling(timeout);

We have provided an interactive API explorer (currently in BETA) on Github and you can very quickly learn how to authenticate using OAUTH, retrieve call logs, make or accept calls, and subscribe to notifications.Please visit the API Explorer, however you have to have proper credentials from RingCentral.If you have not received your credentials please read the Welcome to RingCentral for Developers article here.

The RingCentral API allows to initiate a 2-legged RingOut call programmatically.From the users perspective it will work in a similar way as the RingOut feature on the RingCentral Web Site (more details about RingOut feature can be found here).The API accepts the phone number where caller wants to pick the call, the called party number and optionally a caller ID. More details and examples can be found in the RingCentral API documentation

The SDKs package RingCentral APIs into easy-to-use libraries for each programming language.Often, you can handle all interaction with the RingCentral API using methods provided in the SDKs without ever needing to learn more about the lower level details of the API communication itself.Any communication between an external program and RingCentral is performed through one of our APIs. The APIs are agnostic to development platform and language, allowing you much more flexibility.RingCentral provides documentation for each API we offer. The documentation has details on each API call, including required fields and response details. For a complete list of the RingCentral APIs, visit here.If you prefer to code in JavaScript we have an extensive SDK for you available.Its key benefi

Welcome to RingCentral for Developers! You can integrate with our platform within a very short time and see your app working with RingCentral. But first let's get you acquainted with setting up your own test environment.You have to initially login to the RingCentral Developer portal and create your sandbox account then a step-by-step tutorial is available for you to guide you through setting up yourtest accounts.It covers:Creating and configuring a sandbox test accountRunning API requests on sandboxConfiguring your RingCentral for Desktop ApplicationMigrating your application from sandbox to productionMore about your RingCentral Sandbox can be found here.

If you are needing to integrate with your CRM system for instance to be able to use RingCentral communication services in order to receive or initiate calls, update your customer database and present relevant customer data about an incoming call to your employees, we have written just a tutorial that.Welcome to the RingCentral CTI Developer Tutorial. This tutorial uses the RingCentral JavaScript SDK.This extensive tutorial helps you understand how to docall management like monitoring incoming calls, performing Ringouts, and viewing call logs.For more information please read here.