Delivery Receipts

In Fax Voip version 8.3.1, the E-mail Delivery Receipts Outgoing Routing Method has been implemented, which duplicates the old functionality described in this chapter. For compatibility with some other functions, the old functionality was not removed in Fax Voip version 8.3.1, and also in Fax Voip T.38 Console version 9.1.1, and you can use both functions independently of each other.

Delivery notification receipts provide users with information about the success or failure of their sent faxes and audio messages. An e-mail receipt is sent to the predefined e-mail address(es), to confirm whether the fax or audio message has been sent correctly. Note that this functionality is completely independent from the similar function, which is used together with Mail to Fax (Mail to Audio), see Delivery notification to user e-mail address option in the Delivery Receipts to user e-mail address (Mail to Fax/Audio) chapter of this user manual. The notification to e-mail is sent regardless of the method of creating a fax or audio message. The delivery receipt can be sent to one or more e-mail recipients. To, CC and BCC e-mail fields can be used. A copy of the sent fax can be attached to the e-mail message in TIFF, PDF or SFF format. A copy of the sent audio message can be attached to the e-mail message in WAV format.

To use Delivery Receipts via E-mail function, you must:

None

Select this option to disable delivery receipts.

E-mail To:

Select this option to enable delivery receipts. Specify the recipient's e-mail address in the text box on the right. You can specify not only e-mail but also the name of the recipient. You can also specify multiple recipients which should be separated by a semicolon. Example: sales@company.com;Support<support@company.com>.

CC:

Specify the e-mail recipients that appear in the Cc box of e-mail message.

BCC:

Specify the e-mail recipients that appear in the Bcc box of e-mail message.

Click to select e-mail recipients from Address Book (Windows Contacts).

On the Fax tab page, you can specify whether a copy of the sent fax should be attached to the e-mail message. You can select the file format (TIFF, PDF or SFF) and specify filename template for attached faxes.

Attach a copy of the sent fax in the following format:

Specifies whether a copy of the sent fax should be attached to the e-mail message. Select the file format in which you want to receive a copy of the sent fax. Can be TIFF, PDF or SFF.

The options below are responsible for how file names are generated for the attached faxes.

Use Default Filename Template (FAX...)

Select this option to use default filename template. When specifying the default filename template, the fax attachment name is FAX.tif, FAX.pdf or FAX.sff (depending on the selected format).

Use Custom Filename Template:

Select this option to specify custom filename template in the text box below. Filename template may contain arbitrary text, as well as so-called %variables% that are replaced by actual data (e.g. %RecipientFaxNumber%, %StartTime%, %PagesTransferred% etc.). Filename template can not contain any of the following characters: \ / : * ? " < > | ; An example of file name for the current filename template (taking into account the selected date and time formats) is shown below under Example.

Insert a variable

Use this button to insert a variable in the text box on the left, where the custom filename template is specified. To insert a variable into the text, place the cursor in the desired location (or select text segment that you want to replace), press the button and then select a variable from the drop-down menu.

The following variables can be used with custom fax filename template (replaced by actual data):

