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:
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 contact events at Maileon
Webhook | Contact event |
---|---|
|
|
|
|
|
|
|
|
Contact events data fields:
Name | Type |
---|---|
| string |
| string |
| string |
| timestamp |
| timestamp |
| timestamp |
| timestamp |
| timestamp |
| timestamp |
| timestamp |
| timestamp |
| integer |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| boolean |
| string |
| string |
| string |
| string |
| string |
| float |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| json |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| timestamp |
| float |
| string |
| string |
| string |
| string |
| string |
| float |
| string |
Additional guests data fields
Name | Type |
---|---|
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
| string |
Contact fields at Maileon
Name | Type | Datatype |
---|---|---|
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| standard | string |
| custom | date |
| custom | boolean |