Skip to main content

TTLock Smart Lock Integration

Connect AVA to TTLock smart locks for automatic PIN code generation. Guests receive unique, time-limited PIN codes upon check-in.

Where to Find It​

Settings → Room Access → Smart Lock Vendor → TTLock

Guest & Staff Impact​

  • Guests: Receive a time-limited PIN so they can go straight to the room after check-in.
  • Staff: Reduced front desk workload because keys do not need to be handed out.

Prerequisites​

  1. TTLock locks installed on all guest rooms
  2. TTLock developer or hotel account
  3. Locks configured in the TTLock app

Configuration Steps​

Step 1: Select Smart Lock Method​

  1. Go to Settings → Room Access
  2. Select Smart Lock (PIN) as the Room Key Issuance Method
  3. Click Save

Step 2: Choose TTLock Vendor​

  1. In the Smart Lock Vendor dropdown, select TTLock
  2. A warning appears if not yet linked

Step 3: Configure PIN Settings​

  • PIN Code Expiration Time: When PINs expire on checkout day (default: 11:00 AM)
  • Random Custom PIN Length: 4-8 digits available for TTLock

Step 4: Connect Your TTLock Account​

  1. Scroll to TTLock Integration section
  2. Enter your TTLock Username (app login)
  3. Enter your TTLock Password
  4. Click Connect TTLock Account
  5. Wait for connection to complete

Step 5: Verify Connection​

After connecting, you'll see:

  • ✅ Green checkmark = "TTLock Account Linked"
  • 🔴 Red icon = Connection failed

How It Works​

  1. Guest checks in → AVA generates a unique PIN via TTLock API
  2. PIN sent to guest → Via email or shown on confirmation screen
  3. Guest uses PIN → Enters code on door keypad
  4. Guest checks out → PIN automatically deleted

Available PIN Lengths​

Unlike Igloohome, TTLock supports longer PINs:

DigitsSecurity Level
4Basic
5Standard
6Recommended
7High
8Maximum

Troubleshooting​

"Account Not Linked" Warning​

  1. Enter your TTLock app credentials
  2. Click Connect TTLock Account
  3. Verify credentials are correct (case-sensitive)

"Connection Failed" Error​

  1. Verify username and password
  2. Check your TTLock account is active
  3. Ensure no special characters are causing issues
  4. Try resetting your TTLock password

PINs Not Generating​

  1. Confirm TTLock account is linked (green status)
  2. Verify locks are online in TTLock app
  3. Check room-to-lock mapping is correct
  4. Contact support if issue persists

To disconnect:

  1. Go to Settings → Room Access
  2. Find the TTLock Integration section
  3. Click Unlink TTLock Account

Security Considerations​

  • 🔒 Use 6+ digit PINs for better security
  • 🔒 Set appropriate expiration times
  • 🔒 Use a dedicated TTLock account for AVA
  • 🔒 Periodically rotate your TTLock password
warning

Your TTLock credentials are transmitted securely but stored by AVA for API access. Use a dedicated service account when possible.

Need Help?​