...

This plugin synchronizes contact and booking data between Guestline and Maileon. Only contacts, who didn’t explicitly object to 3rd party marketing mailing usage of their data will be considered for any synchronization. Optionally, unsubscriptions may be transfered back to Guestline, by which the afforementioned 3rd party marketing mailing usage will be declined. Booking data will be synchronized to Maileon by Transactions (contact events) and may be used for analyses or , to trigger Marketing Automations or to send Trigger Mailings.

Configuration

The plugin requires an activation by Maileon to be available in any Maileon accountand 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.

The follwing settings can be configured:

• Maileon API Key
  API key¹ 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
  Synchronize 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)

...

• 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 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 in at the hotel

The creator of the booking may also be referenced through the Maileon Maileon’s contact pool.
All contacts will have the following data available:

...

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:

Image Added

1. Browse to Settings → Contact Management → Unsubscriber Management in your Maileon account

2. Add External ID and last name to the list of fields, which will not be anonymized

3. Add Email address , External ID and last name to the list of fields, which will be transferred to the unsubscriber database

...