Automatic Reply for a received FAX Message back to the sender of the FAX
Issue
Want to set up automatic replies for received FAX messages back to the sender of the fax.
Solution
Configure a NULL-TUM channel:
This is done by starting the WCONFIG program with the command-line option –a, e.g.
"C:\MT\XXXXX(currentTCOSSversion)\WCONFIG.EXE c:\mt\myinst –a"
Within the 'HW/SW assignment' you have to select: 'NU NULL channel' the “slave” for this channel should be 1.0 (primary master)
Change following configlines within the NULL TUM channel:
Configline 2: |
R |
a new, unused channelgroup |
Configline 6: |
Autoreply channel FAX |
comment within the line statistics |
Configline 24: |
2 |
automatic distribution for sending copies |
Configline 41: |
30330 |
Default termination for sendorders created |
Configline 42: |
NU:Automatic Reply |
Default originator for sendorders created |
Create a Mask +MAIL5V/A+R
Remove any leading ---A4--- lines within the mask and select “No Cover” within the send options. The first 2 lines of the mask are fixed, beginning with line 3 the text can be customized. The mask should contain, anywhere after line 2, the Mask variable $N1370$.
++HEADER $O1070$;
++BODY
This is the Autoreply message for a FAX message
The configurable text for the user is $N1370$
Create a service that uses this mask
The prefix of the service should go to the channelgroup of the NULL TUM channel configured in step 1.
Additionally the mask +R (created in step 3.) should be used and a send switch B which advises the NULL TUM channel to create sending copy files:
Service Name: AUTOREPLY
Service Type: Free format
Description: Autoreply for FAX messages
Abilities: Image, Text, restricted Text
Prefix: R:+RB
Create a distribution Directory +MAIL5V/AVV99
The important entry within the VV99 file is the 2nd line.
If there already is an existing +MAIL5V/AVV99, simply add the 2nd line to the existing VV99:
,
++HEADER \;,\
Create an in-event for the user, for whom an autoreply message should be sent to the originator:
The event can be auto-terminating or not, depending on the requirements of the customer.
Service: AUTOREPLY
Number: Any free text which should be user specific, e.g. the username, fax number,…
Example for the User MM:
Service: AUTOREPLY
Number: Max Muster
Extend the rr99 for routing international numbers based on the TSI received:
For example:
**ROUTE
F:*43186353~, F:<I>~
F:*431~, F:~
F:*43~, F:0~
F:*~, F:00~
How does it work:
If an incoming FAX message is received, the sendorder is done to service FXI plus received DDI digits.
The originator of this inbound sendorder is of service FAX (configured in configline 42 of the FAX channel), appending the TSI of the sending machine, for example:
Originator of FAX Inbound sendorder: F:*43186353601
Then the normal FAX inbound routing is executed and the message is distributed to a user (based on the received subaddressing digits).
If the FAX message reaches the inbox of the user (lets assume inbox of user MM), the configured INEVENT using service AUTOREPLY is activated.
The originator of this event sendorder is the user for whom the event was defined, appending the original originator (which is the service FAX plus the received TSI of the sender FAX machine), so for the example above:
Originator of the Event sendorder: MM :F:*43186353601
The recipient of this event sendorder is built according to the definition within the event, so when resolving the service prefix for the service AUTOREPLY, the recipient of the event sendorder will be:
Recipient of the Event sendorder: R :+RBMax Muster
The channelgroup R is polled by the NULL TUM channel.
This sendorder is using the mask +R, where 2 mask variables are included:
$O1070$ will remove the MM: part from the originator (see above)
$N1370$ will remove the R: +RB part from the recipient (see above)
So the message as it is received on the NULL TUM channel looks like:
++HEADER F:*43186353601;
++BODY
This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster
Because of using the NULL TUM Sendswitch B, the NULL TUM channel will create a sending copy document, which looks exactly the same as the message shown above (the sending copy is an exact copy of the message as it is received on the NULL TUM channel). The filename of this sending copy document is
'+MAIL5V/ATUxxxx'.
Because of configuring configline 24 of the NULL TUM channel to value 2, there will be automatic distribution of this generated sending copy document. This means TCOSS will search the VV99 table for matching entries and will generate a sendorder, if it finds a matching entry.
In our case, TCOSS will find a match with the 2nd line of the VV99 table.
This 2nd line of the VV99 table uses a search string with variables, which is marked within the VV99 entry with a backslash character:
++HEADER \;,\
So TCOSS searches through the content of the sending copy document, if it finds a string, which starts with ++HEADER (do not forget the blank after ++HEADER) and ends with a semicolon character. The string parts placed in between these “begin-” and “end-mark” is represented by the backslash character:
++HEADER \;
++HEADER F:*43186353601 ;
Similar as in the rr99, the backslash character can be used on the right side of the VV99 entry, where the sendorder for this match is defined.
The comma after the semicolon character is the separator between searchstring and sendorder definition, so in our case TCOSS will create a sendorder for the sending copy document going to:
F: *43186353601
which is in fact the originator of the original FAX inbound sendorder. The originator for this sending copy sendorder is taken from configline 42 of the NULL TUM channel The termination of this sending copy sendorder is taken from configline 41 of the NULL TUM channel.
Recipient of sending copy sendorder: F:*43186353601
Because of the **ROUTE entries within the rr99 file it is ensured that the “international” number format, as it is used within the TSI is routed to a local number, in our case F:<I601>
Originator of sending copy sendorder: NU:Automatic Reply
Message content of the sending copy sendorder:
++HEADER F:*43186353601;
++BODY
This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster
This is where an undocumented feature of the FAX module shows its face.
The FAX module, which processes this sendorder skips the ++HEADER and the ++BODY line, so in fact the message really received on the FAX machine consists only of line 3 and 4:
This is the Autoreply message for a FAX message
The configurable text for the user is Max Muster
Note: If you need more than text for your Autoreply messages, KCS does offer a product - TC/BIA that will provide a customizable coversheet w/ image and text. It does require customization and a special license. For more information, please contact you KCS support personnel.
Level of Complexity
High
Applies to
Product | Version | Build | Environment | Hardware |
---|---|---|---|---|
Kofax Communication Server | All |
References
Keywords: FAXAutoreply, auto, reply, automatic
Article # 3036221