question

Raymond Camden avatar image
Raymond Camden asked Raymond Camden answered

Issue with API docs for call log (maybe)

Ok, before I begin, is this the best place to report a (possible) developer related bug? If not, please let me know.


The API docs for call log (https://developers.ringcentral.com/api-reference/Call-Log/readUserCallLog ) mention a "recording" response. Is this something that only exists if a call recording was made? Neither sample data set below shows it.

Secondly, "message" as a response is not documented. It is shown in Example 1, and I get it in my tests, but it isn't documented.

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.

Byrne Reese avatar image
Byrne Reese answered

A recording element will only be returned for those calls that contain a recording. In other words, the presence of the element indicates a recording exists for the call.

Here is more information about how to access call recording data: https://developers.ringcentral.com/guide/voice/call-log/recordings

Regarding the "message" element... can you provide a sanitized sample output so that I can see it in context, and I will follow up with the team that maintains the API reference?

1 |3000

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

Phong Vu avatar image
Phong Vu answered Phong Vu edited

The existence of the "message" element is similar to the "recording" element existence, except it is for a call record with a voicemail or a fax.

You can read this blog to find out more about reading the call log

https://medium.com/ringcentral-developers/visualize-your-business-communications-history-2c81f85c324a

1 |3000

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

Raymond Camden avatar image
Raymond Camden answered

Thank you Phong (both of you) - but is it a documentation bug that message isn't shown in the API docs?

1 |3000

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

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