Akiles Integration

Overview

Connect Teebly to Akiles to enable automated access control for your indoor golf facility. Akiles is a Barcelona-based startup specializing in access and retrofit solutions, offering products ranging from simple cylinder locks to sophisticated mortise lock systems. With their comprehensive cloud platform, you can manage access, troubleshoot issues, and receive real-time notifications for enhanced operational control.

---

Prerequisites

---

Prepare Your Akiles Devices

Follow these steps to set up your Akiles devices for integration with Teebly:

1. Set Up the Akiles Gateway

   • Plug in your Akiles Gateway and connect it using Ethernet
   • The LED should be blue to indicate that it is connected

2. Prepare Your Akiles Locks

   • Before installing an Akiles Roomlock, take a photo of the QR code inside the lock body
   • The QR code is located on the inside of the lock, opposite the keypad
   • This code is required to add the lock in the Akiles app

3. Log In to the Akiles App

   • Access the Akiles app iOS, or Android
   • Make sure to note your credentials for later use

4. Add the Akiles Gateway

   • In the Akiles app, click the upper-left menu and select Devices
   • At the upper-right corner, click Actions + and select New Device
   • Type a name for the new device and select the site with which you want to associate the device
   • Use a QR code scanner to scan the QR code on the back of the Gateway to retrieve the hardware ID number
   • In the Device Type field, paste the hardware ID number
   • The Akiles app displays Device and Version information based on the hardware ID
   • Click Create Device
   • The Gateway will take a moment to connect to the Akiles server, run a firmware auto-update, and reboot

5. Add Each Akiles Lock

   • Using the photo you took of the QR code inside the lock, scan this code to retrieve the hardware ID number
   • In the Device Type field, paste the hardware ID number
   • The Akiles app displays Device and Version information based on the hardware ID
   • Click Create Device
   • The Akiles app creates the device representation and displays that the device status is offline

6. Connect Each Lock to the Gateway

   • Click the upper-left menu and select Links
   • By default, the Akiles app displays a link between the Gateway and server
   • Click Link +
   • Clear the Server field to remove Server from Central Device
   • Click Central Device and select Gateway
   • Click Peripheral Device and select Lock
   • Click Create Link
   • This link connects the lock to the Akiles server and may take several minutes to complete
   • It also performs firmware updates that take additional time

7. Verify All Devices Are Online

   • Click the upper-left menu and select Devices
   • Make sure that all devices are showing as online

---

Connect Your Devices to Teebly

Once your Akiles devices are properly configured in the Akiles app, you can connect them to Teebly:

1. Log into the Teebly Dashboard
2. Navigate to Operations > Access Control
3. Click Add devices
4. Select Akiles from the list of available access control providers
5. Enter your Akiles app credentials
6. Select the devices you want to be accessible to your customers during their bookings

---

Testing Your Integration

After connecting your devices in Teebly, test that the unlock functionality works as expected:

1. Navigate to Operations > Access Control
2. Click the Test active device button

If the test is successful and your device unlocks, your integration is complete! Your customers will now be able to access your facility during their bookings.

---

Monitoring Access Requests

Teebly logs all access requests for monitoring and troubleshooting purposes. You can find access requests for the last 30 days by navigating to Operations > Door Access Logs.

Logs are also accessible within individual booking details and are not limited to the last 30 days.

---

Troubleshooting

Device Not Appearing in Connection Flow

If your device doesn't appear when connecting to Teebly:

• Verify the device is added to your Akiles app
• Confirm the Akiles Gateway is properly set up and connected
• Check that all devices show as online in the Akiles app
• Verify the lock is linked to the Gateway (not just the server)

Gateway Not Connecting

If your Akiles Gateway isn't connecting:

• Check that the Gateway is plugged in and connected via Ethernet
• Verify the LED is blue (indicating connection)
• Allow time for firmware updates to complete after initial setup
• Try rebooting the Gateway

Lock Shows as Offline

If your lock appears offline in the Akiles app:

• Verify the lock is properly linked to the Gateway (not the server)
• Check the link status in the Akiles app under Links
• Allow several minutes for the link to establish and firmware updates to complete
• Ensure the lock is within range of the Gateway

Device Won't Unlock

If the test unlock command fails:

• Verify all devices are online in the Akiles app
• Check that the Gateway has a stable internet connection
• Ensure the lock-to-Gateway link status is active
• Verify the device batteries are not low
• Try recreating the link between the lock and Gateway

---

Need additional help?

If you're still experiencing issues:

• Akiles hardware or app issues: Contact Akiles Support for help with device functionality, the Akiles app, or gateway connection
• Teebly integration issues: Contact Teebly Support for help connecting Akiles to your Teebly dashboard

---