%RecipientFaxNumber%. The fax number of the recipient.
%DocumentName%. If the fax is generated by the Mail to Fax function, this is the original name of sender document including file extension. When sending multiple documents, they are comma separated. When sending a fax consisting only of a cover page, replaced with an empty string. Otherwise replaced with an empty string.
%PagesTotal%. The total number of pages in the outgoing fax.
%RemoteFaxID%. The Called Subscriber ID (CSID) received from the fax recipient.
%LocalFaxID%. The transmitting station identifier (TSID) that identifies you as a fax sender, sent to the fax recipient.
%SubmissionTime%. The time the outgoing fax was originally added for sending.
%OriginalScheduledTime%. The time the outgoing fax was originally scheduled for sending.
%StartTime%. The time when the outgoing fax call or fax transmission started.
%EndTime%. The time when the outgoing fax call or fax transmission ended.
%Duration%. The duration of the outgoing fax call or fax transmission.
%Retries%. The number of times the system has tried to send the fax. The total number of possible retries depends on the limit set.
%PagesTransferred%. The number of successfully sent fax pages.
%BitRateEcm%. Transmission rate. The 'e' attribute is used to indicate Error Correction Mode (ECM).
%FaxProtocol%. Fax protocol information. Can be one of the following values: T.38, G711-FAX - audio fax over G.711 codec via VOIP, ISDN - audio fax via ISDN CAPI 2.0 line, ISDN-FAX B3-4-SFF - fax via ISDN CAPI 2.0 line using B3 Protocol 4: T.30 for Group 3 fax, ISDN-FAX B3-5-SFF - fax via ISDN CAPI 2.0 line using B3 Protocol 5: T.30 for Group 3 fax extended.
%Resolution%. Fax resolution. Can be one of the following values: 204x196 dpi (Fine), 204x98 dpi (Normal).
%Status%. Operation completion code. OK in the case of a successful fax sending. In the case of a failed fax sending contains the error description (in English).

Format

Select the locale (region and language) to specify how to display date and time values for the current filename template. This selection affects the display of date and time values defined by the following variables: %SubmissionTime%, %OriginalScheduledTime%, %StartTime%, %EndTime%. By default, the date and time is formatted in accordance with operating system settings.

Use default date and time formats that match Windows display language

Click this button to select date and time formats that match Windows display language (for the current user).

Date

Check this box to use the date part of DateTime value. Select date format from the drop-down list. Available date formats depend on the selected locale (region and language). Slashes ' / ' that cannot be used in file names are replaced with dashes ' - '. An example of the formatting for the current selection is shown on the right under Example.

Time

Check this box to use the time part of DateTime value. Select time format from the drop-down list. Available time formats depend on the selected locale (region and language). Colon characters ' : ' that cannot be used in file names are replaced with dashes ' - '. An example of the formatting for the current selection is shown on the right under Example.

Example

An example of file name for the current filename template (taking into account the selected date and time formats, as well as the selected fax format).

On the Audio tab page, you can specify whether a copy of the sent audio message should be attached to the e-mail message. You can specify filename template for attached audio files.

Attach a copy of the sent audio message

Specifies whether a copy of the sent audio message (WAV file) should be attached to the e-mail message.

The options below are responsible for how file names are generated for the attached audio messages.

Use Default Filename Template (MESSAGE.wav)

Select this option to use default filename template. When specifying the default filename template, the audio attachment name is MESSAGE.wav.

Use Custom Filename Template:

Select this option to specify custom filename template in the text box below. Filename template may contain arbitrary text, as well as so-called %variables% that are replaced by actual data (e.g. %RecipientPhoneNumber%, %StartTime% etc.). Filename template can not contain any of the following characters: \ / : * ? " < > | ; An example of file name for the current filename template (taking into account the selected date and time formats) is shown below under Example.

Insert a variable

The following variables can be used with custom audio message filename template (replaced by actual data):

%RecipientPhoneNumber%. The phone number of the recipient.
%DocumentName%. If the audio message is generated by the Mail to Audio function, this is the name of the original audio file including file extension. Otherwise replaced with an empty string.
%WavLength%. The length of the audio message in seconds.
%SubmissionTime%. The time the outgoing audio message was originally added for sending.
%OriginalScheduledTime%. The time the outgoing audio message was originally scheduled for sending.
%StartTime%. The time when the outgoing call or audio message transmission started.
%EndTime%. The time when the outgoing call or audio message transmission ended.
%Duration%. The duration of the outgoing call or audio message transmission.
%Retries%. The number of times the system has tried to send the audio message. The total number of possible retries depends on the limit set.
%Status%. Operation completion code. OK in the case of a successful sending of audio message. In the case of a failed sending of audio message contains the error description (in English).

The following variable is deprecated and supported only for compatibility with previous versions, do not use it in your new templates:

%WavLenth%. (typo in versions prior to Fax Voip 8.3.1) The length of the audio message in seconds. Instead, use %WavLength%.