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 long does a ringout ID live for?
Tags: ringout
Sep 21, 2016 at 3:02pm   •   1 replies  •  0 likes
janielle

Firstly, ringout is working correctly, it dials two numbers and connects them together successfully.


When I send a POST request to the Ringout REST API endpoint, I get a ringout ID back. I then use this ringout ID and issue a GET request every few seconds to track when both parties have answered there calls. ( I am aware of webhooks, but webhooks don't give me the callee's status)


{  
"uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/XXXX/extension/XXXXXX/ringout/XXx";,
  "id": xxx,
  "status": {
    "callStatus": "Success",
    "callerStatus": "Success",
    "calleeStatus": "Success"
  }
}


I use this same polling technique to work out when either party has disconnected from the call.

{  
"uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/xxxx/extension/xxxx/ringout/xxxx";,
  "id": xxx,
  "status": {
    "callStatus": "CannotReach",
    "callerStatus": "Finished",
    "calleeStatus": "Finished"
  }
}


I noticed that the ringout ID only lives for about 30 seconds, after this time when I send a GET request I get this response even though the phone call is still taking place.


{  
"errorCode": "CMN-102",
  "message": "Resource for parameter [ringoutId] is not found",
  "errors": [
    {
      "errorCode": "CMN-102",
      "message": "Resource for parameter [ringoutId] is not found",
      "parameterName": "ringoutId"
    }
  ],
  "parameterName": "ringoutId"

}


Is this the expected behaviour for a ringout call, does the ID disappear after 30 seconds, even though the call is still active?



1 Answer
answered on Sep 21, 2016 at 3:33pm  
Ringout ID lives until both call legs are established (or canceled). You cannot use this ID to check the status of a call which is already connected to both parties or to cancel already connected call.

In order to monitor status of an established call you should use our presence notifications.

 0



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