UNAS Integration
- Zsolt Mannheim
- Lukas Sadurski
- Robert K. Toth
- 1 General
- 2 Installing
- 3 Configuration
- 3.1 Authentication
- 3.1.1 UNAS API Key
- 3.1.2 UNAS Shop ID
- 3.1.3 Maileon API Key
- 3.2 Initial sync settings
- 3.2.1 Initial sync permission
- 3.2.2 Initial DOI process
- 3.2.3 Initial sync DOI Key
- 3.3 Regular sync settings
- 3.3.1 Regular sync permission
- 3.3.2 Regular sync DOI process
- 3.3.3 Regular sync DOI Key
- 3.4 Notification email
- 3.5 Webhooks
- 3.5.1 Sync newsletter subscriptions
- 3.5.2 Sync checkouts
- 3.5.3 Sync abandoned carts
- 3.5.4 Abandoned cart intervall
- 3.6 Transaction data
- 3.6.1 unas_orders_1.0
- 3.6.2 unas_ordered_products_1.0
- 3.6.3 unas_abandoned_carts_1.0
- 3.1 Authentication
- 4 Custom fields
- 5 Available permissions
- 6 Syncing all existing subscriber from Unas to Maileon
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.
When syncing orders, we also sync the available loyalty points of the customer. Note: The value of that field is only updated when a new order is placed.
Installing
You can find this extension in Your Maileon account settings once enabled by the Maileon service team.
Configuration
The plugin setup process is handled in your Maileon account.
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 your 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.
Double opt-in process can only be enable with permission setting “no permission”.
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.
You can leave this field empty - in that case the default DOI mailing will be used.
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 would 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.
Transaction data
Keys and data types of transaction object
unas_orders_1.0
unas_ordered_products_1.0
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 | Mobile phone 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.