News & Announcements User Community Developer Community

Welcome to the RingCentral Community

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

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
Retrieve forwarded calls
Tags: rest api, call logs, call forwarding
Sep 1, 2023 at 3:51am   •   1 replies  •  0 likes
Luisa Medina

I have an API that retrieves the company's call log. When I download the detailed report manually from the platform there is a column called Forwarded To that contains some calls that can be inbound or outbound. I want to retrieve those calls as well with the call log API that I already have (or identify those calls if they are already being retrieved). I am not sure that there is an additional API just for those calls (if so, the suggestion is welcomed too).

Any help here is appreciated.

1 Answer
answered on Sep 1, 2023 at 8:37am  

You referred to the call log data report from the service web portal (not the "platform" as you wrote), and the call log raw data from the API platform.

The call log data report from the service web is processed by the service web app. It parses the raw call data and displays only essential call data. It does not include other metadata such as the session id or the telephony session id etc.

The call log data returned from the /call-log API is raw data, which includes lots more metadata of a call record. However, there is no such a "Forwarded To" metadata in the raw call data. Instead, it is an internal routing and it has the same call record id, the same call session as the main incoming call.

So the "Forwarded To" leg is NOT a new call. It is not the same as "a "warm transfer" or a "blind transfer" call.

on Sep 5, 2023 at 1:52am   •  0 likes

Thanks for your answer. So, is there a parameter that I can use to retrieve the leg and be able to identify if the call was transfered? I am struggling to identify these calls from the raw data extracted using the call log API.

on Sep 5, 2023 at 8:55am   •  0 likes

A blind transfer call has the same call session as the original call. So it is basically the same call with 2 or several legs with the action result as "Call connected".

A warm transfer call has separate call session, the original session and the transferred session. So there are 2 different "Voice" call items on the report and one of the leg in that call has the "Action" as "Transfer".

As I wrote earlier, the report from the service web portal does not include call record id so you cannot use it to read the call log.

I don't know how and why you want to use the call log report from the service web and using the call-log API. But if you want to mix, you can use this app to download the call-log report (authenticated user must be a super admin user). The report from that app has similar call log structure to the one from the service web, plus it includes the record id and session id (and user site). You can use the record id to get the call log details using the call-log API.

on Sep 6, 2023 at 8:54am   •  0 likes

Hi Phong.

I am not trying to use both, I have in place a call report that was built using the call log API but we noticed that the numbers do not match with the call report we obtained using the report from the web service. The discrepancy in the numbers is because of the calls that appear on the web service report as Forwarded To and those calls are not being retrieved using the API. That is why we are trying to find a way to retrieve the calls so we can have an accurate call report.

I am attaching an image of how those calls look after downloading the report using the app you mentioned in the previous comment, I am trying to get those calls as well using the API.screenshot-2023-09-06-at-175404.png

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

Developer Platform
Integrated Apps
App Gallery
Developer support
Games and rewards

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