Fax2Email

Definition

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:

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

Setup

In order to start using this feature, Fax 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:

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

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:

Stats

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

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:

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

Troubleshooting

• 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:

• Fax over VoIP