News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Search
Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
How to get/filter call recordings for a particular telephone number and date only
Tags: phone
Dec 21, 2020 at 3:13am   •   7 replies  •  0 likes
Matthew Herbert

Hi everyone

I hope you are all well in these uncertain times. I have successfully created a Windows Desktop app which can return the whole entire call log and all call recordings for all inbound and outbound telephone numbers. However please could someone help me by telling me (with a Postman example or similar if possible please) how I could pass a telephone number and dateTo and dateFrom parameter to the API (I assume with a GET command) so I can return ONLY the call log and call recordings for that particular telephone number (any calls with that telephone number involved, whether they are the calling party or the recipient) between the two dates? Do I pass any parameters in the postman BODY in a particular format? I have tried doing it as a querystring like this:

phoneNumber=123456789 as an example without success.

Thank you for any help. I really appreciate it.

7 Answers
answered on Jan 5, 2021 at 7:38am  

Unfortunately, the API does not support search for multiple telephone numbers. The only option for you is to change your app logic. First read the company call log with dateFrom and dateTo range and recordingType=All. Then keep all call records in an array and do a local search from the array.


 0
answered on Jan 5, 2021 at 8:20am  

One option would be to pull off the entire call log in one API request. This might work. However I have just noticed another issue. When I attempt to see the entire call log (by omitting the phoneNumber parameter) I can only see calls relating to myself and not for all users. I hadn't previously realised this because I was always using the phoneNumber querystring parameter before. The credentials used to logon are my own but I am the administrator user however the API appears to only be showing records for my inbound and outbound calls. Is there another user extension I need to enter for the API in order to get the complete call log for everyone?


 0
on Jan 5, 2021 at 8:31am   •  0 likes

To read the entire company call log, you need to login as an admin user, or a user with the read company call log user's permission (defined in a role assigned to that user extension). And call the company call log endpoint.

https://developers.ringcentral.com/api-reference/Call-Log/readCompanyCallLog

answered on Jan 5, 2021 at 6:01am  

Is there any way to search the call log for multiple telephone numbers in one API Get request? Currently, I am only able to use one phoneNumber querystring parameter in the URL for each API request. I can solve this by writing code to perform multiple API requests with a Get request each with a different phoneNumber parameter. The problem with this is I am now hitting a usage limit on the number of API requests! I have contacted the developer support team to remove or reduce the 60sec penalty since this is all due to the limitation of the API not allowing me to search for multiple telephone numbers in one go. However they haven't replied.

Our use-case is our CRM has to display all call recordings for each company. Each company can have multiple contacts, each with a different contact telephone number. My code loops through each contact telephone number, performs an API Get request to see if that telephone number appears in the call log, before moving on to the next contact telephone number, so ultimately the displayed page shows all call recordings for the whole company. I have also created a search facility for a CRM user to search the call log for a particular telephone number. However, I am finding after each page load or refresh the API stops all requests because it says too many requests have occurred and the front-end CRM user has to wait 60 seconds which is unacceptable. This is all due to the fact the API is limited in the respect it can only allow one phoneNumber parameter.


 0
answered on Jan 5, 2021 at 7:57am  

Hi thanks for your reply. The only way for me to read each company's call log is to look at the telephone numbers which belong to that company. There is no other way. My code loops through each telephone number for each contact which belongs to a company and puts it into a database so I can read it and search it as necessary. The only issue is compiling all the company's contacts' telephone numbers causes the API to hit a limit (which can easily happen when another user on our CRM is accessing the call log on another company record, which in turn will have multiple contacts. Hence why I need the usage limit "wait" or "retry_after" reduced from 60 seconds down to as close to zero as possible.


 0
on Jan 5, 2021 at 8:29am   •  0 likes

You know the purpose of the API rate limit (throttling), right? I don't think that increasing the limit is an option. Even in some special case, we can double the limit but it will not solve your problem as with your currently implementation, it is unpredictable and requires much more that that.

answered on Dec 22, 2020 at 3:08pm  

@Matthew Herbert If you see the call log API specification below:

https://developers.ringcentral.com/api-reference/Call-Log/readUserCallLog

I don't think you can pass phoneNumber multiple times that way


 0
answered on Dec 22, 2020 at 1:30pm  

@Anirban or anyone else please can you tell me if you know if it is possible to query the call log with two telephone numbers at the same time? Something like the following example:

https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/call-log?dateFrom=2020-12-01&phoneNumber=44123456789&phoneNumber2=895687456


Thank you for any help. Much appreciated.


 0
answered on Dec 21, 2020 at 4:05am  

I appear to have solved it myself. For anyone else who has the same question you simply append the GET command URL as follows:

https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/call-log?dateFrom=2020-12-01&phoneNumber=44123456789

Hope this helps others.


 0
on Dec 21, 2020 at 9:10am   •  0 likes

Add the "recordingType=All" filter to read only call records with recording.



A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us