About

Introduce faxing for your staff or customers with the ASTPP FoIP module. The FoIP (Fax over Internet Protocol) lets you take benefit of a comprehensive eFaxing system, also known as Fax Server Solution. It supports three different modes of virtual faxing:

Web to Fax
Email to Fax
Fax to Email

Installation

Get Addons → Enterprise → FoIP

Setup

Configuration → Settings → Fax

Fields	Description
Fax Send Retries	Set the number of retries before the system considers fax delivery fails
Fax Email id	Configure IMAP email ID for email2fax. The system will read the emails from this inbox and convert it into Fax.
Fax Email Password	Configure IMAP email ID password
Fax Email Host	Configure IMAP email address host ()
Fax Email Host	NOTE: Use this for configuration {imap.Domain:993/imap/ssl/novalidate-cert}INBOX After imap add the "domain" name For Ex - abc.com this is the domain, replace it with your domain.
Fax Server	Set your FreeSwitch server IP. If you have multiple FreeSwitch then define IPs with command separated. Please do not enter 127.0.0.1

Faxer

This module is having a list of Faxes that have been sent and received.

Configuration → APFaxer → Faxer

Component

Component
CREATE	Top right you can create a fax
DELETE	To delete an entry for any fax

Fields	Description
Accounts	Display the fax account number
Reseller	Display the account number if it is from reseller
Type	Display fax type if sent or received
SIP Device	Display SIP Device information by which the fax has been sent
Number	Display the Fax number on which the system has sent a fax or received the fax
Format	Display fax type (Text / File)
File Name	Display fax filename
Status	Pending: The system accepted the Fax but waiting for the next cron execution to process it. Processing: The system is processing to send a fax. Send: The system has successfully sent a fax. Fail: The system is unable to send a fax. It will mark it fails after completing the number of retires that you have defined in Fax Configuration.
Fax Method	Fax2Mail / Web2fax
Send Date	Display the Fax date on which the fax was sent or received

Web2Fax

This feature allows customers to send the fax in various formats from the web portal.

Configuration → APFaxer → Faxer → Create

Fields	Description
SIP Device	Select the SIP Device which you want to use to send Fax. The system will use the selected SIP Device Caller ID and name to send Fax.
Fax Number	Enter the Fax destination number to which you want to send the fax
Fax Type	Text	It allows you to write your fax content in the text description field, and the system converts that text to PDF and sends it as a fax.
	File	It allows you to upload file in different formats such as PDF, tiff, doc, and DOCX, and the system send it as a fax.
Description	Enter the description for Text Format

Text Format Fax

File Format Fax

FAX list

Email2Fax

Email2Fax is a service that allows you to send an email so that it is received as a fax. The sender can send an attachment as a normal email and that will be received by the receiver through a fax machine.

Configuration → Settings → FAX

Configure your fax email box information on which customers can send emails and the system reads those emails and processes it as a fax.

Fields	Description
Fax Send Retries	Set the number of retries before the system considers fax delivery a failure
Fax Email id	Configure IMAP email ID for email2fax. The system will read the emails from this inbox and convert them into a Fax.
Fax Email Password	Configure IMAP email ID and password
Fax Email Host	Configure IMAP email address host ()
Fax Email Host	NOTE: Use this for configuration {imap.domain:993/imap/ssl/novalidate-cert}INBOX After imap, add the "domain" name For Ex, abc.com is the domain; replace it with your domain.
Fax Server	Set your FreeSwitch server IP. If you have multiple FreeSwitch then define IPs with a command separated. Please do not enter 127.0.0.1

Configure Email Address in Auth Email

This module is useful to authenticate customers when they send a Fax using the Email to Fax feature.

Configuration → APFaxer → Auth Email

Add Auth Email

Add Auth Email
Reseller	Select reseller type
Account	Customer account selection
Email	Define the customer email address from where the system should accept the email and send it as a Fax If the email address is not found in the Auth Email list, then the system will ignore those emails.
Status	Define the status of an Email address - Active / Inactive

Send Fax Using Email

The system will display fax entries in the Fax list after a few minutes once the cron will be executed. Ideally, it takes approximately one minute of time to execute.

Fax2Mail

This feature allows customers to receive normal faxes and get them via email in PDF format.

Inbound → DIDs → Forwarding

Field	Description
Call Type	Set Call Type FOIP for receiving fax on the DID number
Set the email address on which you want to receive Fax as Email, Only one email address is supported

After assigning, it will display as below:

Fax list

Troubleshooting steps

It needs to be enabled in the SIP profile.

t38-Fax-Tone-Detection

enabled

t38-enabled

true

t38-passthru

true

Ex: Parameters below are mentioned

T.38 Fax Tone Detection" typically refers to detecting fax tones in a VoIP (Voice over IP) environment where T.38 is used as the protocol for transmitting faxes over IP networks

When a system or device is described as “T.38-enabled”, it means that it supports the T.38 protocol for real-time fax transmission over IP networks (like SIP or H.323). This enables reliable faxing across VoIP networks, which normally degrade or distort fax signals due to the nature of voice codecs.

T38-passthru if fax is not sending with T38 codec, then it will pass through with a different codec.

vim /etc/ImageMagick-6/policy.xml

<policy domain="coder" rights="read | write" pattern="PDF" />

This cron will not be committed

Check in Crontab -l

* * * * * cd /opt/ASTPP/web_interface/astpp/cron/ && php cron.php crons

This is a command that runs cron manually.

cd /opt/ASTPP/web_interface/astpp/ && php index.php sendfax

cd /opt/ASTPP/web_interface/astpp/ && php index.php faxsend

FoIP (Fax over IP)