SimpleMH Injection

• Table of Contents
• Introduction
• SimpleMH Features
  • Core Features
  • Optional Features
• SimpleMH Telnet Example

Introduction

There are two methods for injecting messages into GreenArrow Engine - SimpleMH and Raw Injection. We recommend that new integrations use SimpleMH, rather than Raw Injection. SimpleMH was introduced after Raw Injection, provides a lot of features that Raw Injection does not, and is usually easier to integrate with.

Mail that’s injected using SMTP into port 587 or via the HTTP Submission API uses SimpleMH by default. Mail injected via any other mechanism uses Raw Injection by default. SimpleMH can be enabled by doing any of the following:

• Include the X-GreenArrow-MailClass header in messages
• Turn SimpleMH on for one of the SMTP services. This will cause all mail that’s injected into the SMTP service to be processed by SimpleMH
• Turn on SimpleMH for specific injecting IP addresses

A message can be assigned to a Mail Class by matching on one of the following:

• The value of the X-GreenArrow-MailClass header (Recommended method)
• The SMTP AUTH username
• The injecting IP address
• The Subject
• The From address
• The default Mail Class if none of the above tests produce a match
• Custom code

SimpleMH Features

SimpleMH introduces the following features, which are not available with Raw Injection.

Core Features

The following features are always on:

• Each message that uses SimpleMH is assigned to a Mail Classes, which controls the default VirtualMTA, ListID, and SendID, as well as which optional features are turned on and what their settings are
• The Return-Path (bounce address) is automatically set to the correct value for you
• A List-Unsubscribe header is automatically inserted for you, if not already present in the injected message
• The X-Mailer-Info header is automatically inserted for you

Optional Features

The following features can be turned on and off:

• Click and open tracking
• Unsubscribe link processing
• Sending click, open, unsubscribe, bounce and spam complaint data back to your application via the Event Notification System
• Sample message archiving
• Automatic seeding of the GreenArrow Monitor seed list
• Conversion of text-only messages into HTML
• HTML message modifications
• Bad Address Suppression
• Add a BCC address to all messages in a Mail Class
• Custom code

Most of these features can be configured on a per-Mail Class basis as described on the Mail Classes in SimpleMH page.

SimpleMH Telnet Example

telnet localhost 587
HELO localhost
MAIL FROM: <[email protected]>
RCPT TO: <[email protected]>
DATA
From: Info <[email protected]>
To: Subscriber <[email protected]>
Subject: SimpleMH example send
X-GreenArrow-MailClass: trans

This is a SimpleMH Injection test.

This is a <a href="http://www.example.com/">test link</a>.

This is an <a href="##unsubscribetag##http://www.example.com/unsubscribe-confirmed.php">unsubscribe link</a>
.
QUIT