Jump to: navigation, search

email-processing Section



     


attachment-mngt

Default Value: LEAVE
Valid Values: LEAVE, REMOVE
Changes Take Effect: Immediately


Specifies the strategy used by E-mail Server to handle attachments of

incoming messages for this account.

  • The value of LEAVE causes this E-mail Server to store a message in the database with attachments.
  • The value of REMOVE causes this server to store a message in the database without attachments.

autobot-agent-login-name

Default Value:
Valid Values: Any valid agent login name
Changes Take Effect: Immediately


Specifies the agent (the autobot Person) used to render standard responses containing agent-related field codes. For information about autoresponses, see sections on e-mail objects in the "Interaction Routing Designer Objects" chapter of the Universal Routing 8.1 (or later) Reference Manual.

If you want to control what the interaction history shows as the owner of e-mails (for example, acknowledgements, autoresponses, and replies from agents) generated by E-mail Server, you can use the User Data key _OwnerEmployeeId. Its value must be the Employee ID of a Person object. For example in a routing strategy, you can add a Function object, specify the Update function, and manually enter the _OwnerEmployeeId key. You could also specify the UData function with a GD_OriginalAgentEmployeeId key, which gets its value from the User Data GD_OrginalAgentEmployeeId. The person designated by the value becomes the owner shown in the interaction history. If you do not assign any value to the _OwnerEmployeeId key, the owner of this type of interaction is determined by the autobot Person.

autowar-detect-period

Default Value: 00:10:00
Valid Values: Any time period in the hh:mm:ss format
Changes Take Effect: Immediately


Sets the timespan during which E-mail Server counts previous automatic e-mails (autoresponses and acknowledgements) that it sent to the same contact in the same thread.

autowar-max-reply-count

Default Value: 5
Valid Values: Any integer greater than 0.
Changes Take Effect: Immediately


Sets the maximum number of automated replies that E-mail Server sends in the configured autowar-detect-period.

autowar-scan-all-threads-of-contact

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately


If set to true, E-mail Server scans all the threads of the current contact in order to count the number of autoresponses and auto-acknowledgements. If set to FALSE, E-mail Server scans only the current thread for this contact.

bcc-address

Default Value:
Valid Values: Any valid e-mail address or list of e-mail addresses
Changes Take Effect: Immediately


Specifies an additional address, or comma-delimited list of addresses to which all outgoing messages are sent as a Bcc. The value must comply with RFC2822, and therefore must be encoded

according to RFC2047. Examples of valid values include the following:

  • legal@mycompany.com
  • legal@mycompany.com,archive@mycompany.com
  • "Legal Dpt" <legal@mycompany.com>
  • "=?Cp1252?Q?Dpt_=E9_Legal?=" <legal@mycompany.com> where "=?Cp1252?Q?Dpt_=E9_Legal?=" is the French equivalent of Legal Dept and includes French diacritics

cc-userdata-limit

Default Value: -1
Valid Values: -1, or any positive integer
Changes Take Effect: At start/restart


Specifies when to add the keys Cc and _NumberOfCcAddresses to user data. A value of -1 (or any negative number) indicates to never add the keys Cc and _NumberOfCcAddresses to user data. A positive number indicates to add the keys Cc and _NumberOfCcAddresses to user data if the number of Cc addresses in the received e-mail is less than or equal to the specified number. If the number of Cc addresses in the received e-mail is greater than the specified number, only the key _NumberOfCcAddresses is added to user data.

check-email-address

Default Value: true
Valid Values: true, false
Changes Take Effect: At start/restart


Allows you to disable the checking of incoming e-mails for compliance with RFC822 (governing whether e-mail addresses with white spaces are accepted). The default value of TRUE leaves such checking enabled, and Genesys strongly recommends this setting. Disabling this checking means the system attempts to process noncompliant e-mails, which may cause problems. You may, however, consider disabling the checking if large numbers of noncompliant e-mails are being received (for example, with spaces in the address in the From field). If you disable this checking (a value of FALSE), such e-mails are no longer processed as failed e-mails.

contact-identification

Default Value: IDENTIFY-AND-CREATE
Valid Values: IDENTIFY-AND-CREATE, IDENTIFY-ONLY, DO-NOTHING
Changes Take Effect: Immediately


Specifies how E-mail Server handles contact identification and auto-creation. A value of IDENTIFY-AND-CREATE means E-mail Server attempts to identify the contact. If the contact is not found, it is created. A value of IDENTIFY-ONLY means E-mail Server attempts to identify the contact, but does not create a new contact if it is not found. If set to DO-NOTHING, E-mail Server does not identify the contact.

default-domain

Default Value:
Valid Values: Any valid domain name
Changes Take Effect: Immediately


Specifies the domain name added to all e-mail addresses that do not have a domain name.

default-from-address

Default Value:
Valid Values: Any valid e-mail address
Changes Take Effect: Immediately


If not empty, specifies the address shown in the From field of outgoing e-mails. The value must comply with RFC2822, and therefore must be encoded according to RFC2047.

Examples of valid values include the following:

  • *legal@mycompany.com
  • *"Legal Dpt" <legal@mycompany.com>
  • *"=?Cp1252?Q?Dpt_=E9_Legal?=" <legal@mycompany.com> where "=?Cp1252?Q?Dpt_=E9_Legal?=" is the French equivalent of Legal Dept and includes French diacritics.

default-inbound-queue

Default Value:
Valid Values: Any valid and defined queue (Script objects of Interaction Queue type)
Changes Take Effect: Immediately


Specifies the default inbound queue used to submit new inbound messages.

enable-autowar-detect

Default Value: false
Valid Values: true, false
Changes Take Effect: At start/restart


Enables (true) or disables (false) the detection and counting of e-mails that it sent to the same contact in the same thread, and that are both (a) parent to the Customer Reply and (b) of type Auto-Response or Acknowledgement. When enabled, E-mail Server attaches the resulting number to the Customer Reply as a value of the key _AutoReplyCount. You can then create a routing strategy to compare the value of _AutoReplyCount to a threshold that you define. If the value exceeds the threshold, the strategy can refrain from creating an autoresponse or acknowledgement.

enable-extract-uuencoded-file

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately


Enables extraction of UUEncoded files as attachments.

enable-firstname-lastname-auto-filling

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately


Enables E-mail Server to turn off automatic filling of first and last name.

enable-inbound-processor

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately


Enables Inbound Processor when the value is set to true.

enable-inbound-submitter

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately


Enables Inbound Submitter when the value is set to true.

enable-mail-loops

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately


Specifies whether E-mail Server can (TRUE) or cannot (FALSE, the default) send mail to the addresses specified in the following sections and

options:

  • email-processing/default-from-address
  • email-processing/ext-resource-incoming-address
  • iwe-processing/address
  • chat-client/address
  • pop-client/address

Sending e-mails to these addresses may be useful if you want to direct copies of outbound e-mails to system-internal addresses for purposes of (for example) validating or archiving.

enable-message-id-check

Default Value: true
Valid Values: true, false
Changes Take Effect: At the next POP cycle


Enables (true) or disables (false) the Message-Id uniqueness check during the POP cycle. If enabled, E-mail Server checks received e-mail against existing e-mail in the database, and silently deletes any duplicate e-mail from the corporate mail server. Use this option to prevent the mail server from inadvertently offering the same e-mail in successive POP cycles. If you set this option to FALSE, E-mail Server does not check the uniqueness of the Message-Id, and no silent removal of duplicate e-mail will occur.

enable-outbound-submitter

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately


Enables Outbound Submitter when the value is set to true.

enable-same-mail-from-mailboxes

Default Value: false
Valid Values: true, false
Changes Take Effect: At the next POP cycle


Determines what E-mail Server does when it retrieves multiple incoming e-mails with the same Message-Id from different mailboxes. With the default setting FALSE, if among all the retrieved incoming e-mails (from any mailbox) from the corporate mail server, there is more than one e-mail that has the same Message-Id header field, E-mail Server downloads only the first one and deletes the others from the corporate mail server.
With the setting TRUE, E-mail Server retrieves a separate e-mail from each mailbox.

enable-stop-initial-emailin-after-extreply

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately


Enables E-mail Server to stop the original emailin after ext reply when the value is set to true.

ext-resource-incoming-address

Default Value:
Valid Values: Any valid e-mail address that is RFC2822 compliant
Changes Take Effect: Immediately


Specifies the e-mail address used when external agents reply to messages. This option also prevents the specified e-mail address for this external resource from receiving system generated e-mails, such as acknowledgements. Without this last control, if this e-mail address was accidentally specified as a recipient (To or CC) in the Format tab of an E-mail object, E-mail Server would receive the system-generated e-mail that it had just sent out. You set this value set during E-mail Server setup. The value must comply with RFC2822 and therefore must be encoded according to RFC2047.

Examples of valid values include the following:

  • legal@mycompany.com
  • Legal Dpt <legal@mycompany.com>
  • "=?Cp1252?Q?Dpt_=E9_Legal?=" <legal@mycompany.com> where "=?Cp1252?Q?Dpt_=E9_Legal?=" is the French equivalent of Legal Dept and includes French diacritics.

fieldcode-format-locale

Default Value:
Valid Values: Any valid Java locale in the language_COUNTRY format
Changes Take Effect: Immediately


When specified, defines the locale that must be used to format date, time, currency, and percent values in Field Codes. If not specified, the server uses the default platform. The value format is: <two letter code of ISO 639>_<two letter code of ISO 3166>

inbound-msg-thread-pool-size

Default Value: 10
Valid Values: Any integer greater than 0
Changes Take Effect: Immediately


Sets the thread-pool size for retrieving inbound messages. This is the maximum number of inbound mailboxes being popped from POP3/IMAP servers in parallel.

inbound-processor-high-watermark

Default Value: 50
Valid Values: Any integer greater than 0 and less than 65535
Changes Take Effect: At start/restart


Specifies the maximum number of email interactions that E-mail Server requests from the database to refill the Inbound Processor queue when the remaining email interactions in the Inbound Processor queue is below the inbound-processor-low-watermark option value.

inbound-processor-low-watermark

Default Value: 10
Valid Values: Any integer greater than 0 and less than the value of inbound-processor-high-watermark
Changes Take Effect: At start/restart


Specifies the minimum number of interactions in the Inbound Processor queue. If the number in the queue falls below this value, E- mail Server requests from a database scan to refill the queue.

inbound-processor-period

Default Value: 00:00:30
Valid Values: Any valid time period in the hh:mm:ss format
Changes Take Effect: Immediately


Specifies the amount of time that Inbound Processor waits before rescanning the database for inbound interactions when no new interactions are found.

inbound-processor-thread-pool-size

Default Value: 5
Valid Values: Any integer greater than 0
Changes Take Effect: At start/restart


Sets the thread pool size for Inbound Processor. This is the maximum number of inbound interactions being processed in parallel.

inbound-submitter-high-watermark

Default Value: 50
Valid Values: Any integer greater than 0 and less than 65535
Changes Take Effect: At start/restart


Specifies the maximum number of email interactions that E-mail Server requests from the database to refill the Inbound Submitter queue every time when the remaining email interactions in the Inbound Submitter queue is below the inbound- submitter-low-watermark option value.

inbound-submitter-low-watermark

Default Value: 10
Valid Values: Any integer greater than 0 and less than the value of inbound-submitter-high-watermark
Changes Take Effect: At start/restart


Specifies the minimum number of interactions in the Inbound Submitter queue. Once the queue reaches this value, E-mail Server requests a database scan to refill the Inbound Submitter queue.

inbound-submitter-period

Default Value: 00:00:30
Valid Values: Any time period in the hh:mm:ss format
Changes Take Effect: Immediately


Specifies the amount of time that Inbound Submitter waits before rescanning the database for inbound interactions when no new interactions are found.

ixn-server-cnx-max-idle-time

Default Value: 00:05:00
Valid Values: Any valid time period in hh:mm:ss format
Changes Take Effect: At start/restart


In the connection pool to Interaction Server, specifies the amount of time a connection to Interaction Server can stay Idle before the connection is closed.

ndr-senders-list

Default Value: mailer-daemon,postmaster,mmdf
Valid Values: Any valid string or comma-separated list of strings
Changes Take Effect: Immediately


Specifies the string used to identify nondelivery report (ndr) e-mails when the message does not comply with RFC1891. The full process is described in [[Documentation:ES:Admin:EmSDelivStat:8.5.1|"Delivery Status Notification and Message Disposition Notification"]] in the eServices Administrator's Guide.

outbound-msg-charset

Default Value: utf-8
Valid Values: Any valid character set, IANA (Internet Assigned Numbers Authority)–registered
Changes Take Effect: Immediately


