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
Will Webhook become inactive at any point after the successful subscription.
Tags: webhooks
Aug 14, 2018 at 12:44am   •   2 replies  •  0 likes
jayakumar-i

Let's say I have a webhook subscribed at the RingCentral for receiving the call events. I am successfully receiving the call events. I want to know if the webhook will become inactive / blacklisted at any point after the successful subscription? If so, what could be the reasons for that ?


If it becomes inactive/blacklisted, how it can be reactivated again ?

2 Answers
answered on Aug 15, 2018 at 9:44am  
As mentioned by Igor, a WebHook can become blacklisted when the endpoint is unresponsive.

For me, this can happen when I'm doing development on my laptop and I shutdown the service and/or laptop. To deal with this, I built a small command line app that will list subscriptions and "recreate" them with the same endpoint if they become blacklisted (create a new one and delete the old one) so you can move forward to development instead of waiting for a webhook to get off the blacklist. You can get this here:

https://github.com/grokify/rchooks

 0
answered on Aug 14, 2018 at 1:59am  
Hi Jayakumar,

Yes, we have blacklisting rules for Webhooks, since Webhook subscription has pretty long expiration period (up to 15 years).

There are several requirements to your Webhook URL:
  1. It's available on the Internet
  2. It can respond within 3000 milliseconds 
... and some other, specified in
http://ringcentral-api-docs.readthedocs.io/en/latest/notifications_webhooks/

If WebHook url doesn't meet above requirements during 10 minutes subscription became blacklisted. Subscription became Active during reconcilation (every 15 minutes) if WebHook url became valid.

blacklistedData is available for blacklisted WebHook subscriptions, you can retrieve it as part of Subscription List API response, see https://developers.ringcentral.com/api-docs/latest/index.html#!#RefGetSubscriptionList

E.g.
"blacklistedData": {
"reason": "Webhook responses with code: [404], reason: [Not Found]",
"blacklistedAt": "2018-08-03T12:44:03.105Z" 
}
Thanks,
Igor

 1



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