Responsive Email integration

Copernica, the company that develops MailerQ, also operates an online service to create responsive emails based on JSON input: responsiveemail.com. The algorithm to transform JSON into responsive emails has been embedded in MailerQ. If you feed MailerQ JSON (instead of MIME), it will be converted into valid email messages.

{
    "envelope": "sender@example.com",
    "recipient": "receiver@example.com",
    "mime": {
        "from": {
            "name": "John Doe",
            "address": "sender@example.com",
        },
        "subject": "Example email",
        "text": "Text version",
        "background": {
            "color": "white"
        },
        "content": {
            "blocks": [{
                "type": "html",
                "content": "<p>Example content</p>"
            }, {
                "type": "button",
                "label": "click here"
            }]
        }
    }    
}

MailerQ reads JSON objects from the RabbitMQ "outbox" queue. These JSON objects hold properties like "envelope", "recipient" and "mime", where the "mime" property is normally set to a string holding the full message source in MIME format. However, you can also assign a nested JSON object to this "mime" property (see above example). This nested object is processed by MailerQ and transformed into a MIME message.

There are many nested properties that are supported by the algorithm, which are all documented on the ResponsiveEmail.com website. Note that the properties that are described as top-level properties on the responsiveemail.com website, are (of course) nested properties inside the "mime" property of the object that is processed by MailerQ.

Writing your own HTML code

The ResponsiveEmail algorithm reads in a JSON object in which the texts, buttons and images are defined, and generates the HTML and MIME content based on that input. This means that you do not have to write the message source (HTML, CSS and MIME) yourself, or worry about the tricks to make your message compatible with all the various email clients.

However, if you do want to take care of the HTML yourself, you can also use the ResponsiveEmail algorithm for just the HTML-to-MIME conversion. In that case you just specify the header properties (from and to address, subject line) and the HTML and text source of your message, and rely on MailerQ to turn this into a valid MIME message:

{
    "envelope": "sender@example.com",
    "recipient": "receiver@example.com",
    "mime": {
        "from": {
            "name": "John Doe",
            "address": "sender@example.com",
        },
        "to": {
            "name": "Mister Receiver",
            "address": "receiver@example.com",
        },
        "cc": {
            "name": "Someone Else",
            "address": "randomguy@example.com",
        },
        "subject": "Example email",
        "headers": {
            "list-unsubscribe": "<mailto:unsubscribe@example.com>"
        },
        "text": "This is the pure text version of the email",
        "content": "<html><head> ..... </body></html>",
        "attachments": [ {
            "url": "http://www.example.com/document.pdf"
        } ]
    }
}

If you use the full ResponsiveEmail algorithm (where you do not have to write the HTML code yourself), you assign a deeply nested JSON object to the "content" property. Inside this "content" object you specify the images, texts, buttons and other elements that you want to include in your email. MailerQ turns this content into a responsive email message. However, in the above example we assigned a string to the "content" property. By doing this, MailerQ creates a MIME property with exactly the text and HTML that you've set in the JSON.

Config file variables

Cache

When emails are generated, MailerQ sometimes has to download resources from the internet to find out the dimensions of images and to fetch attachments. To prevent that the same resources are downloaded over and over again, MailerQ can be configured to use a cache. In the configuration file you can set the address of this cache:

download-cache:         directory:///path/to/dir
download-ttl:           3600

The "download-cache" property holds the address of the cache. The format of this address is the same as the message-store-options variable, and can refer to a directory (like we did above) or a nosql database if you use an address that starts with "mongodb://" or "couchbase://".

MailerQ inspects the 'cache-control' and 'expires' headers in the HTTP response to decide for how long a resource can be stored in the cache. With the 'download-ttl' config file variable you can set the upper limit for this. If you set it to 3600, downloaded files will stay for at most one hour (3600 seconds) in the cache, even if the HTTP response headers allowed a longer cache time.

User Agent

For the downloads, a custom user agent can be supplied. By default, the user agent mailerq uses is 'MailerQ '. This will be set in the header of all download requests MailerQ performs. This can be very useful for statistical purposes, where you want to keep track of all the requests that were made by MailerQ. Another example usecase is for basic authentication, however keep in mind that it is sent along with all requests to all downloaded URLs.

download-user-agent:    My custom user agent

Firewall bypass

Many users run MailerQ on a server with unrestricted access to the local network. MailerQ is then not only capable of fetching resources from the internet, but also directly from servers inside this local network. This makes it, for example, possible to use attachment URL's like "http://192.168.0.22/attachment.pdf". This could be a security risk, especially if the attachment and image URL's in your mails can be entered by third parties.

To prevent such internal downloads, you can use the config file variables "download-blacklist" and "download-whitelist" to limit the IP addresses to which MailerQ can connect.

download-blacklist:     192.168.0.0/16,127.0.0.1
download-whitelist:     192.168.0.30/32:80

Downloads from IP address on the blacklist are forbidden, unless the IP is also included in the whitelist. The above configuration prevents that MailerQ can connect to servers on the local network, with an exception for port 80 of IP 192.168.0.30.

Proxy server

It is possible that the server cannot access the internet, except through a proxy. That is why there is a config option to set up either a SOCKS or an HTTP proxy for downloads. For the proxy URI format, see proxy settings in other options. If unset, the global proxy-server variable will be the fallback.

download-proxy:    <proxy URI> (empty by default)

Latest News & updates

Contact MailerQ

De Ruijterkade 112

1011 AB Amsterdam

+31 (0)20 520 61 90

info@mailerq.com

Syntax	Meaning
`{$foo}`	Display a simple variable (no array or object).
`{$foo[4]}`	Display the 5th element of a zero-indexed array.
`{$foo.bar}`	Display the "bar" key value of an object.

Syntax	Meaning
`{$foo.bar.baz}`	Display the value behind the key "baz" inside the array "bar" which is a part of $foo.
`{$foo[4].baz}`	Display the value behind the key "baz" inside the 5th element of $foo.
`{$foo.bar.baz[4]}`	Display the 5th element of baz, which is in bar which is in $foo.

Syntax example	Meaning
$a == $b	$a and $b are equal
$a != $b	$a and $b are not equal
$a > $b	$a is greater than $b
$a >= $b	$a is greater than or equal to $b
$a < $b	$a is less than $b
$a <= $b	$a is less than or equal to $b
$a =~ "regex"	$a matches with supplied regular expression
$a AND $b	$a and $b are true
$a OR $b	$a or $b (or both) are true
not $a	Negation, will invert the boolean value of $a

Field	Required	Type	Description
name	yes	string	The name of the new pool
description	no	string	Description of the pool, for human use.

Field	Required	Type	Description
ip	yes	string	The name of the existing pool
name	yes	string	The address to be added

state	state in the delivery where the error occured
result	type or result (accepted,timeout,lost,error,invalid)
time	time of the result
mta	name of the receiving MTA (reported when the connection was set up)
from	ip from which the mail was sent
to	ip to which the mail was sent
authentication	if authentication/login was necessary for access, the authentication protocol used
cipher	the encryption protocol used (if the message was sent over a secure connection)
certificate	information about the ssl certificate that was issued by the receiving server
messages	number of messages sent over the same connection
sent/connection	Amount of bytes sent over the same connection
sent/data	Amount of bytes of MIME (no SMTP commands) sent over the same connection
code	SMTP result code
status	extended SMTP status code
description	answer received from receiving server
dsn	did the remote server implement the dsn protocol?

process	the input is checked and assigned to the from and to ip address between which it will be sent
suppression	Suppression List is checked
storage	the mime data is loaded from external nosql storage
responsive	the json message is converted into a responsive email
personalize	the message is personalized if personalization data is available
rewrite	the email is being rewritten
dns	the hostname to which the mail should be sent is looked up in DNS
bind	a local IP address is chosen from which the mail is going to be sent
connect	a tcp connection is set up
handshake	a handshake is being performed with the proxy server
intro	the TCP connection has been set up, waiting for initial welcome message from server
ehlo	the "EHLO" message has been sent
helo	the "HELO" message has been sent
starttls	the "STARTTLS" message has been sent
authplain	the "AUTH PLAIN" message has been sent
authlogin	the "AUTH LOGIN" message has been sent
authusername	the username for authentication has been sent
authpassword	the password for authentication has been sent
authcram	the "AUTH CRAM-MD5" message has been sent
authresponse	the response to the cram-md5 challenge has been sent
mailfrom	the "MAIL FROM" message has been sent
rcptto	the "RCPT TO" message has been sent
data	the "DATA" message has been sent
message	the full mime data followed by a dot has been sent
idle	smtp pipe was not processing any messages
unknown	the connection is in an unknown state, for example when a pipeline failed

accepted	message was accepted (only reported in combination with state "message")
timeout	no answer was received in time
lost	connection was lost while waiting for an answer
invalid	an answer was received, but it could not be recognized as valid answer
error	an answer was received, but the answer contained a fatal error message

state	result
process	timeout	incoming message was expired (maxdelivertime or maxattempts exceeded)
process	error	the input json contains a mail that could not be assigned to an ip address (for example because no sufficient secure ip exists)
process	invalid	the input json contains a mail that could not be sent (for example due to license constraints, or because the recipient is missing or not parsable)
storage	lost	smtp connection was lost while loading data
storage	invalid	smtp response was received while loading data
storage	error	no data was found
responsive	error	responsiveemail.com algorithm could not turn json into mime
dns	error	dns lookup failure (domain does not exist / no ip addresses available for accepting mail)
bind	error	no local ip addresses available for sending mail

fatal	should be the message be retried, or was this result already a permanent failure
individual	override whether or not an error applies to a single message, or rather to any message sent to the domain
strange	is this is a strange type of result
greylisted	should this result be sent from the same ip later
fallback	should this result trigger a fallback server