Specifies the default character set used to encode all outgoing messages.

outbound-status-update-retry-count

Default Value: 1
Valid Values: Any positive ingeter.
Changes Take Effect: Immediately


Sets the maximum number of retry times for ESJ retry to update an outbound email interaction status in UCS DB after the email was sent sucessfully. The change will not affect the retry that has already been going on. The value of this count must be changed according to the following configurations in the different components, each retry will add 10 sec. service time: IXN settings->third-party-server-timeout (5-180 sec.) default 30 sec. URS default->service_timeout, default value 30 sec.

outbound-submitter-high-watermark

Default Value: 50
Valid Values: Any integer greater than 0 and less than 65535
Changes Take Effect: At start/restart


Specifies the maximum number of email interactions that E-mail Server requests from the database to refill the Outbound Submitter queue when the remaining email interactions in the Outbound Submitter queue is below the outbound-submitter-low-watermark option value.

outbound-submitter-low-watermark

Default Value: 10
Valid Values: Any integer greater than 0 and less than the value of outbound-submitter-high-watermark
Changes Take Effect: At start/restart


Specifies the minimum number of interactions in the Outbound Submitter queue. Once the queue reaches this value, E-mail Server requests a database scan to refill the Outbound Submitter queue.

outbound-submitter-period

Default Value: 00:00:30
Valid Values: Any time period in hh:mm:ss format
Changes Take Effect: Immediately


Specifies the amount of time that Outbound Submitter waits before rescanning the database for outbound interactions, when no new interactions are found.

quote-cc

Default Value: Cc:
Valid Values: Any string
Changes Take Effect: Immediately
Introduced: 8.5.103.11

Specifies the string used, when quoting the original message, to indicate the addresses in the Cc field of the original message.

quote-from

Default Value: From:
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the string used, when quoting the original message, to indicate the sender of the original message.

quote-prefix

Default Value: >
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the prefix to insert at line beginnings when quoting the original message’s content.

quote-sent

Default Value: Sent:
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the string used, when quoting the original message, to indicate the date the original message was sent.

quote-separator

Default Value: ----- Original Message -----
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the string used to separate an e-mail response from the quotation of the original message.

quote-subject

Default Value: Subject:
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the string used, when quoting the original message, to indicate the subject of the original message.

quote-to

Default Value: To:
Valid Values: Any string
Changes Take Effect: Immediately
Introduced: 8.5.103.11

Specifies the string used, when quoting the original message, to indicate the recipient of the original message.

socket-timeout

Default Value: 00:02:00
Valid Values: Any time period in the hh:mm:ss format
Changes Take Effect: Immediately


Sets the input/output timeout value for connections to Interaction Server. The timeout is triggered when Interaction Server does not reply within the specified amount of time. Setting the timeout value to 00:00:00 means that there is an infinite timeout period.

subject-forward-prefix

Default Value: Fwd:
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the prefix that will be inserted at the beginning of a message’s subject line when forwarding a message.

subject-reply-prefix

Default Value: Re:
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the prefix that will be inserted at the beginning of a message’s subject line when replying to a message.

subject-threading-substrings

Default Value: re:,reply,out of office,out of the office
Valid Values: Any valid string or comma-separated list of strings
Changes Take Effect: Immediately


Defines the list of string or substring tokens to remove from the start of the e-mail Subject to normalize the subject. When finding the parent interaction for an e-mail, E-mail Server first uses the MIME-based threading mechanism, checking standard e-mail headers such as In-Reply-To or References E-mail for a parent interaction's MIME id. If these are not provided, the server searches for substrings in the Subject text box to determine whether it is a reply. If the server finds such a substring, it attempts to thread the e-mail by Subject.

If the server does not find a substring, it tries to look for an existing e-mail with the same Subject. When doing so, the server bases the Subject lookup and comparison on the normalized subject, which is computed from the e-mail Subject by removing any leading token defined by this option.

Values are case-insensitive; for example, the value re: finds re:, Re:, and RE:.

Configure this option to avoid autobot wars. For information about autobots, see the "E-Mail Objects" section in Chapter 3 of the Universal Routing 7.6 (or later) Reference Manual.

This page was last edited on April 29, 2021, at 16:17.
Comments or questions about this documentation? Contact us for support!