GreenArrow Email Software Documentation

Mail Classes

GreenArrow Engine’s SimpleMH system classifies mail into Mail Classes. Each message that’s processed by SimpleMH is assigned a Mail Class, which is used to determine which SimpleMH Mail Features to use.

A comparison of SimpleMH and Raw Injection can be found in the Injecting Mail page.

SimpleMH’s headers are described in the SimpleMH Headers page.

Mail Class Selection Precedence

There are multiple methods available for specifying which Mail Class a message will use. When multiple methods are used for the same message, the first match in the following list is used:

  1. The X-GreenArrow-MailClass header
  2. The GREENARROW_MAILCLASS environment variable (either in an IP relay authorization or passed as a variable while using a local injection option
  3. SMTP AUTH username matching
  4. $DEFAULT_MAILCLASS_SUB in SimpleMH’s configuration file
  5. $DEFAULT_MAILCLASS in SimpleMH’s configuration file

Adding a Mail Class

To add a Mail Class to GreenArrow Engine’s configuration, complete the following steps:

  1. Login to the GreenArrow Engine Web Interface.
  2. Navigate to Configure => Mail Classes:
    configure-mail-classes.png
  3. Click the Add Mail Class button:
    add-mail-class-button.png
  4. In the New Mail Class form, complete the form and click Save. See reference below for details about mail class attributes.

new-mail-class-form.png

Editing a Mail Class

To edit an existing Mail Class, complete the following steps:

  1. Login to the GreenArrow Engine Web Interface.
  2. Navigate to Configure => Mail Classes:
    configure-mail-classes.png
  3. Click the Edit button next to the Mail Class that you wish to edit:
    mail-classes-index.png
  4. Fill in the form, then click Save. This form’s fields are described in the section below.

Mail Class Attributes

Name

string

The name that you wish to assign the Mail Class. This is the value that you’ll be able to use later when including the X-GreenArrow-MailClass header in messages belonging to this Mail Class. The following rules apply to Mail Class names:

  • Names may consist of letters and underscores.
  • The “a” Mail Class is reserved and may not be created.
  • Two or more underscores may not appear next to each other. For example, “server__a__email” is invalid, but “server_a_email” is valid.
  • The name length can not exceed 64 characters.
  • Please see the Bounce Processor Concepts documentation for caveats regarding long mail class names.
Virtual MTA

selection list

The VirtualMTA to assign mail in this Mail Class to.

Mailing List ID

string

The ListID to assign mail in this Mail Class to

Bounce Address

selection list

The Bounce Address to use for mail in this Mail Class. The list contains:

BCC All Messages

enabled/disabled

Add a BCC to every email sent using this Mail Class.

Add Custom Headers

enabled/disabled

Add custom headers to emails sent using this Mail Class.

  • A maximum of 1024 bytes are allowed.
  • The only X-GreenArrow-* headers allowed are (see SimpleMH Headers for usage)
    • X-GreenArrow-DKIM
    • X-GreenArrow-DKIM-Only-Using-Domain
    • X-GreenArrow-Signing-Selector
  • The X-Mailer-Info header is prohibited.
Add Message-ID if missing

enabled/disabled

If the injected message does not include a Message-ID header, one will be generated automatically.

Track Clicks and Opens

enabled/disabled

Turns click and open tracking on or off for this Mail Class.

Handle Unsubscribe Links

enabled/disabled

Turns unsubscribe link processing on or off for this Mail Class.

Pass Bounce Messages Through

enabled/disabled

Send a copy of each bounce message back to the original Return-Path recipient. Engine will still process the bounce locally when using this feature.

If you enable this feature, make sure that the original Return-Path domains have throttling configurations in place which allows Engine to deliver these bounces as quickly as they come in. Otherwise, the bounce pass through messages could fill up GreenArrow’s queues as they wait to be delivered. That situation has the potential to slow deliveries to a crawl system wide.

URL Domain

selection list

Choose the URL Domain to use in Click + Open tracking for mail sent via this Mail Class.

Archive a Sample of Messages

enabled/disabled

Archives sample messages to a table in GreenArrow Engine’s PostgreSQL database.

Disable Automatic List-Unsubscribe Header

enabled/disabled

If the injected message does not include a List-Unsubscribe header, one will be generated automatically. This option disables this behavior.

Automatically Seed Mailings

enabled/disabled



Causes SimpleMH to send sample messages belonging to this Mail Class to the GreenArrow Monitor seed list. Sends to addresses in GreenArrow Monitor’s seedlist occur once per Send, and are evenly distributed between the times that GreenArrow Engine receives the message numbers designated in the Number of emails to start seeding at and Number of emails to finish seeding by fields.

When this feature is enabled, GreenArrow Monitor groups all messages for this Mail Class into one campaign per Send. This takes precedence over the X-CampaignID header.

Number of Emails to Start Seeding At

number

Set this field’s value to the daily message volume below which, you don’t want automatic seeding to take place. The field is hidden unless the Automatically seed mailings box is checked.

Number of Emails to Finish Seeding By

number

Set this field’s value to the minimum number of messages that would be sent on a Send that automatic seeding occurs. If this field is set to a value that’s higher than the number of messages that are sent, then only a portion of the GreenArrow Monitor seedlist will be sent to. The field is hidden unless the Automatically seed mailings box is checked.

Convert Text-only Messages into HTML

enabled/disabled

Converts text only messages to HTML. If this box is checked, additional fields appear, which allow you specify an HTML header, HTML footer, the text that should appear for converted links, and regular expression operations to perform before, and after conversion to HTML.

Modify HTML messages

enabled/disabled

If this box is checked, additional fields appear which allow you specify how you’d like HTML messages to be modified.


Copyright © 2012–2024 GreenArrow Email