The Gateway allows you to decide whether to exclude CC and BCC recipients from consideration as fax recipients. Some previous versions of the gateway always scanned the CC and BCC recipient lists looking for fax recipients. All other recipients, including special recipients, were ignored if they appeared in these lists. You also have the option of generating a recipient list with this version.

Recipient lists are comma-separated values or tab-separated values files suitable for use in the CopiaFacts Job Administration or the CopiaFacts Broadcast Launcher (FFBC). The recipient lists generated by the gateway include the recipient fax number or email address in the first column, the recipient name in the second column, and the recipient type in the third column. The recipient type will either be TO, CC, or BCC depending upon which list the recipient is taken from. Recipient lists are stored in the folder specified in the Recipient List Folder entry or the Global Recipient List Folder if none is given.  Recipient Lists are normally with System Default Encoding, but if you are handling recipients in an international environment you may wish to select a Unicode encoding for recipient lists using the $unicode command.

Normally the recipient list will only contain entries for fax recipients included in one of the specified fax domains. However, it is possible to include email recipients specified in the message headers by checking the Include email recipients option. In this case the gateway must be the only SMTP server to receive and process the message. Otherwise, the message may be delivered to recipients directly via the SMTP server the email client connects to or an ISP SMTP server, which would defeat the purpose of having the gateway process the list of recipients. This sort of specialized use is usually restricted to gateways connected to an internal network where the gateway acts as the SMTP host and is the sole consumer of the messages it receives. Bear in mind that the gateway is not a true SMTP host and is not an SMTP relay. Messages received by the gateway are either processed by the gateway or discarded. They are never relayed to another SMTP server even if authentication is used. The role of the gateway and the route the email message takes to the gateway must be fully understood if you wish to make use of this feature.  You may wish to discuss the situation with Copia technical support before using this feature to make sure you understand the potential for problems. This option is only enabled if you select one of the recipient list creation options.

The recipient list will be created in either the folder you specify for the individual sender or in the default global list folder, which by default is the same as the attachment folder. The gateway will also generate the following variable definitions in the FS file to help you locate the recipient list file:

SMTP_GLOBAL_LISTFOLDERsystem default list folder
SMTP_LIST_FOLDERlist folder used
SMTP_LIST_NAMEname of list file

If you do decide to create a recipient list for a particular sender, you must also make sure that your sender template includes a valid $worker_box command that specifies a script to process the recipient list that is created. The gateway will not automatically launch a broadcast or job using the recipient list.

If you choose add/edit recipient options the following window will be displayed:

This window will only be displayed if the selected domain has templates that might be used as special recipient templates, i.e., the template contains a valid $worker_box command that identifies the script that will be used to process messages associated with the recipient template.

In the pattern column enter a wildcard mailbox name that will be used to match incoming mail for this domain. If the mailbox portion of the recipient address matches this pattern then the message will be handled by the recipient template selected from the drop-down list in the Recipient column. Wildcard comparisons are case-insensitive with the exception of inclusion/exclusion sets, which are case sensitive. Comparisons are done in order of appearance so that a mailbox name that matches multiple patterns will be handled by the recipient template for the first entry that it matches.

You may press the Enter key in any column to advance to the next column or row. If you press Enter in the Recipient column of the last row, a new row will be added to the list. Press the Delete key to remove the current row and press the Ins key to add a new row after the current row. You may also right-click in the Pattern column to display a menu of editing actions that allows you to move rows, delete rows, insert rows, or clear all rows. The insert action from this menu inserts a row before the current row as opposed to the Ins key that inserts a row after the current row. Press OK to accept changes.