stephen-godfrey107 avatar image
stephen-godfrey107 asked ak commented

How do I get access to pull call recordings?

How do I get access to pull call recordings for my sandbox application? The API docs say I need the "ReadCallRecording" permission, but I can't give myself that permission (it isn't there).

The API call to pull recordings is part of the heavy group. But we would like to pull all our recordings so our users can listen to their calls. Any suggestions on the best way to do this so we don't hit the throttle limit? Do I just build a queue that will eventually pull all the recordings one-by-one?

rest api
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

1 Answer

ak avatar image
ak answered ak commented
Hi Stephen,

Call-recording permissions are added to an application on Demand.  We would send you a form, kindly fill it and we would add the permission to your application. 

You can retrieve the call log for all the extensions and using the contentUri value of the call log response under recordings" you should be able to download the call recordings. 

"id": "IXPCm_tIkCduk4I",
"sessionId": "404412141008",
"startTime": "2015-06-25T14:57:30.000Z",
"duration": 60,
"type": "Voice",
"direction": "Inbound",
"action": "Phone Call",
"result": "Accepted",
"to": {
"phoneNumber": "18772160007",
"name": "Something New"
"from": {
"phoneNumber": "18882400004",
"name": "Something New"
"recording": {
"uri": "https.../restapi/v1.0/account/401190149008/recording/401547458008",
"id": "401547458008",
"type": "OnDemand",
"contentUri": "https.../restapi/v1.0/account/401190149008/recording/401547458008/content"
   "uri": "https.../restapi/v1.0/account/401190149008/extension/401190149008/call-log/IXPCm_tIkCduk4I?view=Simple", 

But if you want specific call recordings you could use our "Call Recording" API , please have a look at our documentation here :!#RefCallRecording.html

But it all depends on how frequently you would want to pull the call recordings : 

  • If you are planning to pull the call recordings in between long intervals you could use call-log API to retrieve contentUri and schedule a job to pull the recordings for all
  • If you plan to pull the call recordings  in between short intervals you should use the Active call API :!#RefExtensionActiveCalls.html ( this API call returns the recently finished call log records as well as the ongoing call records )

Please have a look at the code included in the demo.js file here :

The call recordings are returned as a blob object which should be converted to an audio/mpeg format within your application. 

1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

riley-clegg145 avatar image riley-clegg145 commented ·
How do we request the "form" to get access to "ReadCallRecording" for sandbox and eventually production?

Thank you
0 Likes 0 ·
ak avatar image ak commented ·

Hi Riley,

At the moment to enable "ReadCallRecording" permission on the application, you should raise a request addressing the issue by submitting a support ticket to the developer support team and our team would enable the permission on the application on the request.

0 Likes 0 ·

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys