question

jayakumar-i11287 avatar image
jayakumar-i11287 asked John Wang Deactivated answered

Will Webhook become inactive at any point after the successful subscription.

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 ?

webhooks
1 |3000

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

igor-bebin avatar image
igor-bebin answered
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 |3000

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

John Wang avatar image
John Wang Deactivated answered
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
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