MEWS

Short description

The plugin allows you to send reservations data in MEWS to Maileon. The reservation data is created as a contact event in Maileon, so you can set trigger letters for them.

Data synchronisation is not real-time, data is synchronised every 5 minutes.

The plugin can synchronize a MEWS property with a Maileon account. MEWS multi-properties (Portfolio Access Tokens) are currently not supported.

Installation

Login to your Maileon Account and go to Settings at the top right corner. There click to the Plugins menu item.

From the plugins, select the MEWS plugin and click on it. If you can't find the MEWS plugin in the plugins, please contact our support team to activate it for you.

After clicking, the plugin setup pop-up will appear.

MEWS Access Token

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. When you save your settings, the API key will be checked and if it is invalid an error message will be displayed. Common errors:

  • Validity period exceeded

  • Key was deactivated in Maileon

  • Characters were truncated at the beginning or end

Initial Permission

The Maileon permission to be used during the initial import. Initial import should use when you started to use the plugin, for import all exists contacts from MEWS.

  • None: No permission. The contact will not receive newsletters, only transaction emails (e.g. reservation confirmation mail).

  • 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.

Regular Permission

The Maileon permission to be used during the regular data synchronisation.

  • None: No permission. The contact will not receive newsletters, only transaction emails (e.g. reservation confirmation mail).

  • 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.

Enable DOI Mailing

If we enable the DOI process, then when the contact is created a confirmation email will be sent to the email address with a confirmation link, which if the contact clicks on will give them Double Opt-In Plus access to Maileon, regardless of what we have set in the above setting. If this option is not turned on, the contact will receive the permission set above instantly, without any confirmation.

DOI Key

Here you can enter a DOI mailing ID, which determines which DOI mailing should be triggered as soon as a contact subscribes to the newsletter. The identifier can be set in Maileon or retrieved from the corresponding DOI mailing in the default settings. If the Maileon account has a default DOI mailing set in the settings, this field does not need to be filled in. Common mistake:

  • The DOI process above will be enabled but the DOI key is not specified here and no default DOI mailing is set in the Maileon account.

Notification Email

Depending on the number of contacts, the initialising import can take several minutes. A notification will be sent to the email address provided here when the import is complete.

Enable Requested Reservations

If this checkbox is ticked, the requested reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Requested state - Confirmed by the customer but not by the enterprise (waitlist).

Maileon transaction: mews_reservation_requested

Enable Optional Reservation

If this checkbox is ticked, the optional reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Optional state - Confirmed by enterprise but not by the guest (the enterprise is holding resource for the guest).

Maileon transaction: mews_reservation_optional

Enable Confirmed Reservation

If this checkbox is ticked, the requested reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Confirmed state - Confirmed by both parties, before check-in.

Maileon transaction: mews_reservation_confirmed

Enable Check-In

If this checkbox is ticked, the requested reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Started state - Checked in.

Maileon transaction: mews_reservation_check_in

Enable Check-Out

If this checkbox is ticked, the requested reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Processed state - Checked out.

Maileon transaction: mews_reservation_check_out

Enable Canceled

If this checkbox is ticked, the requested reservations will be transferred to Maileon as transactions.

At MEWS this reservation has Canceled state - Canceled.

Maileon transaction: mews_reservation_canceled

Reservation contact events at Maileon

 

MEWS Reservation state

Contact event

MEWS Reservation state

Contact event

Requested

mews_reservation_requested

Optional

mews_reservation_optional

Confirmed

mews_reservation_confirmed

Started

mews_reservation_check_in

Processed

mews_reservation_check_out

Canceled

mews_reservation_canceled

 

Contact events data fields:

Name

Type

Name

Type

reservation.id

string

reservation.bookerId

string

reservation.state

string

reservation.origin

string

reservation.commanderOrigin

string

reservation.originDetails

string

reservation.purpose

string

reservation.options

string

reservation.scheduledStart

timestamp

reservation.checkInTime

timestamp

reservation.cancelled

timestamp

reservation.end

timestamp

reservation.created

timestamp

reservation.updated

timestamp

reservation.released

timestamp

resource.id

string

resource.name

string

resource.state

string

resource.discriminator

string

resource.floorNumber

string

resource.locationNotes

string

rate.name

string

rate.type

string

service.id

string

service.name

string

additionalGuests

json

booker.title

string

booker.firstName

string

booker.lastName

string

booker.email

string

booker.gender

string

booker.phone

string

booker.address.addressLine1

string

booker.address.addressLine2

string

booker.address.postalCode

string

booker.address.city

string

booker.address.regionCode

string

booker.address.countryCode

string

booker.preferredLanguage

string

booker.birthDate

string

cancellation.reason

string

Contact fields at Maileon

 

Name

Type

Datatype

Name

Type

Datatype

title

standard

string

firstname

standard

string

lastname

standard

string

fullname

standard

string

locale

standard

string

gender

standard

string

birthday

standard

string

address

standard

string

zip

standard

string

city

standard

string

country

standard

string

PhoneNumber

custom

string

CarRegistrationNumber

custom

string

LoyaltyCode

custom

string

TaxIdentificationNumber

custom

string

MewsLastReserverationDate

custom

date

MewsInitialImportCreated

custom

boolean