Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel3
include
outlinetrue
indent
stylenone
exclude
typelist
class
printabletrue

General

This extension is responsible for handling subscriber and order information between Maileon and the Unas Webshop engine (www.unas.hu)

This plugin requires Unas VIP or higher subscription as automated processes are necessary for the plugin functionality.

Installing

You can find this extension in Your Maileon account settings.

Screenshot 2024-07-16 at 10.19.51.pngImage Added

Screenshot 2024-07-16 at 10.12.00.pngImage Added

Screenshot 2024-07-16 at 10.12.33.pngImage Added

Configuration

The plugin setup process is handled in the Maileon account.

maileon-unas-integration-configuration-form.png

Authentication

UNAS API Key

The api key generated at Unas API Key configuration page

When creating Your api key make sure You add the following permissions:

  • getOrder

  • getProduct

  • getCustomer

  • getNewsletter

  • setNewsletter

  • getAutomatism

  • setAutomatism

UNAS Shop ID

Your Unas shop id. Usually it's the prefix of the orders (eg in case of 39689-100008, it’s 39689).

Maileon API Key

The API Key can be created and viewed in the Maileon account under "Settings" → "API Keys" and ensures the connection to the account. Make sure this API key is only used by this integration.

Initial sync settings

Initial sync permission

The permission new contacts receive when saved in Maileon.

If you want to send Double Optin emails to the contacts choose „no permission available“.

Initial DOI process

You can determine if the initial sync of contacts should also trigger the double opt-in process.

Initial sync DOI Key

Here you can define a DOI mailing key that determines which DOI mailing should be triggered for the imported contacts. The key can be configured or read out in Maileon for the corresponding DOI mailing in the basic settings.

Regular sync settings

Regular sync permission

The permission new contacts receive when saved in Maileon.

If you want to send Double Optin emails to the contacts choose „no permission available“.

Regular sync DOI process

Here you can specify whether the DOI mails are sent from Maileon or not. Recommended setting: yes.

IMPORTANT: This does NOT suppress the DOI mails from Unas, You need to disable it manually.

Regular sync DOI Key

If you have multiple Double Optin mailings in your account you can specifiy with this setting which shall be used. Leave empty for default DOI.

Notification email

This is the email address You’d like to receive notifications sent by the integration.

Webhooks

The creation and setup of Unas webhooks is fully handled by the integration. Do not change any settings of the respected webhooks in Unas, as it could lead to malfunctions. Use the options below to enable/disable webhooks.

Sync newsletter subscriptions

If this checkbox is ticked, a webhook will be created after saving which will send the newsletter subscribers and unsubscribers to Maileon in real time.

Sync checkouts

If this checkbox is ticked, a webhook will be created after saving which will send the order data to Maileon as a contact event in real time.

Transaction:
unas_orders_1.0

Sync abandoned carts

Transactions for shopping cart abandoners are sent to Maileon if this option is active. This does not prevent Unas from sending abandoned cart emails, You need to deactivate them manually.

Transaction:
unas_abandoned_carts_1.0

Abandoned cart intervall

You can determine the delay by hour for abandoned cart event trigger. By default it's 1 hour.

After installation

After You’ve successfully configured the plugin, You’ll the webhooks used by it in Unas. Do not change them directly, as it could effect the plugin functionality. To enable/disable specific webhooks, please use the Maileon plugin config form.

Transaction data

daddy bought a donkey

unas_orders_1.0

Field

Data type

order.id

string

order.date

unas_abandoned_carts_1.0

Custom fields

Field

Data type

Description

UnasShopId

string

The Id of the Unas webshop

UnasImports

boolean

A boolean value which shows if a contact was created during initial sync

UnasPoints

float

The available loyalty points of contact

phone

string

Telephone number of contact

mobile

string

Telephone number of contact

Available permissions

  • None: No permission. The contact will not receive newsletters.

  • Single Opt-in: Permission was simply granted, e.g. by entering an email address in a form. This method technically allows the contact to receive newsletters, but does not ensure that the email address belongs to the person who entered it.

  • Double Opt-in: With this permission, a confirmation email with a confirmation link is sent to the email address. Only when the link in the mail has been clicked and thus the interest in the entry has been confirmed, the contact can be sent.

  • Double Opt-in Plus: Double opt-in including consent for single user tracking. Please note: Without individual user tracking, no openings, clicks, etc. may be traced back to individual users and significant data for evaluating newsletter performance is missing. newsletter performance is missing.

Syncing all existing subscriber from Unas to Maileon

All subscribers can be transferred to Maileon. This is done in a background process. You will need to provide an email address to which a notification will be sent at the end of the import. The contacts will be created in Maileon with the permission selected in the Initial sync permission field. DOI process is handled based on Initial DOI process field. Enabling it is not recommended for bulk imports. Once the import is complete, an email notification will be sent.