|This wiki is for faxing with the commercial Fax Pro. If you are looking for the standard (non-commercial) fax options, please visit the Fax Configuration wiki.|
|Table of Contents|
What does this module do?
Fax Pro is a commercial add-on that enhances the built-in fax capabilities of your PBX. With the commercial Fax Pro module, users can send and receive faxes in the User Control Panel (UCP) as well as receive faxes at an e-mail address. You can manage your cover page settings such as company name, address, etc. for the whole company.
Without Fax Pro, only inbound fax-to-email. Fax Pro offers a full inbound and outbound faxing solution.
Where is the Fax Pro module?
Please note, there is no standalone item called "Fax Pro" in the PBX GUI menus.
Fax Pro enables additional settings in the existing Fax Configuration and User Management modules. You'll use those modules, in addition to Inbound Routes and the User Control Panel (UCP), to manage faxing. This wiki describes how to set fax settings in all of these areas.
To see whether you have Fax Pro installed and enabled, visit Admin → Module Admin and look for "Fax Configuration Professional." The basic (non-commercial) version is called "Fax Configuration."
Global Fax Settings
Global Fax Settings are set in the Fax Configuration module. If you do not see all the options shown below, double-check to ensure you have Fax Configuration Professional installed and enabled.
To navigate to the Fax Configuration module in the PBX GUI:
- In the top menu click Settings
- In the drop-down click Fax Configuration
Here, you can set some global options including global cover sheet data.
Fax Presentation Settings
Default Fax header
Header information that is passed to remote side of the fax transmission and is printed on top of every page. This usually contains the name of the person or entity sending the fax.
Default Local Station Identifier
The outgoing Fax Machine Identifier. This is usually your fax number.
Outgoing Email address
This is the email address all outbound faxes appear to be coming from when they are sent to the recipient.
Email address that faxes are sent to when using the "Dial System Fax" feature code. This is also the default email for fax detection in legacy mode (if there are routes still running in this mode that do not have email addresses specified).
Error Correction Mode
Yes/No: Whether to enable Error Correction Mode (ECM). Many new fax machines are capable of resending data that was corrupt. If set to “yes,” we will attempt to negotiate error correction mode (ECM) with the other fax machine.
Maximum transfer rate
Maximum transfer rate used during fax rate negotiation. We recommend 14400.
Minimum transfer rate
Minimum transfer rate used during fax rate negotiation. We recommend 9600.
Default Paper Size
Letter/A4: Select the default paper size. This specifies the size that should be used if the document does not specify a size.
Fax Cover Page Options
Here you can set all the company information you want to be displayed on your fax cover page when sending outbound faxes from the user control panel. You can click the preview button to preview what the cover sheet will look like.
Click the Browse button to upload an image to be used as the company logo on the cover sheet. Note: file type MUST be JPG.
Company Name, Address, Phone, & Web Site
The company contact information that will be displayed on the cover sheet. Address can be entered using 1 to 3 lines.
Text that will appear at the bottom of every page.
Click the Preview button to download a PDF preview of the cover sheet.
User Control Panel Faxing Options
A number to prefix to the outbound fax number. Used to route a fax to a certain outbound route.
Failure Recovery Options
The maximum number of times the system will retry sending a fax upon a failure.
Failure Notification Options
Never/Always/Success/Failure: When to e-mail the results of an outgoing fax.
Local Storage Options
The maximum number of total pages each user is allowed to store locally. This also affects the maximum page number for a single fax.
Reject/Delete Oldest: How the system should respond when a new fax arrives for a user whose storage quota is full. Note: With either option, a single fax that is larger than max pages set above will be deleted after it is received.
- Reject: Reject the new fax and disconnect the call.
- Delete Oldest: Delete as many faxes as necessary to accommodate the incoming fax, starting with the oldest.
This wiki focuses on fax settings and assumes you already know how to set up users and give them access to the User Control Panel (UCP). If you need more information on this, please visit the User Management module user guide.
In FreePBX 13+, a fax recipient's settings are found in the User Management Module instead of the Extensions module. Faxing is now linked to a user, not directly to an extension. This means you can now have "standalone" fax users who aren't associated with an extension, if desired.
After you've enabled fax for a user, you'll be able to select that fax recipient as a destination in other modules.
Navigate to the User Management module:
- In the top menu click Admin
- In the drop down click User Management
If you are not already viewing a user, click the edit buttonfor the user.
Click the Fax tab.
When you first arrive, fax settings will be grayed-out.
Next to Enabled on the first line, click the Yes button to enable faxing and edit the information below.
Yes/No/Inherit: Whether to enable fax for this user.
PDF/TIFF/Both: Format(s) to convert incoming fax files to before e-mailing them to a recipient.
Yes/No/Inherit: Whether to store this user's inbound faxes on the server after the faxes have been e-mailed to the user. If Yes, a user will be able to access the fax in the User Control Panel.
Outgoing Station ID
The outgoing Fax Machine Identifier. This is usually your fax number.
The outgoing Fax Machine Header. This usually contains the name of the person or entity sending the fax.
The name that should appear on the outbound coversheet.
The phone number that will appear on the coversheet.
The email address that will appear on the coversheet.
Use Global Setting/Never/Always/On Success/On Failure: When to e-mail the results of an outgoing fax. The global setting is set in the Fax Configuration module. You can override it on a per-user basis here.
Use Global Setting/0/1/2/3: Number of times to retry sending a fax upon failure. The global setting is set in the Fax Configuration module. You can override it on a per-user basis here.
After making your changes, Click the Submit button, then click the Apply Config button.
Inbound Route Fax Settings
This wiki focuses on fax settings and assumes you already know how to set up inbound routes. For details on inbound route settings not covered here, visit the Inbound Routes module user guide.
Navigate to the Inbound Routes module:
- In the top menu click Connectivity
- In the drop-down menu click Inbound Routes
Select an inbound route by clicking the edit button, or create a new inbound route.
Click on the Fax tab.
No/Yes: Whether to attempt to detect faxes on this DID. Note: Fax detection is not always totally accurate. It will also cause inbound calls to take longer to ring through, since the system attempts to detect a fax tone before routing the call.
- No: Do not attempt to auto-determine the call type. All calls sent to the inbound route's regular destination set in the General tab. Use this option if this DID is used exclusively for voice OR fax, and set the destination in the General tab.
- Yes: Try to auto-determine the type of call; route to the fax destination below if call is a fax, otherwise route to the regular destination set in the General tab. Use this option if you plan to receive both voice and fax calls on this line.
If Detect Faxes: Yes, you will see the additional options below.
Fax Detection type
(Only if Detect Faxes:Yes) - Type of fax detection to use. If the call is coming from a SIP trunk, select SIP. If the call is coming in on a Analog or PRI line, select DAHDI.
- Dahdi: Use Dahdi fax detection; requires 'faxdetect=' to be set to 'incoming' or 'both' in Dahdi.conf
- NV Fax Detect: Use NV Fax Detection; Requires NV Fax Detect to be installed and recognized by asterisk
- SIP: Use SIP fax detection (t38). Requires asterisk 1.6.2 or greater and 'faxdetect=yes' in the sip config files
Fax Detection Time
(Only if Detect Faxes:Yes) - How long, in seconds, to wait and try to detect fax. If no fax is detected within this time, the call will be routed to the regular destination set in the General tab. Please note that callers to a Dahdi channel will hear ringing for this amount of time (i.e. the system won't "answer" the call, it will just play ringing).
(Only if Detect Faxes:Yes) - Where to send the fax if it's detected within the time set above. If sending to a user, choose Fax Recipient: (user name) in the menus. Set up users in the User Management Module as described earlier.
When finished making changes, click the Submit button, then click the Apply Config button.
Note: The information below is available as a standalone page at Fax - UCP.
Include Page Fax - UCP Fax - UCP