Snapfax Plus - Folder Faxing feature allows you to send faxes easily by putting fax jobs into designated folders (also known as “watched folders”) on your Windows file system.
Folder Faxing
Overview
Folder Faxing is a feature in Snapfax Plus which allows you to send faxes easily by putting fax jobs into designated folders (also known as “watched folders”) on your Windows file system. You can either simply put your fax job files into the folders manually or the process can be automated programmatically to better suit the needs of your business.
A typical fax job file contains parameters such as recipient’s fax number and the filename of the PDF document that needs to be faxed. The Snapfax Plus Service running in the background will periodically check those folders for new fax jobs and when found, converts them to faxes for delivery via the Snapfax Cloud Service automatically. You can monitor the status of your submitted fax jobs from within Snapfax Plus. Once a fax job has been processed, a result file will be automatically generated by default.
The following sections will provide you the details about:
How to Setup a Watched Folder in Snapfax Plus
In order to use the Folder Faxing feature, first of all you need to download and install Snapfax Plus onto your Windows computer. If you have not already installed it, please download the setup file for Snapfax Plus from the link below. Once downloaded, run the setup file and follow the on-screen instructions to complete the installation.
Snapfax Plus Setup File (version 1.1.0):
https://snapfaxapp.com/download/Snapfax-Plus-1.1.0.msi
Once you have installed Snapfax Plus onto your computer, you can proceed to setup a new watched folder within Snapfax Plus, so that you can put your fax jobs into the corresponding folder on your file system when needed. The Snapfax Plus Service installed with Snapfax Plus will monitor the folder for new fax jobs for processing.
Steps for adding a new watched folder
- Click the Settings icon (i.e. gear icon) from the left menu panel of the Home screen.
- Click the Plus icon under the “Watched Folder Faxing” section of the Settings screen.
- Browse to choose a desired local folder (e.g. C:\MyFaxFolder) from the file system to be the new watched folder. Note that local root drives (e.g. C:\, D:\, E:\, etc.) and mapped network folders are not supported.
- Press the “Select Folder” button. A new watched folder will then be added.
Once you have added a new watched folder from the Settings screen, the Home screen will be updated automatically. This allows you to switch to the auto-generated Watched Folder screen.
The Watched Folder screen will display the fax logs of the associated watched folder. Initially, since no fax job has been submitted and processed yet, no log will be displayed in the new Watched Folder screen.
Steps for removing a watched folder
- Click the Settings icon (i.e. gear icon) from the left menu panel of the Home screen.
- Under the “Watched Folder Faxing” section of the Settings screen, select the watched folder that you want to remove.
- Click the Minus icon to remove the selected watched folder.
How to Create and Submit a Fax Job
Once you have setup a watched folder, you can proceed to try creating a fax job and put it into the corresponding folder on your file system for processing. There are two methods that you can use to create a fax job:
- by putting a specially-named PDF file into a designated folder.
- by putting a fax job file and optional PDF files into a designated folder.
If you just need to send a PDF file without a cover sheet to a fax number, then putting a specially-named PDF file to a designated folder would probably be the simplest way. On the other hand, putting a fax job file and optional PDF files into a designated folder would give you more control and flexibility.
Create a fax job by putting a specially-named PDF file into a designated folder
You can prepare a specially-named PDF file according to the following steps:
- Make a copy of the PDF file that you want to send.
- Rename the copied file with this special filename syntax:
fax={+country_codexxxxxxxx}optional_text_part.pdf
- The filename must begin with fax= and end with .pdf.
- In the filename, the fax number must be surrounded by curly brackets {}.
- The fax number must begin with a country code prefix (e.g. +1 for North America), and then followed by xxxxxxxx which must be replaced with the value that matches the recipient fax number.
- You can replace the optional_text_part with your desired text or simply leave it blank.
Example:
If you wanted to send a PDF file to fax number +19057098604, you might rename your copied PDF as fax={+19057098604}.pdf - Once you have renamed the copied PDF file, you can copy and paste it into your designated folder on your file system. The Snapfax Plus Service will convert that file into a fax job and try faxing it out via the Snapfax Cloud Service.
Create a fax job by putting a fax job file and optional PDF files into a designated folder
You can use any text editor to create a fax job file. The file extension of a fax job file must be “.efj”. The content of fax job file is in JSON format, so it is easy to read and edit. Once you have created the fax job file, you can put it together with the PDF documents to be sent into the designated folder on your file system for processing.
Below is a list of supported JSON elements that can be included within a fax job file:
Regular Fax Cover Page | |
---|---|
0001.en | English |
0001.de-DE | German |
0001.es | Spainish |
0001.fr-FR | French |
0001.it-IT | Italian |
0001.ja-JP | Japanese |
0001.ko-KR | Korean |
0001.pt-PT | Portuguese |
0001.ru-RU | Russian |
0001.th-TH | Thai |
0001.zh-Hans | Simplified Chinese |
0001.zh-Hant | Traditional Chinese |
Confidential Fax Cover Page | |
0002.en | English |
0002.de-DE | German |
0002.es | Spainish |
0002.fr-FR | French |
0002.it-IT | Italian |
0002.ja-JP | Japanese |
0002.ko-KR | Korean |
0002.pt-PT | Portuguese |
0002.ru-RU | Russian |
0002.th-TH | Thai |
0002.zh-Hans | Simplified Chinese |
0002.zh-Hant | Traditional Chinese |
Let’s look at some examples to get a better understanding of the fax job file content.
Example 1:
Suppose you want to send a PDF document called “my_document.pdf” without a cover sheet to fax number “+19057098604”, you can create a fax job file (i.e. a .efj file) with content as shown below, and then copy the corresponding .efj file and my_document.pdf into a designated folder for processing.
Fax job file Content:
{
"to": [
{
"faxNumber": "+19057098604"
}
],
"attachment": [
{
"path": "my_document.pdf"
}
]
}
Example 2:
Suppose you want to send two PDF files (e.g. “my_document_1.pdf” and “my_document_2.pdf”) without a cover sheet to fax number “+19057098604”, you can create a fax job file (i.e. an .efj file) with content as shown below, and then copy the corresponding .efj file and the two PDF files into a designated folder for processing.
Fax job file Content:
{
"to": [
{
"faxNumber": "+19057098604"
}
],
"attachment": [
{
"path": "my_document_1.pdf"
},
{
"path": "my_document_2.pdf"
}
]
}
Example 3:
Suppose you want to send a PDF file called “my_document.pdf” with a cover sheet to two recipients (“John Doe” and “Jane Doe” with fax numbers “+19057098604” and “+19050000000” respectively), you can create a fax job file (i.e. an .efj file) with content as shown below, and then copy the corresponding .efj file and my_document.pdf into a designated folder for processing.
Fax job file Content:
{
"to": [
{
"name": "John Doe",
"faxNumber": "+19057098604"
},
{
"name": "Jane Doe",
"faxNumber": "+19050000000"
}
],
"attachment": [
{
"path": "my_document.pdf",
"delete": true
}
],
"coversheet": "0001.en",
"from": "Acme Corporation",
"subject": "This is a test fax",
"body": "Hi,\nHope everything goes well.",
"result": true
}
How to Monitor a Submitted Fax Job and Interpret a Result File
After you have added a new fax job into a designated watched folder, the Snapfax Plus Service will pick it up for processing. Once a new fax job in the watched folder has been picked up by the Snapfax Plus Service for processing, a new fax log will be generated in Snapfax Plus automatically. You can view the fax logs by switching to the associated Watched Folder screen. You can click the Refresh button to reload the Watched Folder screen screen to display any new changes.
You can click on a particular fax log entry from the Watched Folder screen to see the corresponding fax details and download the fax transmission report.
If your fax job was created by putting a specially-named PDF file into the designated folder, during processing the fax job, the Snapfax Plus Service will first rename the extension of the PDF file from .pdf to .PROCESSING. Once the processing has completed, the service will delete the .PROCESSING file and generate a .RESULT file. The .RESULT file is a plain text file in JSON format, which contains information about fax job processing and fax delivery results.
If your fax job was created by putting a fax job file and optional PDF files into the designated folder, during processing the fax job, the Snapfax Plus Service will first rename the extension of the fax job file from .efj file to .PROCESSING, while the PDF files will remain unchanged. Once the processing has completed, the service will delete the .PROCESSING file and generate a .RESULT file. The service will also delete the PDF files from the designated folder automatically by default.
The list of elements that may be included in a .RESULT file:
Example 1: A .RESULT file for a fax job that has a successful transmission.
{
"Start":"2020-10-22T08:10:35.000Z",
"End":"2020-10-22T08:13:57.000Z",
"RefNo":"F58F4F",
"JobSubmissionError":"",
"Recipients":[
{
"To":"John Doe",
"FaxNumber":"+19057098604",
"Status":"SENT",
"CompletedTime":"2020-10-22T08:11:16.000Z",
"CSID":"",
"Duration":1.0,
"PagesSent":2,
"Error":""
}
]
}
Example 2: A .RESULT file for a fax job that has a successful transmission and a failed transmission.
{
"Start":"2020-10-22T08:10:35.000Z",
"End":"2020-10-22T08:15:28.000Z",
"RefNo":"F58F4F",
"JobSubmissionError":"",
"Recipients":[
{
"To":"John Doe",
"FaxNumber":"+19057098604",
"Status":"SENT",
"CompletedTime":"2020-10-22T08:11:16.000Z",
"CSID":"",
"Duration":1.0,
"PagesSent":2,
"Error":""
},
{
"To":"Jane Doe",
"FaxNumber":"+19050000000",
"Status":"ERROR",
"CompletedTime":"2020-10-22T08:12:47.000Z",
"CSID":"1 (905) 000 0000",
"Duration":1.0,
"PagesSent":0,
"Error":"Busy"
}
]
}
Example 3: A .RESULT file for a fax job that has a submission error.
{
"Start":"2020-10-23T05:13:12.000Z",
"End":"2020-10-23T05:13:12.000Z",
"RefNo":null,
"JobSubmissionError":"Invalid recipient fax number: '+12345'.",
"Recipients":null
}
How to Troubleshoot in Case of Encountering a Problem
Please see whether or not the following FAQs can help.
Question: When installing Snapfax Plus, I get an error “This application requires Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019”. What can I do?
The “Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019” is a prerequisite for Snapfax Plus. Please download and install it before installing Snapfax Plus.
https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
Question: I get an error “LoadWatchedFolder() : Status(StatusCode=Unavailable, Detail="failed to connect to all addresses")” after launching Snapfax Plus. What can I do?
- Please check whether the Snapfax Plus Service is started:
- Launch the Windows Services application (press the Windows+R keys to open the Run dialog, type services.msc and then press Enter)
- Make sure “Snapfax Plus Service” is listed as one of the services.
- Make sure the “Startup Type” of the “Snapfax Plus Service” is set to “Automatic”.
- Make sure the “Snapfax Plus Service” is started. If it is stopped, try starting it.
- If the service fails to start, please try to download and install the “Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019”.
https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
Question: I have put a new fax job into a designated folder on my file system, however, I cannot see any new fax jobs from the corresponding watched folder screen in Snapfax Plus, even though I have tried refreshing the screen for over 5 minutes. There is also no .PROCESSING file generated in the file system too. What can I do?
- Check whether the Snapfax Plus Service is started:
- Launch the Windows Services application (press the Windows+R keys to open the Run dialog, type services.msc and then press Enter)
- Make sure “Snapfax Plus Service” is listed as one of the services.
- Make sure the “Startup Type” of the “Snapfax Plus Service” is set to “Automatic”.
- Make sure the “Snapfax Plus Service” is started. If it is stopped, try starting it.
- Make sure you have already created a watched folder in Snapfax Plus for that particular folder on your file system. You can see the list of existing watched folders from the Settings screen of the Snapfax Plus.
Question: The status of my fax job has remained as “Pending” for over 5 minutes in the Watched Folder screen even though there is no other fax job being processed at the time. What is the problem?
Maybe your computer cannot access the Internet through HTTPS (port 443) for some reasons. Please check your Internet connection and make sure Web traffic is not blocked by a proxy server or firewall.
Question: I have already read all the FAQs above but the problem still cannot be resolved. What should I do?
Please feel free to contact us. If Snapfax Plus can be launched on your computer, you can click “Settings → Contact Us” from your Snapfax Plus, which will then launch your email client and create a new email with some information filled in by default. On the other hand, in case Snapfax Plus crashes and cannot be launched, you can send an email directly to us at support@snapfaxapp.com.
In your email, please provide additional information to describe the problem that you have encountered. We will reply to you as soon as possible.