Date: Fri, 29 Mar 2024 14:34:04 +0000 (GMT) Message-ID: <646113967.4781.1711722844345@wiki.4psa.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_4780_1770106342.1711722844345" ------=_Part_4780_1770106342.1711722844345 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Applies to VoipNow 3 and higher!
This article explains the fax mechanism in = VoipNow, more precisely the sending of fax messages as attachments to email= s, also known as the email2fax feature.
VoipNow's email2fax feature allows you to send fax messages by attaching=
the fax content as a .pdf
, .jpg
or .tiff=
code> file to an email message, which is then sent to a special faxing emai=
l address on the server.
Before explaining how this actually happens, you should know that only P= hone terminal extensions support the email2fax feature. After rec= eiving the fax message as attachment to an email, the server asks the sende= r for approval. When confirmed, it converts the attachment into a suitable = fax format and sends it to the number(s) specified in the email subject.
The sender's address is used by the system to verify the destination ext= ension for the email-generated fax. In order to be able to send faxes using= the email2fax feature, the sender's email must be added t= o one of the extensions in the system. For more details, check the How to Enable Faxin= g for an Extension section.
Please note that only one extension can send faxes to that sender, so yo= u cannot add the sender's email address on several extensions.
Enabling fax features server-wide&nbs= p;
To enable the email2fax feature, go to Unified Communications = =E2=86=92 Zero Priority =E2=86=92 Fax tab.
The Fax Preferences available are:
System accepts faxes by email= strong>: Select this checkbox to ena= ble the email2fax feature server-wide.
Server hostname in fax approval= emails: The hostname to be used in the approval link generat= ed by the server and sent by email when a fax is dispatched.
Erase faxes that were n= ot confirmed for: The time interval unconfirmed faxes wil= l be stored in the system. The accepted values range from 1 to 1= 00 days. The default value is 30 days.
Erase faxes that could no= t be sent for: The time interval unsent faxes will be stored = in the system. The accepted values range from 1 to 100 days. The= default value is 30 days.
Choose the extension you want to enable the fax feature for, click the <= strong>Phone terminal setup icon and fill in the options available= in the Fax Center section:
You may leave the other options with their default values. Such options = are used only when the extension receives faxes.
The email notification sent by the server to the customer for fax approv= al can be globally customized.
To do this, go to the Unified Communications =E2=86=92 = ;Email templates page. The following templates can be customized f= rom the Unified Communications Email Templates section:
Templates can be further customized on both service provider and organiz= ation levels by clicking their corresponding Email templates icon.
All the email templates use variables to automatically insert strings su=
ch as the phone number. The variables are displayed in the [VARIABLE_=
NAME]
form. For more information about the available variables, cons=
ult the Email Templates section from the online help.
In the Extension Management page, click the Sen= t faxes button. The system keeps a log of all fax messages queued = for the current extension.
The section is organized as follows:
Fax to: The recipient(s) number(s).
<= /li>Status:= The current status of the fax me= ssage (approved, sent, partially sent, sending failed, cancelled, scheduled= for sending, not approved, preapproved, purged)
Size: The fax mes= sage size.
Added: The date t= he fax email was added to the system.
Sent on=
: The date the fax message left the system.
=
Info:&n=
bsp;The events log for the fax message.
=
span>
To send a fax email, you need to create an email with the following mand= atory elements:
JPEG
, PDF
, and TIFF
.=
If an unsupported file is attached, the system will fail to send the fax.<=
br>If you want the best results with the PDF files, it's recommended to cre= ate them using embedded fonts.
Fax emails get processed by the Postfix mail server. Postfix keeps a log=
of its activity in the /var/log/maillo=
g
logfile. To watch the maillog, run the following command:
tail -f= /var/log/maillog
If a client's email has reached the server, you should be able to see it= in the maillog. We recommend that you look for an entry similar to this on= e:
DATE TIME SERVER_HOSTNAME postfix/smtpd[21802]: E9324D318D06: client=3DH= OSTNAME[IP_ADDRESS]
This means that the client's machine has connected to the server. Theref= ore you're not dealing with a connection-related issue. Then the destinatio= n address is checked and, if it turns out invalid (it should be the same as= the one set up on the server to receive fax messages), the email is droppe= d. If that's the case, the system will send you a notification.
If the email has reached the server and its destination is valid, it get=
s sent through the procmail
utility. The attachment is process=
ed with the help of the faxprocess
utility.
faxprocess
logs its activity in /var/log/maillog
If the email reaches the server and gets validated by Postfix reaching <= code>faxprocess, yet the fax does not get sent, then ensure that:
faxprocess
wi=
ll reject the message..tiff
, .pdf
or .jpg=
.The faxprocess script uses two directories: