question

one3521 avatar image
one3521 asked benjamin-dean commented

Controlling the number of fax retries using API

Is it possible to control the number of retries when faxing using API?

Is it possible to control the amount of time between retries?

We are posting the jobs using: /restapi/v1.0/account/~/extension/~/message-store/

rest apifax
1 |3000

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

anton-nikitin avatar image
anton-nikitin answered
Unfortunately not. This logic is the same for all accounts and cannot be configured by any means.
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 benjamin-dean commented
If you are interested in increasing the number of retries, you can use our API to resend faxes. The same API call can also forward faxes.

You can see more information in our documentation here:

http://ringcentral-api-docs.readthedocs.io/en/latest/messages_faxes/#forwarding-and-resending-faxes
6 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.

benjamin-dean avatar image benjamin-dean commented ·
Have you attempted to look in the Call Log for the respective record of type 'fax'? When an outbound fax request is sent, you can then view the extension's activeCalls which is sending the fax. This can be done for one or more extensions and returns activeCalls data  https://developers.ringcentral.com/api-docs/latest/index.html#!#RefGetExtensionActiveCalls. You could filter the activeCalls records where action==='Outgoing Fax'.

The associated result property for the activeCall should provide you with much greater detailed information about what actually happened during fax transmission:
'Unknown' | 'ResultInProgress' | 'Call accepted' | 'Rejected' | 'Received' | 'Receive Error' | 'Fax on Demand' | 'Partial Receive' | 'Blocked' | 'Call connected' | 'No Answer' | 'International Disabled' | 'Busy' | 'Send Error' | 'Sent' | 'No fax machine' | 'Restricted Number' | 'Wrong Number' | 'Stopped' | 'Hang up' | 'Poor Line Quality' | 'Partially Sent' | 'International Restriction' | 'Abandoned' | 'Declined' | 'Fax Receipt Error' | 'Fax Send Error'
1 Like 1 ·
one3521 avatar image one3521 commented ·
It makes sense to resend a fax when the fax status of the previous attempt is Busy, but right now we have a terrible hard time trying to find from you how to obtain the extended fax status from the Call Log based on the Message ID. When using the Message ID (/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/{messageId}), all we get is "SendingFailed" and this is all. Only the Call Log contains the details like "Busy", but it seems there is no link between a specific Message ID and its corresponding Call Log. Please advice.
0 Likes 0 ·
benjamin-dean avatar image benjamin-dean commented ·
The call log response body contains a few properties which are helpful in this situation:
- id: The ID of the call log entry for the outbound fax (you can filter the call-log on dateFrom=creationTime, direction=Outbound, and type=Fax)
- messageStatus: One of: 'Queued'. 'Sent', 'SendingFailed', 'Received'
- lastModifiedTime: When the messageStatus was last changed
- creationTime: When the fax was created

When you say "Extended Fax Status", which properties are you seeking specifically?

What use case are you trying to solve please?
0 Likes 0 ·
one3521 avatar image one3521 commented ·

We are facing the following problem: we are sending more faxes to the same fax number in a short amount of time (it could be 4 - 6 fax jobs in 30 sec - 1 min). RingCentral starts sending the first fax to that number which usually takes somewhere between 2 and 4 minutes to be received at its destination. But while the designee is receiving this fax, RingCentral is trying to send to the same number the rest of faxes from queue and, as expected, the line is busy receiving the first fax.

Because RingCentral is not performing its own queue management when dealing with the same number and because it is not allowing us to change the number of retries (as Anton mentioned) we want to try performing the queue management on our side. In order to do this, we should put on hold the rest of the fax jobs that will be sent to the same number until the first fax is successfully sent. But we also need to take into account the fact that also the first fax could fail for a lot of reasons like: line is busy for other reasons, line is not available, the number is wrong and so on. Because we didn't find how to obtain from the call log the detailed statuses (like Busy, No Answer, Wrong Number etc.) for a specific Message ID, we get only MessageStatus: 'Sending Failed' and faxErrorCode: 'Undefined' while the CallLog contains 'No Answer' or 'Busy'. And 'Sending Failed' + 'Undefined' is not helping us so our question is: how to obtain those 'No Answer' or 'Busy' from the CallLog based on a MessageID if the MessageStatus and faxErrorCode do not provide them?

Let's focus on the 'Busy' case as long as this is our main problem. How can we obtain this status?


0 Likes 0 ·
benjamin-dean avatar image benjamin-dean commented ·
Since the flow is controlled from your application code, I would recommend queuing the faxes to the same number until such time as you receive a "Sent" (sending success) message from an initial attempt to a number.
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