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
Fax Webhook Events
Tags: webhooks, subscription
Mar 2, 2022 at 3:37pm   •   1 replies  •  0 likes
Help Center

Hi,

I am using the RC Javascript library (v4.7.0). Our app graduated from sandbox to production. Our integration with RC currently uses webhook subscriptions. We successfully tested these integrations from our sandbox with no issues.

Once we moved to production, we were able to subscribe to the Account Telephone Session event. This works as expected. However, we are not getting Inbound Fax Events.

The inbound fax subscription is set up through the event filter:

/restapi/v1.0/account/~/extension/~/fax?direction=Inbound

Based on my understanding, this subscription would capture all faxes received by users under our account and trigger the webhook.

However, this is not happening. As it stands, we are only able to trigger the webhook by sending faxes to the sandbox phone number.

If we pull our subscriptions, we can see it:

1646264112535.png

Are we doing something wrong?

We are trying to automatically download and forward incoming faxes to the intended recipient through our own system.

Our app client id is g_qij6n3RAqIijYDyLWN5w.

1 Answer
answered on Mar 3, 2022 at 8:09am  

First of all, don't waste your resource by creating separate subscription for each event type. Instead, you should add multiple event types into the eventFilters array and make just one subscription.

eventFilters: [
    '/restapi/v1.0/account/~/extension/~/fax?direction=Inbound'
    '/restapi/v1.0/account/~/telephony/sessions',
    ...
    ],

When you receive the notification event, simply detect the event type by checking the value of the "event" the process the payload accordingly.

To your question, I just make a quick test and Fax notification works as expected. I see you specified the extension id in your event filter, is that the extension id of the authenticated user who subscribed for the notification? If it is not or you don't know, then try with the tilde and send a fax to the user who logged in the app. If you expect to receive inbound faxes notification for other extensions than just the authenticated user, authenticate your app with the super admin user.


 0
on Mar 3, 2022 at 2:16pm   •  0 likes

How can I find out who the super admin user under our account?

on Mar 3, 2022 at 2:19pm   •  0 likes

You can call this endpoint and check the permission info.

on Jun 8, 2022 at 2:23pm   •  0 likes

Phong,

Thanks for the info, just circling back to this. I have verified that I am authenticated with the super admin user.


We are still unable to get faxes to the webhook for all users.


We are only able to get faxes to the webhook from faxes to the authenticated user.


The event filter we specify is:

  1. /restapi/v1.0/account/~/extension/~/fax?direction=Inbound


Are you unable to get faxes from other users under the same account (different extensions) when authenticating with the super admin user? We authenticate using a JWT that was created with the super admin user.

on Jun 8, 2022 at 3:43pm   •  1 likes

To receive fax notifications for other extensions, you have to subscribe for the fax notification using their extension ids.

Read your account extensions, parse the response and grab each extension id (of those extensions you want to receive their fax). Then specify the event filters as follows:

eventFilters: [
    '/restapi/v1.0/account/~/extension/[extensionId-1]/fax?direction=Inbound',
    '/restapi/v1.0/account/~/extension/[extensionId-2]/fax?direction=Inbound'
    etc.
    ],
on Jun 10, 2022 at 5:35pm   •  0 likes

Phong,

This was exactly was I was looking for. Thanks for all your help! Works like a charm now.



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