Apaleo

Short description

 

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

Installation

For now, until the app is approved, you can install it from this url:

https://apaleo-integrations.maileon.com/apaleo-maileon/install

The installation steps are as follows:

Authorize the App (this will only appear after the very first installation)
Register at the App

Settings

After installation you will be taken to the settings interface

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

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

DOI process

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.

Apaleo properties

Here are the properties that exist in Apaleo. You can select the properties for which you want the reservation data to be transferred to Maileon. (several can be selected at once)

Reservations send to Maileon

If this checkbox is ticked, the webhooks will be created for the above configured properties. The following webhooks are created:

  • reservation/created

  • reservation/amended

  • reservation/changed

  • reservation/canceled

  • reservation/checked-in

  • reservation/checked-out

Reservation contact events at Maileon

 

Webhook

Contact event

Webhook

Contact event

reservation/created

apaleo_reservation_created

reservation/amended

apaleo_reservation_amended

reservation/changed

apaleo_reservation_changed

reservation/canceled

apaleo_reservation_canceled

reservation/checked-in

apaleo_reservation_checked_in

reservation/checked-out

apaleo_reservation_checked_out

 

Contact events data fields:

Name

Type

Name

Type

reservation.id

string

reservation.bookingId

string

reservation.status

string

reservation.checkInTime

timestamp

reservation.checkOutTime

timestamp

reservation.cancellationTime

timestamp

reservation.noShowTime

timestamp

reservation.arrival

timestamp

reservation.departure

timestamp

reservation.created

timestamp

reservation.modified

timestamp

reservation.adults

integer

reservation.channelCode

string

reservation.promoCode

string

property.id

string

property.code

string

property.name

string

property.description

string

ratePlan.id

string

ratePlan.code

string

ratePlan.name

string

ratePlan.description

string

ratePlan.isSubjectToCityTax

boolean

unitGroup.id

string

unitGroup.code

string

unitGroup.name

string

unitGroup.description

string

unitGroup.type

string

totalGrossAmount.amount

float

totalGrossAmount.currency

string

primaryGuest.title

string

primaryGuest.firstName

string

primaryGuest.lastName

string

primaryGuest.email

string

primaryGuest.gender

string

primaryGuest.phone

string

primaryGuest.address.addressLine1

string

primaryGuest.address.addressLine2

string

primaryGuest.address.postalCode

string

primaryGuest.address.city

string

primaryGuest.address.regionCode

string

primaryGuest.address.countryCode

string

primaryGuest.preferredLanguage

string

primaryGuest.birthDate

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

cancellationFee.id

string

cancellationFee.code

string

cancellationFee.name

string

cancellationFee.description

string

cancellationFee.dueDateTime

timestamp

cancellationFee.fee.amount

float

cancellationFee.fee.currency

string

noShowFee.id

string

noShowFee.code

string

noShowFee.name

string

noShowFee.description

string

noShowFee.fee.amount

float

noShowFee.fee.currency

string

 

Additional guests data fields

Name

Type

Name

Type

title

string

firstName

string

lastName

string

email

string

gender

string

phone

string

address.addressLine1

string

address.addressLine2

string

address.postalCode

string

address.city

string

address.regionCode

string

address.countryCode

string

preferredLanguage

string

birthDate

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

region

standard

string

Apaleo_last_reserveration_date

custom

date

Apaleo_was_guest_hotel_<property_code>

custom

boolean

 

Â