Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Introduction

This plugin synchronizes contact and booking data between Guestline and Maileon. Only contacts, who didn’t explicitly object to 3rd party usage of their data will be considered for any synchronization. Optionally, unsubscriptions may be transfered back to Guestline, by which the afforementioned 3rd party 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 Trigger Mailings.

Configuration

The plugin requires an activation by Maileon to be available in any Maileon account. Afterwards you can find the configuration under Settings → Plugins → Guestline.

Plugin-Einstellungen

The follwing settings can be configured:

  • Maileon API Key
    API key1 to authenticate in Maileon's REST-API.

  • Guestline Site ID

  • Guestline Operator Code

  • Guestline API Password

  • Permission

  • Send Double OptIn Mailing

  • Activate single user tracking

  • Double OptIn Key

  • Synchronize contacts

  • Synchronize reservations

  • Synchronize cancellations

  • Synchronize check-ins

  • Synchronize check-outs

  • Synchronize check-outs

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.

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 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 the hotel

The creator of the booking may also be referenced through the Maileon 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 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

Changelog

1.0 - 21.02.2023

  • First release

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

  • No labels