Custom routing for incoming faxes

Parent Previous Next

The Custom Routing Method defined by the Fax Voip FSP Routing Extension allows you to easy add any routing functionality by using custom application that is started after receiving a fax. The using of this method is not limited by the current licences.


This method provides software vendors with a flexible way to connect software applications that route received fax transmissions through multiple routing methods. These routing methods can include, but are not limited to: printing faxes, storing faxes, converting fax graphic images to text files, delivering faxes in electronic mail attachments etc. The software vendor is responsible for developing functions of the method, for creating graphical user interface (GUI) to configure the rules and other settings, and for storing the configuration.


When executing Custom Routing Method (Fax Voip FSP Routing Extension), the Windows Fax Service starts the application, specified by the customer, after receiving a fax. The command line passed to an application is predefined and contains all the necessary information. The developer of the custom application can parse the command line in his application to obtain the path to the fax file (TIFF) and other important parameters, such as CallerID, Called Number (DID), TSID, CSID etc. and then do any necessary actions. The custom application must be terminated automatically after execution. The application is responsible for deleting the temporary copy of the received fax (TIFF file) and the folder in which this file is placed. Custom Application is started using the Network Service account, so the Network Service account must have necessary access to files, folders and other objects with which your application works. See more details in the Custom Application Requirements (Developer's Guide) chapter of this user manual.



Custom application that should be started after receiving a fax

Here you can choose the application that will be started after receiving a fax. You can browse to a preferred executable file or enter the file path. The example of the custom routing application (RouteCustom.exe) can be found in the Fax Voip FSP installation folder, usually C:\Program Files (x86)\FaxVoip FSP\RouteCustom.exe. See also in the Custom Application Sample chapter of this user manual.

Create temporary copy of the received fax (TIFF file)

If you select this option, the method creates a temporary folder (subfolder in the %temp% folder for the Network Service account) and copies the received fax (TIFF file) into this folder. The temporary folder (%temp%) for the Network Service account is usually C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\. The path to the temporary TIFF file is passed to the custom application via TiffFileName command-line argument. The custom application is responsible for deleting the temporary TIFF file and the temporary folder in which this file is located. If this option is not checked, the method does not create the copy of the received fax, but the custom application can still access the received fax by using Fax Service API functions (based on Job ID parameter that is also passed via command line).

Enable custom routing

The Fax Voip FSP software automatically enables or disables the Custom method (Fax Voip FSP Routing Extension) for all Fax Voip Line devices, depending on whether this option is checked or not.