TTLock

From Beds24 Wiki
Jump to navigation Jump to search
TTLock
 This page is about the menu  (SETTINGS) APPS & INTEGRATIONS > TTLOCK Contact us if you want to use this integration.

For Beds24 the normal channel manger fees apply.

Contents

1 Capabilities

  • Beds24 can send booking data to TTLock locks.
  • Auto-Check-in: when a lock is first opened by the guest the info code "CHECKIN" will be added to the booking.

2 Limitations

  • The lock does not have to be connected to the internet to receive bookings, however it must be connected to the internet to delete or receive updates for bookings.
  • The start and end times of passcodes must be on the hour, for example a start time of 9:20 will actually start at 9:00.
  • Passcodes must be used at least once within 24 hours of their start times, otherwise they will become invalid.
  • Passcodes cannot be updated or deleted if they have not been used.
  • Multiple passcodes in the same lock cannot share the same start and end time, this includes deleted passcodes.
  • A deleted passcode cannot be created again with the same start and end time.

3 What you need

To use this service you will need:

  • A TTLock lock
  • A TTLock account

4 Set Up

Step 1: Connect your TTLock Account

  • On the setup page enter your TTLock username (usually a phone number or email address) and password

500px view large

Step 2: Set when bookings should send to locks

  • The "Start Time" and "End Time" define the earliest Check-in time and latest Check-out time.
  • The "Days in Advance" sets the days before check-in that the booking is sent to the lock.

Step 3: Map your locks to your rooms

Bookings will be sent to the lock mapped to the room assigned to the booking.

  • Click on "Get Codes"

You will see one identifier and name for each lock. Select the correct lock and save.


500px view large


For each room/unit click on the name of the lock that is associated with the room.

500px view large

Step 4: Set up an Auto Action Email to send the PIN to guests

  • Go to (SETTINGS) GUEST MANAGEMENT > AUTO ACTIONS.
  • Create an Auto Action Email which includes the template variable for the pin which is [BOOKINGINFOCODETEXT:LOCK_PIN].

Step 5: Activation

5 How it works

5.1 Syncing

Bookings are automatically sent to locks the number of "Days in Advance" prior to check-in which you have selected.

Entry codes can only be used during the booking period, they will not provide access before or after.

  • Updates to locks are sent periodically. To instantly send updates, click "Send Bookings to Locks". Updates cannot be sent to locks that are not connected to the internet.
  • An entry code named Booking {room id}/{booking id} - {guest name} is added to the lock. Click on the "Lock Data" button to check which bookings have already been sent.
  • A booking info code named LOCK_PIN is created on the "Info" tab of the booking, this will show the access code for the booking.
  • If a booking date or room changes, those details will update in online locks.
  • If a booking is cancelled, the associated entry code will be deleted from online locks.
  • The associated entry code of a booking sent from Beds24 will be removed one day after check-out.

If a TTLock lock is offline codes can be added but not updated or deleted.


5.1.1 Manually changing codes

  1. Navigate to (SETTINGS) ACCOUNT > PREFERENCES "Bookings" and add "LOCK_PIN" to your Booking Info Code Values.
  2. You can now manually add a LOCK_PIN info code to your bookings.

If you manually set an invalid LOCK_PIN, it will be overwritten with a randomly generated pin the next time bookings are sent to locks. Each code can only be used once per lock. Before you can reuse a code it has to be removed from the lock.

5.2 Custom Start and End access times

The access start and end times can be customized per booking using booking info codes.

A booking info code ACCESS_STARTTIME with a time of day (23:00 format) as the text will override the default start time.

A booking info code ACCESS_ENDTIME with a time of day (23:00 format) as the text will override the default end time.

Start and end dates can be set relative to the check in and check out date by defining times greater than 24 or negative.


For example :- ACCESS_STARTTIME = -10:00 will create a start time 10 hours before midnight of the check in day, i.e. 14:00 on the day before check in.

  • Booking Info code = ACCESS_STARTTIME
  • Booking Info Text = -10:00

For example :- ACCESS_ENDTIME = 34:00 will create an end time of 10:00 one day after checkout (34 = 24 + 10 hours)

  • Booking Info code = ACCESS_STARTTIME
  • Booking Info Text = 34:00


6 Troubleshooting

7 Disconnect

Delete your username and password and set Synchronize to "disabled" to disconnect.