Delivery Status Notification and Message Disposition Notification
Outbound e-mails can include a request for a return message indicating whether and how the original e-mail was delivered. In Genesys eServices, you do this using the Send Email object in a routing strategy, as described in the Universal Routing 8.1 Reference Manual. The return message is of one of the following three types:
- If delivery fails: InboundNDR
- If delivery succeeds:
These types are represented as attribute values of the Interaction Subtype Business Attribute in Configuration Manager. E-mail Server assigns the return message to the appropriate type, and UCS stores it as a child of the outbound e-mail that contained the request.
The following sections describe each type and its contents.
If one of the SMTP servers involved in the transport of the original e-mail fails to deliver it, E-mail Server submits the return message to the system with subtype InboundNDR (NDR stands for non-delivery report). There are two ways that E-mail Server can detect an inbound e-mail as an NDR:
For this way, both of the following must be true:
- The e-mail conforms to RFC 3464, which means that it includes information about delivery status.
- That information indicates that delivery failed for at least one recipient.
In this case, E-mail Server submits the e-mail to the system with attached data.
For this way, all of the following must be true:
- The e-mail contains either a message/rfc822 part or a message/rfc822-headers part.
- The part referred to in (1) contains a Message-ID header.
- One of the following must be true:
- The e-mail’s From field contains one of the values specified in the E-mail Server ndr-senders-list option (the default is mailer-daemon,postmaster,mmdf).
- The Message-ID header referred to in (2) matches the message ID of some interaction already stored in the UCS database.
In this case, E-mail Server submits the e-mail to the system with no particular attached data. The subtype InboundNDR indicates the failure of delivery; the message itself contains no additional information.
When E-mail Server attaches data to the inbound interaction, it is of two kinds. The first kind, structured information, is listed in the following table.
|_DSNInfo.RecipientCount||Any integer||Number of recipient addresses covered in this DSN|
|_DSNInfo.Recipient1.Recipient||Any string||Recipient address|
|Action applied for this recipient|
|_DSNInfo.Recipient2.Recipient||Same as _DSNInfo.Recipient1.Recipient|
|_DSNInfo.Recipient2.Action||Same as _DSNInfo.Recipient1.Action|
|_DSNInfo.RecipientN.Recipient||Same as _DSNInfo.Recipient1.Recipient|
|_DSNInfo.RecipientN.Action||Same as _DSNInfo.Recipient1.Action|
In RecipientN in the last two rows of the preceding table, N is the value of _DSNInfo.RecipientCount: the number of recipients covered in this InboundReport.
The second kind of information that E-mail Server attaches is raw information. That is, all information included in the reply e-mail’s header is attached as key-value pairs, with the key name formed by prefixing _DSNRawInfo to the field name used in the reply. Some examples are:
_DSNRawInfo.Reporting-MTA _DSNRawInfo.RecipientCount _DSNRawInfo.Recipient1.Original-Recipient _DSNRawInfo.Recipient1.Action _DSNRawInfo.Recipient1.Status _DSNRawInfo.Recipient1.Remote-MTA _DSNRawInfo.Recipient2.Final-Recipient
For details, see RFC 1894.
You request delivery status notification (DSN) by selecting the Delivery status notification box in a Send Email routing object. The reply to this request receives the subtype InboundReport. This reply conforms with RFC 1894, and includes, as attached data:
- The structured information listed in Table 21 on page 203.
- Note that if the _DSNInfo.RecipientN.Action key has a value of failed, E-mail Server assigns the reply the subtype InboundNDR, not InboundReport.
- The raw information contained in the keys whose names start with _DSNRawInfo, as described in the previous section.
- Individual DSN messages can be generated, each one related to one or several recipient addresses.
- A single DSN message can be generated, related to one or several recipient addresses.
You request message disposition notification (MDN, also called read receipt) by selecting the Message disposition notification box in a Send Email routing object. The reply to this request receives the subtype InboundDisposition. This reply conforms with RFC 3798, and includes, as attached data, the information listed in the following table.
|Mode of the action applied to the e-mail|
|What was done with the e-mail|
|How the message disposition notification is being sent|
|_MDNInfo.Recipient||Any string||Recipient address covered by this message disposition notification|
This reply is sent as long as all of the following conditions are met:
- It was requested in the outbound e-mail. This is independent of whether a delivery status notification was also requested.
- Delivery succeeded.
- Either of the following:
- The recipient agreed to send the read receipt.
- The recipient mailer was configured to automatically send read receipts.
In addition to the structured information listed in the preceding table, all information included in the reply e-mail’s header is attached as key-value pairs, with the key name formed by prefixing _MDNRawInfo to the field name used in the reply. Some examples are:
For details, see RFC 3798.