From Kolmisoft Wiki
Jump to navigationJump to search


This feature allows the user to receive a normal fax and get it to email in PDF format. The following image shows the common implementation of the Fax2Email functionality:

Fax2mail schema.png

NOTE: Fax over VoIP does not work reliably and should only be used for testing purposes.


In order to start using this feature, Fax device enabled should be checked in SETTINGS -> Setup -> Settings –> Functionality.

When it's enabled, you need to create a device and make it FAX type. This can be done in Device Settings:

Devices fax.png

When a device's type is FAX, it is marked as a FAX device everywhere with the icon Icon fax.png.

Since MOR12 there is an option to choose a server for a fax device.

Then you need to add the email address or addresses to which the received fax should be sent. You can enter unlimited addresses.

When the fax device has been created, you have two possibilities for using it:

  1. It is possible to route a call directly to the fax device.
  2. You can use fax-detection, so that when a fax is detected, it will be routed to the fax device. If it is not detected, it is routed to a normal device.

The second choice lets you save one DID by receiving calls and faxes on the same number.

The first method is very easy to implement – you just need to assign the FAX device to a DID:


When you want to do fax-detection, you need to set this in a device's Call Flow. In the Before Call state:


Here, when a call comes, the system will try to decide whether it is a fax. If it decides that it is, the call is routed to the FAX device and sent to the appropriate email addresses. If the call is a simple call, it is sent to an IAX2/101 device.

For received faxes and various statistics, check Fax statistics in the STATISTICS - Various - Faxes section:



This report show all information about faxes received (or not received). It can be found in STATISTICS – Various – Faxes:

Faxes stats1.png

All users are visible here. A fax can have three states:

  • Received – everything okay with this fax. It's been received and sent to the appropriate email addresses.
  • Corrupted – the fax has been received but is corrupted. It cannot be to sent to an email address.
  • Mistaken – this was simple call to a fax number, not a fax.

You can click on a number for each state to get a list of these faxes:

Faxes stats2.png

Clicking on Icon pdf.png, you can get this fax in PDF format.


Fax Devices only support G.711 A-law and G.711 u-law codecs, both are enabled and not editable, you can adjust their priority by dragging them.

Fax codecs.png

Email Template

Available from MOR X17.

Email template for Fax2Email is named: fax2email


  • All converting from the received .tif format to pdf is done by KOLMISOFT writtent agi script which basically performs this command:
/usr/bin/tiff2pdf -o pdf_file, tif_file
  • Sometimes new changes are brought to AGI scripts in order to improve them. So and update might also solve problems.
  • Check log file: /var/log/mor/fax2email.log or /var/log/mor/fax2email.log (in newer versions) for more details
  • If tif file size is 0 - that means that fax failed

See also: