for email broadcasters

Topics in this area:

newsletter software settings

newsletter softwares' configuration examples: GroupMail - Inxmail Professional - Joomla AcyMailing - MaxBulk Mailer - phplist - SendBlaster - WordPress MailPoet 3 - WordPress MailPoet 2 - WordPress Mailster

make it easy to unsubscribe

auto set up of one-click unsubscribe for email messages

bouncehandler app

to analyze bounced messages, extract hard bounces and soft bounces

copymail app

to send mass mailings directly from your email client

Subsections of for email broadcasters

newsletter software settings

To start using RealSender:

  1. Request a free trial account

  2. Change the settings of the outgoing mail (SMTP) within your newsletter software:
    GroupMail - Inxmail Professional - Joomla AcyMailing - MaxBulk Mailer - phplist
    SendBlaster - Sendy - WordPress MailPoet 3 - WordPress MailPoet 2 - WordPress Mailster

    Your’s not in the list above? Contact us!
    Alternatively, evaluate the “copymail app” option!

    Visit the “Email Client” page if you use individually configured email clients.
    Visit the “Email Server” area if you use a centralized email system.

  3. Change your domain’s settings to authenticate the sent messages with SPF
    (this is generally done after the trial period)

  • Why? If you wish to have email from your domain sent through a third party service,
    you must configure your SPF record to permit delivery from the service provider’s IP addresses.
    If you don’t do this, then you risk having email receivers reject all email sent from your domain.

  • Setting up the RealSender SPF record is easy:
    all you have to do is add include:spf.realsender.com to your SPF record, and you’re done.

We automatically sign emails with DKIM, so you don’t need to do anything else.

Questions? Contact us!

Subsections of newsletter software settings

GroupMail

GroupMail

GroupMail > Tools

Manage Accounts > New

GroupMail - account properties - user information

Account Properties

Name / User Infomation:
fill in the form with your company’s data

GroupMail - account properties - delivery options

Delivery Options

Delivery Options: Standard

SMTP Server: rsxxx-realsender.com
[x] Requires Authentication

[setup]

GroupMail - account properties - delivery options - authentication settings

Authentication Settings

[x] Use SMTP Authentication (outbound)

Type: AUTH LOGIN (Default)

Username: (the one we sent you)

Password: (the one we sent you)

[OK]

GroupMail - account properties - delivery options - advanced email settings

Advanced Email Settings

SMTP Port: 25

[x] Server requires an SSL connection

Use: STARTTLS (default)

[OK]

Inxmail Professional

Inxmail

Global Settings > Administration

> Mail Server > Sending Emails

inxmail professional - global settings - administration - mail server - sending emails

Mail account settings

Name: rsxxx.realsender.com

SMTP mail server: rsxxx.realsender.com - Port: 25

Max. connections: 3

[x] Authentication
User name: (the one we sent you)
Password: (the one we sent you)

[x] Activate TLS, if possible

[Save]

[Activate connection to the mail server account]

Joomla AcyMailing

Joomla AcyMailing Joomla AcyMailing

Joomla > Components

AcyMailing > Configuration

Joomla AcyMailing - Sender Information

Sender Information

fill in the form with your company’s data

Joomla AcyMailing - Mail Configuration

Mail Configuration

Mailer Method: SMTP Server

Joomla AcyMailing - SMTP Configuration

SMTP Configuration

Server: rsxxx.realsender.com
Port: 465
Secure Method: SSL

Keep Alive: [x] Yes
Authentication: [x] Yes

Username: (the one we sent you)
Password: (the one we sent you)

MaxBulk Mailer

MaxBulk Mailer

[Settings]

MaxBulk Mailer - Settings

Settings

Connections: 2

SMTP server access

SMTP host: rsxxx.realsender.com - TLS v1 EXP

Authentication: ESMTP - Plain

Account ID: (the one we sent you)

Password: (the one we sent you)

Delivery: [x] Singly (recommended)

Group mail: All at once

Sender information

From: (the sender email address)

Name: (the sender description)


Drop down menu (top left)

[Save new account as…]

Name: rsxxx

[Create]

phplist

phplist logo

Configuration tested on:
phplist, version 3

Attention: make a backup copy before making
any changes on your phplist server configuration files
phplist config

phplist - config

Fill phplist/htdocs/config/config.php
with the correct data:

[…]
define(‘PHPMAILERHOST’, ‘rsxxx.realsender.com’);
[…]

define(‘PHPMAILER’,1);
define(‘PHPMAILER_SECURE’,‘TLS’);

$phpmailer_smtpuser = 'the one we sent you'; $phpmailer_smtppassword = ’the one we sent you’;
$phpmailer_smtpport = 587;

$pageroot = ‘/’;


Send a test message (phplist > Campaigns > Send a campaign > Send test):

phplist - send test

SendBlaster

SendBlaster

Messages > Send

SendBlaster - messagges - send

Send settings:

Send mode: [x] Use SMTP server

SMTP Server: rsxxx.realsender.com
Port: 25 - [x] SSL

[x] Authentication required

Username: (the one we sent you)
Password: (the one we sent you)

[Take snapshot]

Sendy

Sendy

Sendy

![Sendy - Add a new brand](images/sendy-add-a-new brand.png)

Select a brand > [Add a new brand]

Sendy - New brand.png

New brand

Brand name

From name

From email

Reply to email

(fill the form with the list name and your company’s data)

Sendy - SMTP settings

SMTP settings

Host: rsxxx.realsender.com

Port: 587

SSL / TLS: TLS

Username: (the one we sent you)

Password: (the one we sent you)

[Save]

WordPress MailPoet 3

MailPoet

WordPress

MailPoet > Settings

mailpoet - settings - basics

Basics > Default sender
(fill the form with your company’s data)

From:
Company Name - newsletter (description)
newsletter@company-name.org (email address)

Reply-to
Company Name - marketing (description)
marketing@company-name.org (email address)

[Save settings]

mailpoet - settings - send with

Send With…

[x]  Other

Send emails via your host (not recommended!)
or via a third-party sender.

[Configure]

mailpoet - settings - send with - smtp

Send With…

Method: SMTP

Sending frequency: Recommended
(100 emails every 5 minutes. That’s 28.800 emails per day)

SMTP Hostname: rsxxx.realsender.com

SMTP Port: 587

Login: (the one we sent you)

Password: (the one we sent you)

Secure connection: TLS

Authentication: [x] Yes

[Save settings]


For Premium features and support, on the Mailpoet pricing page
choose the “I just want the Premium with no sending” option.

In this way you can continue to use RealSender,
combining it with a dedicated email address to receive the bounces.


The “Bounce Handler Mailpoet” plugin will also have to be installed.

mailpoet - bounce handling

Bounce Handling

Bounce Email:
Please set a single dedicated bounce address for bounce email


please contact our support team to [get the mailbox to receive the bounced messages](../../bouncehandler-app/newsletter-mailboxes)

WordPress MailPoet 2

MailPoet

WordPress

MailPoet > Settings

mailpoet - settings - basics

Basics

Email notifications:
fill with the proper email address

Sender of notifications:
fill with the newsletter’s
FROM name and email address

[Save settings]

mailpoet - settings - send with

Send With…

[x] Third party

SMTP Hostname: rsxxx.realsender.com

Login: (the one we sent you)

Password: (the one we sent you)

SMTP Port: 587

Secure connection: TLS

Authentication: [x] Yes

Send… 60 emails every minute

[Save settings]

WordPress MailPress

MailPress

WordPress > Plugins

MailPress > Settings

MailPress - settings - general

General

From - All Mails sent from:
fill in the form with the sender’s email address and name

if it’s your first MailPress setup
you must press [Save Changes]
to see the additional settings options (SMTP, Test, Logs)

MailPress - settings - smtp

SMTP

SMTP Server: rsxxx.realsender.com
Username: (the one we sent you)
Password: (the one we sent you)

Use SSL or TLS ? TLS

Port: Use for SSL/TLS/GMAIL

WordPress Mailster

Mailster

WordPress

Settings > Newsletter

Mailster - general

General

From Name:

From Email:

Reply-to Email:

(fill the form with your company’s data)

[Save Changes]

Mailster - delivery method

Delivery Method

[SMTP]

SMTP Host : Port rsxxx.realsender.com : 587

Timeout: 10 seconds

Secure connection: [x] TLS

SMTPAuth: Plain

Username: (the one we sent you)

Password: (the one we sent you)

[Save Changes]

Mailster - bouncing

Bounces

Bounce Address:
Undeliverable emails will return to this address


please contact our support team to [get the mailbox to receive the bounced messages](../../newsletter-mailboxes)

make it easy to unsubscribe

Always give recipients an easy way to unsubscribe from your messages. 
Letting people opt out of your messages can improve open rates, 
click-through rates, and sending efficiency. 

Important: If you send more than 5,000 messages per day, 
your marketing and subscribed messages must support one-click unsubscribe.

-- Gmail, Email sender guidelines, 2024

Learn more about List-Unsubscribe: headers in RFC 2369 and RFC 8058.

After considering that most of our customers were NOT using List-Unsubscribe: headers in their sent messages,
we decided to add them automatically to each message, only if those headers are not already present.


Here is the result on Gmail webpage after clicking the "List-Unsubscribe" link:

gmail unsubscribe

Similar instructions will appear on other webmail clients and email apps.

Cancellation requests MUST BE HANDLED within two days.
You must NOT respond with a request to unsubscribe in any other way.

An email message will be automatically generated by Gmail and other providers.
It will be delivered to the email address you communicate to us (even more than one).

Alternatively, at the web address: rsXXX-realsender.com/unsubs
you can access all list-unsubscribe requests received in the last seven days,
in JSON format, as per the example below:

  {
    "mailbox": "rsXXX",
    "id": "20241107T001800-0000",
    "from": "<john.doe@gmail.com>",
    "to": [
      "<abuse@rsXXX-realsender.com>"
    ],
    "subject": "RealSender :: rsXXX Nov-7 4A6NDqsl008203 :: please UNSUBSCRIBE me ::",
    "date": "2024-11-07T00:18:00.938050657+01:00",
    "posix-millis": 1730935080938,
    "size": 4350,
    "seen": false
  },

bouncehandler app

bouncehandler

Repeated sending to wrong / inactive recipients is considered “spammer behavior”.
In recent years, more and more smtp servers have been blacklisted for this reason.


The most noticeable error occurs when the Mail-From/Return-Path address mailbox,
the one receiving the bounced messages, is full or non-existent.
By sending thousands of messages, if 20% come back, it’s easy to fill even a large inbox in minutes.

Receiving all bounced messages without reading them could be considered a minor flaw.
You keep sending emails to addresses that bounce back, with error details that no one cares about.

In both cases, the result is that the smtp server is blacklisted. In this way,
not only will messages not be delivered to invalid recipients, but valid recipients will also receive them as SPAM.


To solve the first problem, we have been offering “newsletter mailboxes” for a long time.
Analyzing bounced messages is more difficult and requires a tool that works very well.

sisimai bounce handler overview

We chose “Sisimai: Mail Analyzing Interface”, formerly known as bounceHammer 4: an error mail analyzer.
An open source software, that parses RFC5322 bounce mails and generates structured data as JSON.

To get an idea of all the possible error codes that Sisimai parses, take a look at “The SMTP Field Manual”,
a collection of raw SMTP error code responses from major email service providers.


The automatic blocklist

Implementing the bounce handler within RealSender is simple.

  1. activate the “newsletter mailbox
  2. configure your sending application to use the new Return-Path address
  3. ask to verify the setup and activate the “bounce handler”

The “bouncehandler” app will start checking the bounced messages.
Two blocklists will be activated:

  1. the hard bounces blocklist
    contains all the email addresses that generated a permanent error,
    such as user unknown or host unreachable

    the weekly hard bounces log is available at the web address:
    https://…hardbounces.email.weekly

  2. the soft bounces blocklist
    contains all the email addresses that generated three or more transient errors,
    such as mailbox full, at least one week away from each other

    the weekly soft bounces log is available at the web address:
    https://…softbounces.email.weekly

Sending messages to a blocklisted recipient will generate an error like this:
Send message error


Manage your blocks independently

We provide you with the following files,
as web addresses, protected by password or IP address:

https://…bounces.json
the details of ALL bounces received in the last seven days, in JSON format, such as:

  {
    "feedbacktype": "",
    "addresser": "info@circuitocinemascuole.com",
    "diagnostictype": "SMTP",
    "timezoneoffset": "+0200",
    "lhost": "linp.arubabusiness.it",
    "destination": "gmail.com",
    "timestamp": 1635536166,
    "senderdomain": "circuitocinemascuole.com",
    "deliverystatus": "5.1.1",
    "token": "daad8f8fc89cef70e1406a9d2b38be6c35326e03",
    "recipient": "...@gmail.com",
    "subject": "Prenotazioni aperte_Giornata Internazionale dei Diritti dell'Infanzia e dell'Adolescenza_Film FIGLI DEL SOLE",
    "origin": "/home/rs109-bounce/Maildir/new/1635528969.21113_0.rsbox.realsender.com",
    "rhost": "gmail-smtp-in.l.google.com",
    "reason": "userunknown",
    "diagnosticcode": "550-5.1.1 The email account that you tried to reach does not exist. Please try double-checking the recipient's email address for typos or unnecessary spaces. Learn more at https://support.google.com/mail/?p=NoSuchUser z3si7494964ybg.507 - gsmtp 503 5.5.1 RCPT first. z3si7494964ybg.507 - gsmtp",
    "messageid": "McuPi4DjtlyhvlSMVNB4wTXsUKQeIy6XwlKoAZuJ4@www.circuitocinemascuole.com",
    "listid": "",
    "action": "failed",
    "softbounce": 0,
    "replycode": "550",
    "catch": null,
    "alias": "",
    "smtpagent": "Sendmail",
    "smtpcommand": "DATA"
  },

https://…hardbounces.json
the details of all hard bounces 1 received in the last seven days, in JSON format

https://…hardbounces.email
the list of email addresses that generated a hard bounce 1 in the last seven days

1 = selection criteria: softbounce == 0

https://…softbounces.json
the details of all soft bounces 2 received in the last seven days, in JSON format

https://…softbounces.email
the list of email addresses that generated a soft bounce 2 in the last seven days

2 = selection criteria: softbounce == 1

These are the same files used by the automatic blocklist:

https://…hardbouncesfull.email
the list of email addresses that ever generated a hard bounce

https://…softbouncesfull.email
the list of email addresses that generated three or more soft bounces
at least one week away from each other


Request a free trial

Subsections of bouncehandler app

newsletter mailboxes

To receive the bounced messages generated by sending newsletters and mass mailings,
you need to setup additional mailboxes (e.g. bounce@…)

and optionally one mailbox for receiving reply emails (e.g. news@…)
if you want to filter them and send automatic replies to the most common requests.

For this reason we introduced two mailboxes matched to your RealSender account:
bounce@email.youremaildomain.com -> bounce@rsXXX-realsender.com
news@email.youremaildomain.com -> news@rsXXX-realsender.com

Explanation:

Using a Mail-From address (also known as bounce/return-path/envelope address)  
with a domain other than the From address
would break the DMARC authentication

To use the "newsletter mailboxes" 
you need to set up a sub-domain of the From address

e.g.  the From address is:           offers@youremaildomain.com
      the sub-domain could be:       email.youremaildomain.com   CNAME   rsXXX-realsender.com
      the Mail-From address becomes: bounce@email.youremaildomain.com

The suggested configuration follows the rules
to send DMARC compliant emails on behalf of customers.

DMARC allows you to send authenticated emails using a sub-domain (such as email.youremaildomain.com), and still be able to use the top-level domain in the From: header (e.g. From: offers@youremaildomain.com).

No additional settings are required in the DNS of your domain name.

As per RFC1912 section 2.4:
 A CNAME record is not allowed to coexist with any other data.  
 In other words, if email.youremaildomain.com is an alias for rsXXX-realsender.com, 
 you can't also have an MX record for email.youremaildomain.com, or an A record, 
 or even a TXT record 

The mailboxes have been configured so that they can receive
large amounts of emails in a short time, as in the case of bounces.
!!! Please note: email messages are automatically deleted after 7 days !!!

To download the emails, you should configure your email client,
or the application that analyzes the bounced messages,
with the following POP3 server address: pop.rsXXX-realsender.com.
Usernames and passwords are available through the website’s restricted area.

copymail app

copymail

RealSender “copymail” app lets you send mass mailings,
up to a few thousands of recipients, directly from your email client.

With three easy steps:

  1. upload your recipients’ list
  2. send the message you want to distribute to the “list-post” email address we will provide you
  3. approve the message to start the delivery

Each recipient will receive the message as if it were sent to himself only.

The list administrator will be notified by email
for every address that generates an “hard bounce”
(permanent failure, such as “user unknown”).

Essential features:

Membership Management

Membership list

back to top

Mass Subscriptions

Mass subscriptions

back to top

Pending Approvals

Held messages

back to top


Request a free trial