Fax Callbacks

Fax Callbacks are used as an alternative to the ReceiveInboundFax and ReceiveOutboundFax service methods, so that we will alert you when faxes are received or have completed sending, rather than you polling us for the data.

You will start out by configuring the settings in the web portal (Found under Settings>Manage account>Basic settings).  You will need to be a user who has api permissions (granted by our support team) to see this feature so if you have additional users who will need to set/manage this feature you’ll need to ask us to give them permission as well.

Once configured, you will receive fax callbacks for all faxes processed inbound and outbound for your account.

After you select Fax callback settings, you will begin by enabling the Callback Service

Next, you will choose a "Master API user"  from one of the API users in your organization  (meaning a user who you have generated API credentials for).  When we make the callback to your URL, we will pass an encrypted token along with the call based on this user's credentials, so that you can decrypt and verify that the call is valid and coming from us.  This will also be the user who is notified when/if a Callback fails.

Now you need to tell us where to send the callbacks.  You will specify for both inbound faxes and outbound faxes that have completed.   You can use the same URL for both.

Then you will configure the Fax callback attempt/interval Settings.  Here, for example,  we will make 5 attempts to send this callback.  If your server rejects our call, we will wait 2 minutes between each attempt, and then after 20 failed attempts we will suspend the Fax Callbacks.  When Fax Callbacks are suspended, we will notify the email address entered here, and we will hold any pending calls in a queue until the Callbacks are enabled again.

NOTE: Fax callbacks will time out after 15 seconds.  

The Log button allows you to run reports for the Fax callbacks for the API user on the account.

After you click the Log, you are given option to enter  Report type, Start Date and End Date and then click Submit

Which in turn will generate the following report. 

NOTE: We send the callback as an HTTP GET. Not a POST.

Here's a sample Fax Callback for an inbound fax.  Notice that the key value pairs are the same for both callbacks, so values will be blank if they are not related to either inbound or outbound faxes.  For instance, outfromfaxnumber does not apply to inbound faxing, and so it is blank.

https://testapi.sfaxme.com/api/testfaxcallback?token=0HiECdCWsySyY%2fEVE1%2bmzfZLTw6TtKLtd%2bn3Y3ipy0fKt7gGRREb1z%2bGvXFe%2bBTbxWj4DWoafF%2bJvHmaFDGOajdDhcZ%2fvlr8XcVdkRBuwAfWvITsx93eRUqEDsUYVu%2bC

&apikey=5787A4E0BCDE46F986D2E067AC70979C
&faxtype=1
&faxid=2150102030405000000
&faxsuccess=1
&faxpages=1
&faxdateiso=2015-03-06T23%3a59%3a04Z
&faxpwatermarkid=2150102030405999999 
&hasbarcodedata=
&intofaxnumber=1-5555551212  
&infromfaxnumber=1-5555551212  
&infromcpn=15555551212  
&infromcsid=Test+CSID  
&outtofaxnumber=  
&outfromfaxnumber=  
&outfromcpn=  
&outfromcsid=  
&outsendfaxqueueid=  
&outsendfaxtrackingcode=  
&outresultcode=  
&outerrorcode=  
&outresultshortdescr=  
&outresultdescr=  
&outfaxattempts=  
&istest=1

Here's one for an outbound fax:

https://testapi.sfaxme.com/api/testfaxcallback?token=0HiECdCWsySyY%2fEVE1%2bmzfZLTw6TtKLtd%2bn3Y3ipy0fKt7gGRREb1z%2bGvXFe%2bBTbxWj4DWoafF%2bJvHmaFDGOauyJGAhgJxtNOKGUvqY5Ljp5bUcD1Jh2sNxS9N%2fbaCbo

&apikey=5787A4E0BCDE46F986D2E067AC70979C
&faxtype=0
&faxid=2150102030405000000
&faxsuccess=1
&faxpages=1
&faxdateiso=2015-03-07T00%3a00%3a10Z
&faxpwatermarkid=2150102030405999999
&intofaxnumber=
&infromfaxnumber=
&infromcpn=
&infromcsid=
&outtofaxnumber=1-5555551212
&outfromfaxnumber=1-5555551212
&outfromcpn=15555551212
&outfromcsid=Test+CSID
&outsendfaxqueueid=CEBC27A1AFB049D983B3660F698DB34D
&outsendfaxtrackingcode=Tracking+Code
&outresultcode=0
&outerrorcode=0
&outresultshortdescr=OK
&outresultdescr=OK
&outfaxattempts=1
&istest=1