/
Apaleo

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