question

Help Center avatar image
Help Center asked Help Center commented

Fax Webhook Events

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.

webhookssubscription
1646264112535.png (49.3 KiB)
1 |3000

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

1 Answer

Phong Vu avatar image
Phong Vu answered Help Center commented

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.

5 comments
1 |3000

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

Help Center avatar image Help Center commented ·

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

0 Likes 0 ·
Phong Vu avatar image Phong Vu ♦♦ Help Center commented ·

You can call this endpoint and check the permission info.

0 Likes 0 ·
Help Center avatar image Help Center Phong Vu ♦♦ commented ·

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.

0 Likes 0 ·
Show more comments

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