Custom routing for outgoing faxes and audio messages (Built-in lines)

Parent Previous Next

The Custom Routing Method (Built-in lines) allows you to easy add any routing functionality by using custom application that is started after sending a fax or audio message. 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 outgoing faxes and audio messages through multiple routing methods. These routing methods can include, but are not limited to: printing faxes, storing faxes and audio messages, converting fax graphic images to text files, delivering faxes and audio messages 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 (Built-in lines), Fax Voip starts the application, specified by the customer, after sending a fax or audio message. 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 or audio file and other important parameters, such as Recipient Number, Sender Fax ID (TSID), Recipient Fax ID (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 outgoing fax (TIFF, PDF or SFF file) or audio message (WAV file) and the folder in which this file is placed. Custom Application is started using the current user account or the Local System account (if Fax Voip is running as a Windows service), so the corresponding 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 sending a fax or audio message

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

Create temporary copy of the sent fax in the following format:

If you select this option, the method creates a temporary folder (subfolder in the %temp% folder for the current user account or the Local System account) and copies the outgouing fax (TIFF, PDF or SFF file depending on your choice) into this folder. The temporary folder (%temp%) for the current user account is usually C:\Users\<Account Name>\AppData\Local\Temp\. The temporary folder for the Local System account is usually C:\Windows\TEMP\. The path to the temporary fax file is passed to the custom application via FileName command-line argument. The custom application is responsible for deleting the temporary fax 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 outgouing fax.

Create temporary copy of the sent audio message

If you select this option, the method creates a temporary folder (subfolder in the %temp% folder for the current user account or the Local System account) and copies the outgouing audio message (WAV file) into this folder. The temporary folder (%temp%) for the current user account is usually C:\Users\<Account Name>\AppData\Local\Temp\. The temporary folder for the Local System account is usually C:\Windows\TEMP\. The path to the temporary audio file is passed to the custom application via FileName command-line argument. The custom application is responsible for deleting the temporary audio 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 outgouing audio message.

Enable custom routing

If you select this option, the Fax Voip software applies the Custom Routing Method (Built-in lines) for all outgouing faxes and audio messages sent using Fax Voip Console application (via built-in VOIP/ISDN Fax/Audio Lines).