Difference between revisions of "TTLock"
Line 88: | Line 88: | ||
<span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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. | <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span> 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. | ||
+ | |||
+ | ==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''' | ||
+ | |||
= Troubleshooting = | = Troubleshooting = |
Revision as of 10:04, 3 July 2023
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 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
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.
For each room/unit click on the name of the lock that is associated with the room.
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/users 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".
- An entry code/user named Booking:{booking number} is added to the lock. Click on the "View Bookings in Locks" button to check which bookings have already been sent. Y
- 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 keypad code, booking date, or room changes, those details will be sent to locks.
- If a booking is cancelled, the associated entry code or user will be deleted from locks.
- The associated entry code or user of a booking sent from Beds24 will be removed one day after check-out.
If a TTLock is offline when an update is sent, the entry code will not be added until the lock comes online again.
5.2 App and code entry methods
There are two ways bookings can be sent to locks: app and code. You can select one or both methods.
5.2.1 Manually changing codes
- Navigate to (SETTINGS) ACCOUNT > PREFERENCES "Bookings" and add "LOCK_PIN" to your Booking Info Code Values.
- 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.3 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
Click on "Disconnect" to terminate the connection.