Call Recordings

Last updated: 2024-01-31Contributors
Edit this page

Developers who wish to either download/backup or create an interface for users to listen to call recordings may do so using the Call Recording Metadata and Call Recording actions of the Call Log API resource.

If you do not already have a call recording created in your Sandbox account, you can do this manually.

Enabling Call Recording: Automatic vs On-Demand

RingCentral supports both Automatic Call Recording (ACR) and On-Demand Call Recording. Information on how to initiate Automatic and On-Demand Call Recording is available in KB Article 3171. Using WebRTC, it's also possible to programmatically initiate and stop recording per the WebRTC documentation.

How to create a call recording for testing in sandbox

For simplicity, we are going to step you through using the RingCentral unified app via the web to create an outbound call, and record that call.

  1. Open the RingCentral unified app sandbox via the web
  2. Click the Settings Icon, and choose Calling from the menu
  3. In the Calling Mode section, set the value to Direct Dial
  4. Close the settings dialog window
  5. Open the dial pad of your RingCentral Soft Phone, and dial your cellular device (or another outside number not associated with your RingCentral account)
  6. Answer the call when it is received on your outside line
  7. In the RingCentral Soft Phone, click the Record button. You will hear a notification that the call is being recorded
  8. Talk to yourself for the next 35 seconds. This is important as RingCentral does not retain recordings shorter than 30 seconds.
  9. Click the Record button a second time to stop recording, and then hangup the call to end it.

If you have followed all the steps above, you should now have at least one (more if you have done this before) call with a recording listed in the sandbox Admin Console's call log view. If you do not see this record in the Sandbox Online Account Portal, wait a few minutes and check again...occasionally there is some latency.

Next, use the Call Log API to obtain a list of calls in your account.

In the response from the Call Log API, any call with a recording will have a metadata recording property associated with it that looks similar to the following:

"recording": {
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/ACCOUNT_ID/recording/RECORDING_ID",
    "id": "RECORDING_ID",
    "type": "OnDemand",
    "contentUri": "https://media.devtest.ringcentral.com:443/restapi/v1.0/account/ACCOUNT_ID/recording/RECORDING_ID/content"
}

Of course, you can use the recordings[item].uri property to obtain the Call Recording Metadata as well, but that is redundant.

Obtaining Recording Content

You can now use the contentUri (notice that the subdomain is different in some cases as media... instead of platform...) to obtain the Call Recording Content.

Rate Limits

Please note that media resources may have different rate limit plans. Retrieving call recordings using the API is subject to throttling so please analyze the X-Rate-Limit-Group header to understand the limit to the call recording you are trying to retrieve.

Embedding Call Recordings in a Web Page

If you would like, you can use HTML5 supported browsers and the <audio> tag in a web page, and set the src property of the <audio> tag to the recordings[item].contentUri value (make sure to include the access_token query parameter with a valid access_token), and play back the recording in the browser.