Administering the Bounced Mail Framework

Use

The Bounced Mails Framework (BMF) is designed to manage bounced mails during the communication between a customer client application and an external system.

Processing Outgoing Mails

The BMF handles all mail messages that a client application sends. If outgoing mail filtering is enabled, the BMF checks the address and continues processing only if it is a trusted one:

  1. The BMF assigns an ID to the message From and Subject fields and records additional data about the sent mail in its database.
  2. The BMF assigns the status Sent to the message.

    The status can change later depending on the message reply.

  3. The BMF sends the message to the relevant external system and waits for a response.

Processing Incoming Mails

  1. In a normal situation, the BMF expects and receives a response from the external system.
  2. If incoming mail filtering is enabled, the BMF checks the received mail address and forwards the mail to the client application only if it is a trusted one. The client application processes the mail and sends the result back to the BMF.
  3. At the same time, the BMF analyzes the incoming mail as follows:
    1. The BMF maps incoming messages to the outgoing mails stored in its database using the ID assigned previously. If the incoming mail matches a stored message, the BMF tries to find a rejection reason. Otherwise, its flags the mail as Unrecognized.
    2. If the mail is recognized, the BMF tries to identify the rejection reason using patterns.
  4. The BMF changes the status of the original outgoing mail according to the result of the client application processing, mail mapping and rejection reason identification. It also executes the action groups defined for the corresponding client application. Each action group contains simple actions, which are executed one by one.

Mail Statuses

The BMF assigns different mail statuses to outgoing mail messages depending on the reply from external systems.

More information: Mail Statuses

Procedure

The following procedure outlines the basic steps to configure, manage, and use the BMF.

1. Set Up the Framework

To enable a client application to use the BMF, you must first configure BMF mail-sending options:

  1. From the contextual panel, choose Administer Bounced Mail Framework → You Can → Settings.
  2. Enter the BMF administrator's mail.
  3. Configure additional options, if required:
    • Automatic Client Registration

      If enabled, each client application can register automatically. Otherwise, only applications with IDs added manually by the administrator can register.

    • Disable Sending

      If enabled, the BMF stopssending all types of mails.

2. Set Up and Manage Client Applications

Set up a client application to use the BMF by creating a client application ID. Once you register and configure the application, all incoming and outgoing mail messages are controlled by the BMF.

More information: Setting Up Client Applications

Optional: Clean Up the BMF Database

You can configure the BMF to clean up messages from its database by moving them to Statistics periodically.

More information: Cleaning Up the BMF Database

Optional: View Statistics

You can see detailed statistics for the mails processed by the BMF over a specified period of time.

More information: Viewing Statistics