Guestline Synchronize

Owned by Andreas Lange
Last updated: Mar 29, 2023
4 min read

Introduction

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.

Configuration

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.

 

Plugin-Einstellungen
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

Synchronize unsubscriptions

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:

 

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

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

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

 

 

 

 

 

 

 

Changelog

1.0 - 21.02.2023

  • First release

 

1 http://dev.maileon.com/api/rest-api-1-0/securitymechanism