Difference between revisions of "Fax2Email"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 11: Line 11:
= Setup =  
= Setup =  


In order to start using this feature, it should be enabled in Settings – Functionality – Fax enabled.
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 it's enabled, you need to create a device and make it FAX type. This can be done in Device Settings:

Revision as of 12:52, 1 December 2011

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:

Fax2mail schema.png


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:

Fax2email1.png


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

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:

Fax2email2.png


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

Fax2email3.png


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:

Fax2email4.png

Stats

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.




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: