Getting started

What’s New

Roadmap

Octeth Training Program

Installation & Setup

Requirements

Architecture

Server Setup

Oempro Installation

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Video Tutorials

Administration

Quick Walkthrough

Security

Sub Admin Accounts

Settings

Delivery Servers

Global Segments

Global Custom Fields

Bounce Processing

Spam Complaints

Suppression List

Plug-Ins

Delivery Report

User Management

Maintenance

Audience Management

Introduction

Subscriber Lists

Custom Fields

Segments

Subscribers

Webhooks

Website Event Tracking

Email Marketing

Introduction

Auto Responders

Email Campaigns

Sender Domain Man.

Journeys (Automation)

Bounce Processing

Email Personalization

FBL Processing

Email Builder Integrations

Email Deliverability

Sender Domain Management

Plug-Ins & Add-Ons

AI Plug-In

RSS Plug-In

Bounce Catcher Add-On

Link Proxy Add-On

Developers

Introduction

Single Sign On

API

Plug-In Development

Database

Advanced

Reverse Proxy

Cookbook

Help

Troubleshooting

Contact Us

Settings

This section is the center for setting up all features and parameters of your email marketing system.

On the left side, you can access to all settings sections, categorized based on their topics.

Admin Account

Account Information

Under [Admin Area → Settings → Admin Account] section, you can update the personal information of the administrator, such as name, and email address.

Email Addresses

Under “Email Addresses” tab, you can set the default sender name and send email address for system notification emails. This information will be used when sending system notification emails to the administrator as well as users. Therefore, you may consider setting a corporate name and email address instead of your own personal info.

API

This section will display your “Administrator API Key”. Using this API key you can access to all system components and functions via API.

If you need to change the administrator API key, edit /opt/oempro/data/config.inc.php file and change the value of ADMIN_API_KEY.

Security

For security instructions, please refer to “Security” section by clicking here.

Default Opt-In Settings

This is the default opt-in confirmation message which will be set for any subscriber lists created with “Double Opt-In Confirmation” setting.

The email subject and plain email content set here will be applied to user subscriber lists. Please note that, changes applied here affects only new subscriber lists created afterwards.

Delivery Servers

Oempro sends email campaigns, autoresponders and transactional emails via SMTP servers. These SMTP servers are set under [Admin Area → Settings → Delivery Servers] section. You can create multiple delivery servers for the same or different SMTP servers.

Each delivery server has its own SMTP credentials, link and open tracking domains, MFROM domain and other deliver settings.

Creating a Delivery Server

In order to create a new Delivery Server, click “Create Delivery Server” link as shown below.

Oempro will ask you to enter the new Delivery Server parameters, including Name, Host, and SMTP credentials.

Once you are done with the “Email Delivery” tab, click “Domains” tab and set other Delivery Server parameters as explained below.

In addition to these settings, if you want to use the “Sender Email Address” of the subscriber list as the MFROM email address, please check this checkbox:

If you want to set the “Sender Email Address” of the subscriber list as the “FROM” email header, please check this checkbox:

Once you are done with the settings of your new Delivery Server, click the “Create Delivery Server” button. You will be redirected to the Delivery Server list.

Setting Up SSL Certificates For Tracking Domains

Setting up an SSL certificate for your tracking domains is optional but highly recommended for both security and better email deliverability.

In order to initiate SSL certificate for your tracking domains, please refer to SSL Certificates section for initiating SSL certificates and activating them in your Oempro.

Setting Up a Test Delivery Server

Oempro includes a “Mailhog” Docker container. Mailhog is a SMTP and Mailbox simulator which means, you can send your emails to this test mailbox and check them if your emails are properly structured and sent.

Mailhog can be accessed via http://your-oempro-domain:8025 on your web browser. In order to access this URL end-point, you need to set your static IP address in /opt/oempro/_dockerfiles/haproxy.cfg and apply the change.

Once you edit this file, find frontend frontend_mailhog_admin directive. Inside this directive, you will see acl network_allowed src 192.168.99.0/24 parameter. Simply add your email address to the end of this parameter. Here’s an example:

frontend frontend_mailhog_admin
    bind *:8025
    mode http

    acl network_allowed src 192.168.99.0/24 xxx.xxx.xxx.xxx
    http-request deny if !network_allowed

    use_backend backend_mailhog_admin

xxx.xxx.xxx.xxx represents your IP address in the above example.

Once this file save, run the following command sequence on your Oempro server:

cd /opt/oempro/
docker-compose build haproxy
docker-compose kill haproxy && docker-compose up -d haproxy

Now you can access your Mailhob dashboard on your web browser.

In order to create a Test Delivery Server, simply follow the steps explained above but this time, set the following parameters:

Click the “Create Delivery Server” button to create your test delivery server. You will be redirected to the Delivery Server list. Click on your new delivery server and go to “DNS Test” tab.

Click “Test Delivery Server” button. In a few seconds, you should see “Email Delivery ⇒ PASSED”:

Once you open your Mailhog dashboard on your web browser, you will see the test email on your mailbox.

Email Deliverability

Setting up your delivery servers, tracking and MFROM/FROM domains are very important for the highest delivery success rate.

You must make sure that your outgoing emails comply with SPF, DKIM, DMARC and domain-alignment policies.

You may use third party email validation and delivery test tools to make sure you are in good standing.

Some third party email validation and delivery test tools are;

• Mail-tester.com
• GlockApps.com

Email Delivery

Email delivery settings will help you to define critical parameters and functionalities of your email delivery activities.

Under this section, you can configure;

• X-Mailer header
• Seed email addresses for monitoring
• Alias email addresses for reply management
• Relaying domains for bounce/reply handling
• Pre-header text template
• The default email delivery SMTP settings
• Email delivery load balancer
• Bounce handling parameters
• SPAM complaint handling parameters
• Custom email headers

Email Delivery Settings

You can configure email delivery parameters and related components under this section. Let’s go through each one of these parameters:

Load Balancing

This feature helps you to balance the number of outgoing emails from Oempro delivery servers to your mail server. If you are running low on system resources for your mail server or if you want to throttle outgoing email volume from your Oempro server, you can enable this feature and define the number of emails to send on each interval.

For example;

This setup will force Oempro to send only 100 emails and wait 10 seconds before sending another 100 emails.

Bounces

Oempro has inbound SMTP server for processing incoming emails, including delivery status notification (DSN) emails. In order to activate bounce handling, make sure you have set your relay domains under [Admin Area → Settings → Email Delivery] section.

For more information about different bounce handling techniques and setup, please refer to the Bounce Processing section.

SPAM Complaint

In this section, you can define email addresses and other settings related to the Spam Complaint and FBL processing.

Headers

You can add custom email headers to outgoing emails. This can be done on this section:

As you can see above, we have set two custom email headers which affects all outgoing emails through the system. The value of these email headers contain merge tags which will be replaced by the sender user ID and the campaign ID.

When creating a custom email header, you can restrict the implementation to “All Emails”, “Email Campaigns”, “Autoresponder Emails” or “Transaction Emails”.

Also, you can restrict the scope to system wide (all delivery servers) or to a specific delivery server.

The custom email header value can also be customized by;

Depending on the email type (campaign, autoresponder, transactional, etc.), some of these listed merge tags may not be available for that specific email type or recipient.

Email Requests

Email Requests has been implemented into Oempro back in early 2000’s... Since then the demand on this feature has declined and the effectiveness of this feature in the email marketing space has lost. Therefore, we have decided to deprecate this feature in one of the future versions.

S2S Postback

Server-to-Server (S2S) postback integration is a complicated, but better way of tracking information about the user and what conversion is made.

This method generates a click ID value via an HTTP request that is used for tracking. Once a conversion happens, the affiliate network sends the value and info to Oempro, and gives you detailed information about everything.

It is a very accurate tracking method and you get a lot more information about the recipient’s actions. It is also extremely secure and reliable (Pixels can sometimes misfire or can be blocked).

Under [Admin Area → Settings → S2S Postback] section, you can setup your S2S postback parameters:

Once you set your S2S Postback settings and save it, the S2S Postback feature will be enabled on the system. When creating your next email campaign, you an check the “S2S Postback” integration option:

Once “Enable S2S Postback” checkbox is checked, Oempro will show you the current S2S Postback setup. Simply create and run your email campaign. For each conversion, Oempro will receive an S2S Postback data from the tracking system such as Binom or Voluum and these metrics will be displayed under “Conversions” section of your email campaign report page.

SMS Settings

This section contains settings related to the SMS feature of Oempro.

Under “Frequency Checker” tab, you can set the frequency of SMS delivery to each recipient. This feature will allow you to have full control over how many SMS messages to send to the same recipient over a specific period of time.

You can set a frequency limit for SMS delivery based on daily, weekly, monthly and yearly time intervals.

Under “Forbidden Words” tab, you can set words which will be rejected in SMS campaigns. If an SMS campaign is scheduled with any of these words, the system will alert and reject the delivery.

Under “Other” tab, you can set all other features such as “Frequency Whitelisted” mobile numbers.

Email Templates

ESP Settings

If you are going to use Oempro to power-up your email marketing service and let your customers to login and manage their email marketing campaigns, this section is for you.

The first thing you need to decide is to let your website visitors sign-up to the platform or not. If you want to accept new users via sign-up form, choose “Allow visitors to sign-up to the system as user” option. This will enable additional options to you:

When sign-up system is enabled, your website visitors can use Oempro’s built-in sign-up form to sign-up as an user on the platform.

A user can be “Trusted” or “Un-trusted”. When a user is set as “Trusted”, campaigns scheduled under this user account will be delivered on time without any manual approval process. When a user is set as “Un-trusted”, campaigns of the user will be put on-hold until the administrator manually verifies the approval pending campaign and approves the user account.

Next two settings are sign-up fields and default user interface language. You can show/hide specific fields on the user sign-up form.

When a user signs up, the user will be added to the “Target User Group”. We strongly recommend you to setup a limited user group for new users. Power features and high limits will cause your email marketing system to become vulnerable to spamming.

Under “Currency & Tax” tab, you can set the currency and Tax/Vat (%) rates. These settings will be applied to system usage pricing and billing features.

Under “Notification Emails” section, you can customize the system email which will be delivered at the end of each payment period.

Under “Payment Gateway” section, you can enable Paypal Express Checkout or Third Party Payment Gateway option and start accepting payments online on your email marketing platform.

If you choose “Third Party Payment Gateway” option, you will be asked to enter the payment gateway redirection URL. You can customize this URL with specific information such as;

• User ID → _User:UserID_
• User’s First Name → _User:FirstName_
• User’s Last Name → _User:LastName_
• User’s Email Address → _User:EmailAddress_
• Number of credits to be purchased → _Credits_
• Total amount to be paid → _TotalAmount_
• Purchase ID → _PurchaseLogID_

Single Sign On (SSO)

Oempro includes multi-SSO infrastructure. Single Sign On feature allows you to integrate your email marketing platform to your other systems in a few minutes. In this way, your users (or customers) can access to their accounts on Oempro with a single click. SSO avoids the need of entering username/password when accessing user accounts on Oempro.

For each system, you can setup a different SSO source. Each SSO source has its own security keys which helps you to keep your systems isolated if needed.

To create a new SSO source, click “Create SSO Source” link:

You will be asked to enter your SSO source parameters:

Once you create your SSO source, Oempro will show you two secret keys. These secret keys are required to generate the SSO URL properly. You will also find a PHP example under secret keys which can be used to perform the SSO integration quickly.

Preferences

You can customize system preferences under this section.

Rebranding

Customize the look-n-feel of the user interface by changing the product name displayed on the top left of the user interface and setting customized headers and footers for specific sections.

Upload Settings

When creating an email campaign, auto responder or system email, you may attach files to your emails, or upload images to your media gallery and insert into your email content. These uploaded files and images can be stored on the application server, on the MySQL database, or they can be uploaded to an Amazon S3 bucket.

If you choose “Upload to the server” option, uploaded images and files will be stored inside /opt/oempro/data/ directory.

If you choose “Upload to Amazon S3” and enter your S3 credentials, uploaded images and files will be stored on your Amazon S3 bucket.

Integrations

Under this section, you can setup preferences of third party integrations such as Stripo.email, Unlayer.com, Cleanify.io, IPMonitor.app and others.

Google Analytics

Source and Medium keywords set here will be appended to email campaign links if the user enables Google Analytics option when creating the email campaign. These parameters will be appended to links with utm_source and utm_medium URL parameters.

Stripo.email

In order to activate the Stripo.email integration, first you need to sign-up for a free Stripo account on their website https://stripo.email.

Once you are logged in, click on your account photo and then click “Plug-Ins”:

Click “Create Application” button and give a name to your application (ex: Oempro) and enter the Oempro url.

Once your new application is created, you will see “Plug-In ID” and “Secret Key” parameters:

Copy these two parameters and paste them to your Oempro Stripo settings. If you want to activate power features such as Stripo Template Gallery support inside Oempro, set Stripo API keys for each user ID. Here’s an example:

{
    "2": "<stripo-api-key-1>",
		"3": "<stripo-api-key-2>",
}

In the example above, “2” and “3” represents Oempro user ID’s. Stripo API keys can be found under each project settings page:

Unlayer.com

In order to use Unlayer drag-n-drop email builder inside Oempro, you need to copy&paste Unlayer project ID and API key under “Unlayer.com” tab. Once these settings are entered, the Unlayer.com integration will be activated.

Users will be able to choose Unlayer Drag-n-drop email builder option when creating an email campaign or auto responder.

Cleanify.io

Cleanify is one of the high accurate and reliable email list verification and list hygiene service. Oempro has a full-featured integration with Cleanify.io.

Once Cleanify.io integration is enabled, Oempro will start verifying new subscribers and reject email addresses which are invalid, hard bounces, possible spam trap, role based or catch-all email addresses. With the help of Cleanify.io integration, you will be able to protect your email delivery reputation a lot easier.

To activate Cleanify.io integration, first visit https://cleanify.io website and sign-up for a free account. Inside your Cleanify.io account, “My Profile” link on the top right corder:

On your account profile page, you will see your API key. Copy this API key and paste it under “Cleanify.io” section in Oempro:

Once the API key is entered and settings are saved, Oempro will establish the integration with Cleanify.io.

Here’s how it looks like once the integration is enabled:

You can set the maximum number of list verification tests your users can run on daily and monthly basis.

You can also set what kind of email addresses to be accepted to lists:

• Deliverable → These are 100% valid and working email addresses
• Risky → These are catch-all, role-based or corporate email addresses (ex: sales@test.com)
• Unknown → These are email addresses which couldn’t be identified as deliverable nor risky
• Undeliverable → These are hard bounced / invalid email addresses

Once Cleanify.io integration is enabled, users will also see “Email Verification” link inside their lists and they can run bulk email verifications to get rid of risky and invalid email addresses.

IPMonitor.app

IPMonitor.app is an advanced sender IP address and domain reputation monitoring service. The integration between Oempro and IPMonitor.app can be enabled by entering the IPMonitor API key which can be gathered from the https://ipmonitor.app dashboard.

Plug-Ins

Oempro is a powerful and extendable email marketing software. You can customize and extend the features of Oempro by adding (or developing) plug-ins. When a plug-in is added to Oempro, it will be available under [Admin Area → Settings → Plug-Ins] section:

Once a plug-in is added to Oempro, it must be enabled here. Unless a plug-in is enabled, it will not become active in the system.

Initialization

On this page

• Settings
• Admin Account
• Account Information
• Email Addresses
• API
• Security
• Default Opt-In Settings
• Delivery Servers
• Creating a Delivery Server
• Setting Up SSL Certificates For Tracking Domains
• Setting Up a Test Delivery Server
• Email Deliverability
• Email Delivery
• Email Delivery Settings
• Load Balancing
• Bounces
• SPAM Complaint
• Headers
• Email Requests
• S2S Postback
• SMS Settings
• Email Templates
• ESP Settings
• Single Sign On (SSO)
• Preferences
• Rebranding
• Upload Settings
• Integrations
• Google Analytics
• Stripo.email
• Unlayer.com
• Cleanify.io
• IPMonitor.app
• Plug-Ins
• Initialization