TTLock: Difference between revisions

Jump to navigation Jump to search
← Older edit
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Apps]]
[[Category:Marketplace]]
[[Category:Self-Check-in]]
[[Category:Self-Check-in]]
[[Category:Lock Systems]]
[[Category:Lock Systems]]
[[Category:Automation]]
[[Category:Automation]]
<div class="heading">TTLock</div>
<div class="heading">TTLock</div>
   This page is about the menu {{#fas:cog}} (SETTINGS) APPS & INTEGRATIONS > TTLOCK  
   This page is about the menu {{#fas:cog}} (SETTINGS) MARKETPLACE > TTLOCK  


For Beds24 the normal channel manger fees apply.
For Beds24 the normal channel manger fees apply.
Line 11: Line 11:
*Beds24 can send booking data to TTLock locks as either an online or offline passcode.
*Beds24 can send booking data to TTLock locks as either an online or offline passcode.


== Online passcode ==
== Online passcodes ==
Online passcodes are sent if the "PIN Strategy" is set to anything other than "Offline".
 
'''Advantages'''
'''Advantages'''
*Can be customised to be between 4-9 digits.
*Can be customised to be between 4-9 digits.
Line 22: Line 24:


== Offline passcode ==
== Offline passcode ==
Offline passcodes are sent if the "PIN Strategy" is set to "Offline".
'''Advantages'''
'''Advantages'''
*The lock does not need to be connected to the internet.
*The lock does not need to be connected to the internet.
Line 33: Line 37:
*Multiple offline passcodes in the same lock cannot share the same start and end time, this includes deleted passcodes.
*Multiple offline 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.
*A deleted passcode cannot be created again with the same start and end time.
= 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.
*The account you connect must be the top administrator account for the lock, this most likely means the account that initially setup the lock.
*Passcodes and their length are determined by TTLock and cannot be customised.


= What you need =
= What you need =
Line 52: Line 46:
'''Step 1:  Connect your TTLock Account'''  
'''Step 1:  Connect your TTLock Account'''  
* On the setup page enter your TTLock username (usually a phone number or email address) and password
* On the setup page enter your TTLock username (usually a phone number or email address) and password
* Note that your username must be what you originally signed up for TTLock with. For example, if you initially signed up with an email address, then later added a phone number, you must provide your email address.
  Note: your username must be what you originally signed up for TTLock with. For example, if you initially signed up with an email address, then later added a phone number, you must provide your email address.
  Note: the account you connect must be the top administrator account for the lock, this most likely means the account that initially setup the lock.


'''Step 2: Set your 'PIN Strategy' '''
'''Step 2: Set your 'PIN Strategy' '''
Line 63: Line 58:


'''Step 3: Connect Common Lock (optional)'''  
'''Step 3: Connect Common Lock (optional)'''  
A common lock is a lock that all bookings in the property will be able to access.


Connecting a common lock is only possible for Wifi connected locks. After you have selected your PIN Strategy and saved click on "Get Codes" to define your common lock.
Connecting a common lock is only possible for Wifi connected locks. After you have selected your PIN Strategy and saved click on "Get Codes" to define your common lock.
Bookings will be sent to the lock mapped to the room assigned to the booking, if there is no lock mapped for the room the booking will be sent to the common lock (if one is mapped). If both a room lock and a common lock are mapped, the booking will be sent to both. The room lock and the common lock will use the same PIN. Multiple common locks can be specified with a space between each of the lock mapping codes.


'''Step 4: Set when bookings should send to locks'''  
'''Step 4: Set when bookings should send to locks'''  
Line 91: Line 90:
Entry codes can only be used during the booking period, they will not provide access before or after.
Entry codes can only be used during the booking period, they will not provide access before or after.


*Updates to locks are sent periodically, approximately every 12 hours but at no fixed time of day. To instantly send updates, click "Send Bookings to Locks". Updates cannot be sent to locks that are not connected to the internet.
*Updates to locks are sent periodically, approximately every 12 hours but at no fixed time of day. To instantly send updates, click "Export to TTLock". Updates cannot be sent to locks that are not connected to the internet (however, new offline bookings can be created for them).
*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.
*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.
*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. Date changes are only possible for codes that have been used at least once.
*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 if the code has been used at least once.
*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.  
*The associated entry code of a booking sent from Beds24 will be removed one day after check-out.  


Line 118: Line 117:
For example :- ACCESS_ENDTIME = 34:00 will create an end time of 10:00 one day after checkout (34 = 24 + 10 hours)
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 code = '''ACCESS_ENDTIME'''
*Booking Info Text = '''34:00'''
*Booking Info Text = '''34:00'''


= Troubleshooting =
= Troubleshooting =
<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Invalid account or invalid password'''
'''Invalid account or invalid password'''
 
</div>
<div class="mw-collapsible-content">
The username and password you provide must be the same username and password you used to create your TTLock account.
The username and password you provide must be the same username and password you used to create your TTLock account.


This will not necessarily be the same username you use to login to TTLock. For example, if you initially signed up with an email address, then later added a phone number, the correct username will be your email address.
This will not necessarily be the same username you use to login to TTLock. For example, if you initially signed up with an email address, then later added a phone number, the correct username will be your email address.
</div></div>


 
<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Cannot access the lock you want'''
'''Cannot access the lock you want'''
 
</div>
<div class="mw-collapsible-content">
The username you enter must be the top administrator account for the lock - most likely this will be the account that initially set up the lock.
The username you enter must be the top administrator account for the lock - most likely this will be the account that initially set up the lock.
If the account provided is not the top administrator account, then you will not be able to access the lock, even if you can access it in the TTLock app with that account.
If the account provided is not the top administrator account, then you will not be able to access the lock, even if you can access it in the TTLock app with that account.
</div></div>
== Errors ==
<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Error: "You are using a low version APP. Please update it to the latest version and re-add the lock"'''
</div>
<div class="mw-collapsible-content">
This error can be fixed by deleting the lock from the TTLock app and then re-adding it.
</div></div>
<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Error: "failed or means no - 表示失败或否"'''
</div>
<div class="mw-collapsible-content">
This error usually means the bluetooth connection between the lock and the gateway is too weak.
</div></div>
<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Error: "The gateway is busy. Please try again later. - 网关正忙，请稍后再试。"
</div>
<div class="mw-collapsible-content">
This error means their is a problem with the gateway's connection to the internet.
</div></div>


<div class="mw-collapsible mw-collapsed">
<div  class="headline-collapse" >
'''Error: "The Lock is not connected to any Gateway. - 锁附近没有可用的网关。"
</div>
<div class="mw-collapsible-content">
This error means there is a problem with a lock's connection to the gateway.
</div></div>


'''You are using a low version APP. Please update it to the latest version and re-add the lock'''
= FAQ =
== Do you support TTHotel accounts? ==
At this point in time TTHotel is not supported, only TTLock.


This error can be fixed by deleting the lock from the TTLock app and then re-adding it.
== What happens if I have the Passcode Strategy set to phone number last x digits but the booking does not have a phone number? ==
If the booking does not have a valid phone number or mobile phone number (it is invalid if it is empty, too short, or only contains one digit e.g. 11 111111111), then a random passcode will be used instead.


= Disconnect=
= Disconnect=
Delete your username and password and set Synchronize to "disabled" to disconnect.
Delete your username and password and set Synchronize to "disabled" to disconnect.
Retrieved from "https://wiki.beds24.com/index.php/TTLock"