Setting	Description
application-log	Full path to the application log
cluster-address	Address for a cluster to share between instances
cluster-exchange	Set cluster exchange
cluster-timeout	Number of seconds the --list-cluster option waits
cluster-verify	Should the server certificate be verified (only used for amqps:// connections)
database-address	Relational database for config data and delivery settings
database-ttl	Time to live: Database reload interval (Default 600s)
database-validate	Check and fix database settings on startup
download-blacklist	IP addresses from which no resources can be downloaded
download-cache	Address of the cache (Used in ResponsiveEmail)
download-log-format	Download log format
download-log	Download log filename
download-ttl	Max time to keep downloaded resources in the cache (Used in ResponsiveEmail)
download-whitelist	Exceptions to the download-blacklist
download-proxy	Route outgoing download requests through a proxy
dsn-advertise	Toggle announcement about DSN extension and parameters
dsn-notify	Events that trigger a notify
dsn-ret	Send full mail (FULL) or headers (HDRS) for notifications
dns-min-ttl	Minimum TTL to respect when doing domain lookups
dns-nameserver	The nameservers to use when doing domain lookups
heartbeat-enabled	Toggle user statistics (default: true)
license	MailerQ license file
lock	Process ID for MailerQ instance to prevent from starting instances more than once
max-attempts	Maximum attempts to deliver email
max-delivertime	Maximum time spent trying to deliver email
plugin-directory	Directory with MailerQ plugins
proxy-server	Setup proxy for outgoing HTTP requests
rabbitmq-address	Location and authentication to connect to RabbitMQ
rabbitmq-consumers	Amount of consumer threads (default: 1)
rabbitmq-declare	Enable or disable checking and declaring the queues on startup
rabbitmq-dsn	Your RabbitMQ delivery status notification queue
rabbitmq-durable	Durable/not durable RabbitMQ queues (default: true)
rabbitmq-encoding	Choose encoding for messages (such as gzip)
rabbitmq-exchange	RabbitMQ exchange
rabbitmq-failure	Your RabbitMQ failure queue
rabbitmq-inbox	Your RabbitMQ inbox queue
rabbitmq-local	Your RabbitMQ local queue
rabbitmq-lazy	Lazy/non lazy RabbitMQ queues (default: non-lazy)
rabbitmq-maxpriority	Enable the use of priority queues
rabbitmq-qos	Set a maximum number of messages simultaneously consumed per consumer thread
rabbitmq-minqos	Set a minimum number of messages simultaneously consumed per consumer thread
rabbitmq-flush-qos	Set a maximum number of messages simultaneously consumed during flush
rabbitmq-outbox	Your RabbitMQ outbox queue (must be unique if multiple instances of MailerQ are used)
rabbitmq-persistent	Persistent/not persistent RabbitMQ queues (default: false)
rabbitmq-publishers	Amount of publisher threads (default: 1)
rabbitmq-queues	Names of the RabbitMQ queues to manage email (inbox, failures, retries, etc...)
rabbitmq-refused	Your RabbitMQ refused queue
rabbitmq-reports	Your RabbitMQ report queue
rabbitmq-results	Your RabbitMQ result queue
rabbitmq-retry	Your RabbitMQ retry queue
rabbitmq-success	Your RabbitMQ success queue
rabbitmq-verify	Should the server certificate be verified (only used for amqps:// connections)
received-log-format	Received log format
received-log	Received log filename
retry-interval	Interval for retrying to send
send-bin-log	Binary send log filename
send-log	Send log filename
send-log-format	Send log format
server-id	Server ID to prevent multiple instances from assigning same message ID
smarthost	Smarthost name (only needed if Smarthost is desired)
smarthost-password	Smarthost password
smarthost-port	Smarthost port
smarthost-username	Smarthost username
smtp-auth	Authentication string for authenticating to SMTP server
smtp-auth-results	Toggle adding authentication results to MIME header
smtp-certificate	Certificate for secure SMTP connections
smtp-check	Comma separated list of checks to perform on incoming messages
smtp-ciphers	Supported ciphers for secure SMTP connections
smtp-connections	Maximum amount of open TCP connections allowed
smtp-default-ips	List of default outgoing IP addresses
smtp-extract	Toggle automatic extraction of metadata
smtp-hostname	The hostname that clients see when connecting to the SMTP server
smtp-ip	SMTP server IP
smtp-key	Private key for secure SMTP connections
smtp-mappable-ips	List of mappable IP adresses
smtp-maxsize	Maximum message size to accept
smtp-port	Ports for incoming MailerQ connections
smtp-proxy	IPs to treat as connection from proxy server
smtp-range	Range of IP address to allow incoming email for
smtp-secure port	Ports for secure incoming MailerQ connections
smtp-sink-address	SMTP sink domain name or ip address
smtp-sink-password	SMTP sink password
smtp-sink-port	SMTP sink port
smtp-sink-username	SMTP sink username
smtp-threads	Number of threads started for SMTP traffic
smtp-timeout	Max idle time on incoming SMTP connections
smtp-protection	Enable SMTP incoming IP blacklist
smtp-unmappable-ips	List of unmappable IP addresses
spamassassin-host	Address for SpamAssassin daemon
spamassassin-port	Port for SpamAssassin daemon
spool-delay	Delay for processing spool directory files
spool-directory	Path to the directory to monitor
spool-extract	Toggle scanning for headers in spool directory mail
spool-fail-directory	Path to move files to that could not be picked up
spool-open-files	Amount of files that may be open simultaneously by the spool directory
spool-remove	Toggle removal of files from spool directory
spool-threads	Amount of threads to use for the spool directory
storage-address	Address for external message storage
storage-policy	Message store policy
storage-reschedule	Number of seconds to wait before a mail is retried
storage-threads	Storage threads
storage-timeout	Timeout for fetch operations
storage-ttl	Time to live: Storage reload interval
user	Change user for MTA
validate-envelope	Validate envelope address before sending
validate-recipient	Validate recipient address before sending
www-auth	Management console authentication string
www-cache-control	Enable or disable browser cache
www-certificate	Certificate file for secure connection to management console
www-ciphers	Supported ciphers for secure management console
www-connections	Limit for simultaneous HTTP connections to built-in HTTP server
www-ip	Web interface IP (IP/port combination unique for every instance of MailerQ)
www-dir	Directory for installing MailerQ management console files
www-host	Web interface host (IP/port combination unique for every instance of MailerQ)
www-port	Port number for the management console
www-private-key	Private key for secure connection to management console
www-secure-port	Secure (HTTPS) port number for the management console
www-url	The URL via which the management console is accessible

Setting	Description
daemon	Deamon process (deafault true)
disable-crash-report	Disable crash report
disable-crash-post	Disable automatic crash posting
extract-recipients	Read in a mime message from standard input and filter out the destination addresses
ignore-dot	Instruct MailerQ that dots do not have a special meaning
list-ips	List IP addresses
loopback	Loopback
notify-cluster	Notify cluster
paused	Pause
purge-database	Rebuilding the database tables
repair-database	Repair the database
version	Version

Field	Required	Type	Description
pool	no	string	Pool that the pause applies to.
mta	no	string	MTA IP that the pause applies to.
domain	no	string	Domain that the pause applies to.
ip	no	string	Remote IP that the pause applies to.
tag	no	string	The tag that the pause applies to.
cluster	no	bool	Whether or not this pause is for the entire cluster or only this instance.
expire	no	timestamp	At what time point in the future should this pause be removed

Field	Required	Type	Description
code	yes	int	Numeric error code between 200 and 599 (smtp error codes).
extended	false	string	Extended SMTP error code, e.g. 5.7.1.
description	false	string	Description to put in the message result.
pool	no	string	Pool that the error applies to.
mta	no	string	MTA IP that the error applies to.
domain	no	string	Domain that the error applies to.
tag	no	string	The tag that the error applies to.
cluster	no	bool	Whether or not this error is for the entire cluster or only this instance.

Modifier	description
base64_encode	base64 encoder
base64_decode	base64 decoder
cat:"string"	concatenates a string to variable
count	count number of elements in variable
count_characters	count number of characters in a string
count_paragraphs	count number of paragraphs in a text (by counting newlines)
count_words	count number of words in a text
default:default value	use default value if variable is not set
empty	check whether a variable is empty
escape:"string"	escape html characters (or other chars) inside a string
indent:num = 1:char = " "	put num whitespaces in front of every line
md5	perform md5 hashing
nl2br	replace newlines with html br tags
range:start = 0:end	truncate list to get the items between positions start and end
regex_replace:regex:replace_text	replace substrings using regular expression
replace:"string1":"string2"	replace occurrences of string1 with string2
sha1	perform sha1 hashing
sha256	perform sha256 hashing
sha512	sha512 hashing
spacify:separator = " "	place a separator between every input character
strlen	count the characters in a string
strstr:"substring":before = false	return the string starting from the first occurrence of substring if before = false. otherwise return the string until the first occurrence.
substr:start position:length	return the substring from start position onward, optionally truncated after length characters
tolower	convert all characters to lower case
toupper	convert all characters to upper case
trim	trim the white space and endline characters off both sides of the input
truncate:length = 80:etc = "...":break_words = false	truncate inputs that are longer than length and append etc at the end. break_words = true allows truncating parts of words
ucfirst	replace first character with an upper case character
urlencode	encode input for use in an url
urldecode	decode input for use in an url

Callable function	Description
MQ_email()	Access to the underlying email address
MQ_local()	Check whether a recipient address is "local"
MQ_setLocal()	Mark a recipient as "local"

Debian 12 (bookworm)	deb https://packages.mailerq.com/debian bookworm main
Debian 11 (bullseye)	deb https://packages.mailerq.com/debian bullseye main
Debian 10 (buster)	deb https://packages.mailerq.com/debian buster main
Ubuntu 22.04 (jammy)	deb https://packages.mailerq.com/debian jammy main
Ubuntu 20.04 (focal)	deb https://packages.mailerq.com/debian focal main
Ubuntu 18.04 (bionic)	deb https://packages.mailerq.com/debian bionic main

Tables	Description
capacity	all delivery capacities, eg max number of connections
capacity_rules	capacity rules per domain / MTA IP
dkim_keys	DKIM Keys to sign outgoing mails
dkim_patterns	rules that decide what DKIM Keys to use
dns	overridden dns lookups
errors	Forced Errors
flood_responses	alternative delivery limits to use when certain responses come in
ips	all MailerQ's IP addresses
locals	Local Email Addresses
mtanames	alternative "EHLO" names
paused	deliveries on pause
response_actions	response action, eg send mail from a different IP
response_patterns	patterns of responses that has to match
response_patterns_actions	what kind of response actions must be executed
rewrite_actions	actions to perform when a message is loaded eg send from a different IP
rewrite_triggers	triggers to fire rewrite actions

Function name	Description
mq_version()	Returns API version number to ensure that MailerQ and plugin are compatible
mq_initialize()	Called right after the plugin is activated, allows plugin to run initialization code
mq_cleanup()	Called right before MailerQ closes, allows plugin to run cleanup code

hostname	server name that received the message
received	time when the mail was received
message-id	unique message id generated for the mail (only used when received via smtp)
connection	connection info (only used when received via smtp)
spool	spool info (only used when received from spool dir)
cli	command info (only used when received from cli)
checks	array with the results of the SPF, DKIM and DMARC checks

envelope	envelope ("MAIL FROM") address
recipient	recipient ("RCPT TO") address
mime	full mime data to be sent
key	key to the mime data in external storage
keepmime	do not remove mime data after delivery
data	personalization data
ips	ip addresses to send the message from
pool	pool identifier to send the message from
nextattempt	properties for when the next attempt should be
maxdelivertime	time until which a delivery should be retried
maxattempts	max number of delivery attempts
retries	the delays between the delivery attempts
force	force delivery, even when errors occur or conversion is impossible
inlinecss	turn style blocks in html mails into inline style attributes
dkim	private keys to sign the mail
dsn	settings for delivery status notifications
queues	alternative rabbitmq queues for results
smarthost	smarthost settings
tags	the tags to add to the message
headers	add or change the mime headers
priority	the priority of the message
security	the security preference of the message

optional	the message will make use of whatever is available, and will not specifically use STARTTLS
opportunistic	the message will use STARTTLS if it is available, but otherwise sends over an unsecured connection
required	a secure connection is required for the message to be sent
verified	the connection has to be secure, and the certificate and cipher have to match the email domain

Function name	Description
mq_smtp_in_message()	Called by MailerQ when a message is received on an incoming SMTP connection
mq_smtp_out_data()	Called by MailerQ right after it has sent the "DATA" command and is about the send MIME data

Function name	Description
MQ_envelope()	Get access to the envelope address
MQ_setEnvelope()	Set the envelope address
MQ_recipient()	Get access to the recipient address
MQ_setRecipient()	Set the recipient address
MQ_mime()	Get access to the MIME data
MQ_setMime()	Get the MIME data

notify	comma separated events that trigger a notification (FAILURE, DELAY, SUCCESS, NEVER)
ret	should the notification hold the full original mail or just the headers (FULL, HDRS)
orcpt	the address to be included in the notification as "original-recipient"
envid	unique identifier to be included in the notification as "original-envelope-id"

Function name	Description
mq_context_initialize()	Called after a worker thread is started, allows plugin to run thread specific initialization code
mq_context_cleanup()	Called right before a worker thread is stopped, allows plugin to run thread specific cleanup code

Function name	Description
mq_smtp_in_connect()	Called after an incoming TCP connection is established
mq_smtp_in_secure()	Called after an incoming TCP connection is turned into a secure connection
mq_smtp_in_authenticate()	Called after someone sends login credentials over an incoming SMTP connection
mq_smtp_in_mailfrom()	Called after the `MAIL FROM` instruction was received
mq_smtp_in_rcptto()	Called after the `RCPT TO` instruction was received
mq_smtp_in_data()	Called after MIME data was received over the incoming connection
mq_smtp_in_message()	Called after the entire message was received and is turned into a JSON message
mq_smtp_in_close()	Called after an incoming SMTP connection is closed

Function name	Description
mq_smtp_out_data()	Called by MailerQ when the connection enters data state
mq_smtp_out_sent()	Called by MailerQ after all mime data has been sent

Implementable function	Description
mq_context_initialize()	Called by MailerQ when a worker thread is created
mq_context_cleanup()	Called by MailerQ when a worker thread is destroyed

Configuration

Overridability

In-depth settings

Are you looking for more settings?

More information

Getting started with MailerQ

Programming

Variables

Dashes and underscores

Modifying your variables

Simple calculations

Conditional statements

Foreach

Assigning variables

Using curly braces in your text

Layout issues

Pushing emails directly to RabbitMQ

Sending messages

Compression

Java example

Send

Send.java

Result

Result.java

Putting it all together

How to send email with MailerQ?

Function mq_context_cleanup

Function mq_smtp_in_data

AmqpDelayer

Installation

Integration with MailerQ

Running

Configuration

Supported options for RabbitMQ

Supported options for storage

Options to limit message delays

Operation and shutdown procedure

RabbitMQ and storage tuning

RabbitMQ Quality of Service (QoS) and transaction sizes

Throttling and message revival

Built-in webserver

MailerQ Webhook

Installation

Quick start

Manual setup

REST API V1 Pools

GET

POST

DELETE

Function MQ_setConnectionData

Temporary queues in RabbitMQ

Purpose of temporary queues

Naming conventions

Configuration options

Result message queues

Different result queues

Example scenario

Understanding the results

Added properties

Delivery states

Result types

Special combinations

Secure connections

Overriding errors

Function MQ_continue

Function mq_context_initialize

Function mq_smtp_in_rcptto

DNS configuration

DNS timeouts

Nameservers

Timeouts

Quality of Service

Buffer size

Rotation

License file

License file location

Questions or remarks?

Configuration A-Z

Boolean options

Function MQ_secure

`Send`

`Send.java`

`Result.java`

Callable function	Description
MQ_contextData()	Retrieve the plugin managed data from the context
MQ_setContextData()	Assign plugin managed data to the context

Callable function	Description
MQ_ev()	Access to the underlying libev instance
MQ_ioWatch()	Watch a filedescriptor for activity
MQ_ioUnwatch()	Stop watching a filedescriptor for activity
MQ_startTimer()	Start a timer
MQ_stopTimer()	Stop a timer
MQ_resetTimer()	Reset a timer to a new timeout

Field	Required	Type	Description
public_ip	yes	string	The external IP address to use for sending
local_ip	yes	string	The local IP address to bind to
connect_ip	no	string	The IP to use for the external server
connect_port	yes	int	The port to use for the external server
protocol	yes	string	The protocal to use to connect to the external server ('nat' / 'socks' / 'http')

Callable function	Description
MQ_fileDescriptor()	Retrieve the filedescriptor linked to a connection
MQ_send()	Send data over a SMTP connection
MQ_authenticated()	Returns whether this is an authenticated connection
MQ_setAuthenticated()	Mark a connection as an authenticated connection
MQ_secure()	Returns whether this is a secure TLS connection
MQ_connectionData()	Retrieve the data that is associated with the SMTP connection
MQ_setConnectionData()	Associated data with the SMTP connection

Function name	Description
MQ_continue()	Tell MailerQ to call the next plugin
MQ_complete()	Tell MailerQ to skip all further plugins
MQ_retry()	Tell MailerQ to restart calling all plugins

Field	Required	Type	Description
value	yes	string	The domain or address to be suppressed
type	yes	string("address", "domain")	Whether the given value is a domain or a full address
code	yes	string	The error code given to suppressed messages.
extended	no	string	Extended SMTP error code, e.g. 5.7.1.
description	no	string	Description to put in the message result.

x-mq-envelope	explicit envelope address
x-mq-ip	IP address to send mail from
x-mq-pool	pool identifier to send the message from
x-mq-tag	adds a tag to the message
x-mq-delayed	time when message should be sent
x-mq-maxdelivertime	max time for delivery
x-mq-maxattempts	max number of delivery attempts
x-mq-retries	interval in seconds between the attempts
x-mq-inlinecss	instruct MailerQ to inlinize the CSS code
x-mq-results-queue	alternative queue for the results
x-mq-failure-queue	alternative queue for the failures
x-mq-success-queue	alternative queue for the successes
x-mq-retry-queue	alternative queue for the retries
x-mq-smarthost-hostname	hostname of smarthost to send email to
x-mq-smarthost-port	portnumber of the smarthost
x-mq-smarthost-username	login for the smarthost
x-mq-smarthost-password	password to access the smarthost
x-mq-dsn-notify	the events for which to receive a DSN
x-mq-dsn-ret	whether to send the full body or just the headers in DSN
x-mq-dsn-orcpt	the original recipient for the DSN
x-mq-dsn-envid	unique identifier for the DSN message
x-mq-keepmime	do not remove the full mime object after delivery

Code	Status (SMTP Error)	Description
211	2.1.1	System status, or system help reply
214	2.1.4	Help message
220	2.2.0	Service ready
221	2.2.1	Service closing transmission channel
250	2.5.0	Requested mail action okay, completed
251	2.5.1	User not local; will forward to <forward-path>
354	3.5.4	Start mail input; end with <CRLF>.<CRLF>
421	4.2.1	<domain> Service not available, closing transmission channel
450	4.5.0	Requested mail action not taken: mailbox unavailable
451	4.5.1	Requested action aborted: local error in processing
452	4.5.2	Requested action not taken: insufficient system storage
500	5.0.0	Syntax error, command unrecognised
501	5.0.1	Syntax error in parameters or arguments
502	5.0.2	Command not implemented
503	5.0.3	Bad sequence of commands
504	5.0.4	Command parameter not implemented
521	5.2.1	<domain> does not accept mail
530	5.3.0	Access denied
550	5.5.0	Requested action not taken: mailbox unavailable
551	5.5.1	User not local; please try <forward-path>
552	5.5.2	Requested mail action aborted: exceeded storage allocation
553	5.5.3	Requested action not taken: mailbox name not allowed
554	5.5.4	Transaction failed

Tables	Description
libopenssl	Used for TLS encryption, license checking and base64 encoding
libz	Used for compression algorithms
libmagic	Used to detect the mime-type of files
libuuid1	Used for generating globally unique identifiers
libidn	Used for parsing international domain names
libxml2	Used for parsing and modifying XML/HTML code
libimagemagick	Used to find out the dimensions of images
libmysqlclient	Used to connect to a mysql/mariadb database
libmariadbclient	Used to connect to a mysql/mariadb database
libpq	Used to to connect to a Postgresql database
libsqlite3	Used to process sqlite3 database files
libmongo-c-driver	Used to connect to a MongoDB NoSQL server
libcouchbase	Used to connect to a Couchbase server