This plugin synchronizes contact and booking data between Guestline and Maileon. Only contacts, who didn’t explicitly object to marketing mailing usage of their data will be considered for any synchronization. Optionally, unsubscriptions may be transfered back to Guestline, by which the afforementioned marketing mailing usage will be declined. Booking data will be synchronized to Maileon by Transactions (contact events) and may be used for analyses, to trigger Marketing Automations or to send Trigger Mailings.
The plugin requires an activation by Maileon and Guestline. Afterwards you can find the configuration in your Maileon account under Settings → Plugins → Guestline.
In order to synchronize data between Guestline and Maileon, the plugin requires authentication data for each system.
Maileon You can create a new Maileon API key in your Maileon account under Settings → API Keys. This plugin requires a key with rights to Read, Create and Update data.
Guestline Obtain your Guestline credentials by contacting your Guestline sales representative. Please do not use the guestline support portal for this. Your Guestline sales representative will prepare a contract for the interface and initiate the API account creation through the Guestline technical team.
Figure 1: Plugin settings
The follwing settings can be configured:
Maileon API Key API key1 to authenticate in Maileon's REST-API.
Guestline Site ID Part of your Guestline credentials
Guestline Operator Code Part of your Guestline credentials
Guestline API Password Part of your Guestline credentials
Permission The initial permission for new contacts if no Double OptIn process should be started.
Send Double OptIn Mailing Activates Maileon’s Double OptIn process for each new contact.
Activate single user tracking Sets the permission to include single user tracking (DOI Plus) for each new contact. Only available if a Double OptIn process should be started.
Double OptIn Key An alphanumeric key to identify the DOI Mailing to be send. Only available if a Double OptIn process should be started.
Synchronize contacts Activates contact synchronizations from Guestline to Maileon. Only contacts, who didn’t object to marketing mailing usage and with an email address will be transferred.
Synchronize reservations Activates synchronization of booking reservations (see below for more information about contact events)
Synchronize cancellations Activates synchronization of booking cancellations (see below for more information about contact events)
Synchronize check-ins Activates synchronization of check-ins (see below for more information about contact events)
Synchronize check-outs Activates synchronization of check-outs (see below for more information about contact events)
Synchronize unsubscriptions Synchronizes unsubscriptions back to Guestline, by objecting to the usage of marketing mailings. Be aware: this may interfere with other integrations in your Guestline account.
Booking data (contact events)
The plugin allows to activate the synchronization of booking data for each type of booking in Guestline (Reservation, Cancellation, Check-In or Check-Out).
Each synchronization type will use a different contact event in order to be able to react to each booking event as needed. However, for easier use, all events will contain the same data structure.
Figure 2: Contact event structure
The following items are available with every booking event:
booking_id The main reference to the booking in Guestline
status The booking status (PreArrival, Cancelled, Resident or CheckedOut)
type The booking or reservation type (Bedroom, Function, Nra or Master)
room_id Room number or name
room_type_code The code of the room type (COTTAGE_1, COTTAGE_2, COTTAGE_3, DBL_STANDARD, DBL_SUPERIOR, FAMILY, FUNCTION, MEETING_ROOM, PENTHOUSE, PUBLIC, SUITE or TREATMENT)
arrival_at The arrival date
departure_at The departure date
created_at Date of the booking’s creation
updated_at Date of the last update
creator The contact, who created the booking
guests A list of all guests arriving at the hotel
The creator of the booking may also be referenced through Maileon’s contact pool. All contacts will have the following data available:
ext_id The reference code to the contact in Guestline
firstname The contact's first name
lastname The contact’s last name
The plugin will create the Webhook to send contact information back to Guestline automatically, once you’ve activated the setting in the configuration panel (see above). However, in order to synchronize unsubscriptions back to Guestline, the unsubscription settings in the Maileon account need to be adjusted:
Figure 3: Maileon’s Unsubscriber Management
Browse to Settings → Contact Management → Unsubscriber Management in your Maileon account
Add last name to the list of fields, which will not be anonymized
Add Email address and last name to the list of fields, which will be transferred to the unsubscriber database