Table of contents
1. GokiAir doesn't detect the locks
GokiAir has the capability to detect locks within a range of 10 meters, taking into consideration the building's structural conditions. It should establish a connection with each lock within a maximum of 3 minutes. In the event that GokiAir does not detect any locks, please follow these steps:
Check the device: Ensure that the GokiAir device displays a blue light, indicating that it is functioning properly.
If the device shows a red light: This indicates that it is either not set up or not connected to the server. In such cases, you will need to disconnect and reconnect the GokiAir device.
Firewall considerations: If your network has a firewall in place, ensure that it is not blocking the connection to saas-gateways-socket.goki.travel:2999. Blocking this connection may result in a timeout error, preventing the GokiAir from establishing a successful connection.
Unlock the lock or enter a PIN: This action triggers the lock to communicate with the GokiAir device, increasing the likelihood of detection and resolving any potential connectivity issues.
2. GokiAir didn't generate the 4-digit PIN
If the GokiAir device fails to generate a 4-digit PIN for a reservation, please follow these steps:
Check the GokiAir device: Ensure that it does not display a red light. A red light indicates that the GokiAir device is not properly set up or connected to the server. If there is a red light, you will need to address the setup or connection issue before proceeding.
Blue light and long PIN generation: If the GokiAir device has a blue light but continues to generate a long PIN, it may be busy with another ongoing action or may have lost its connection temporarily. In such cases, you can try to regenerate the pin.
3. Error code - 69
If you encounter error code 69, it indicates that the gateway status is unknown. This can occur when the gateway is unable to find a WiFi connection. To address this issue, please follow these steps:
Ensure WiFi access: Verify that the gateway has access to a working WiFi network. Double-check the WiFi connection settings to ensure they are correct.
Move faulty GokiAir closer to a working one: If the GokiAir device displaying error code 69 is in close proximity to another functioning GokiAir device, try moving it closer to establish a better WiFi connection. Then, disconnect the faulty GokiAir and proceed with the setup process again.
Check GokiAir light status: After setting up the GokiAir device again, observe the light status. If it displays a blue light, it suggests that the issue lies with the WiFi network itself. You may need to troubleshoot the WiFi network or seek assistance from your network provider.
4. Common Area's PIN is not visible in the Check-in Email
GokiAir allows the system to generate a 4-digit PIN for the Room and Common Area, however, if the PINs are not the same or are not visible in the Check-in email, it's important to check the following:
Make sure the common area door is connected to a GokiAir.
Ensure that a common area is linked to the room from the dashboard/Spaces.
Ensure that the Spaces > Common Area Details > Customization > Reservation PINs toggle is enabled.
If the common area door is linked to the room and connected to GokiAir but still doesn't show up the same as the reservation PIN or isn't in the check-in email, please get in touch with Goki support - [email protected]
Important Note:
As a backup, please always create and set up a common area 4-digit shared PIN manually via the Spaces App. In the case of a power or WiFi outage, this manually created PIN will be included and shared at check-in with the room PIN so the guest can enter the common areas without issues.
If the lock relies on Gokiairs, always enable Power Save mode to force the connection to Gokair and make it stable.
5-Gokiair signals are weak/Guidelines. How to fix it?
Goki Bluetooth Gateways Installation Guidelines1. OPTIMAL GATEWAY PLACEMENT BY BUILDING TYPE
Standard Construction (Drywall and Wood Frame)
Coverage
: One gateway per 4 guest rooms maximum
Mounting height
: 4 feet (1.2m) from floor level
Maximum range
: 30 feet (9m) from furthest door
Concrete and Brick Buildings
Coverage
: One gateway per 2-3 guest rooms
Mounting height
: 4 feet (1.2m) from floor level
Maximum range
: 15-20 feet (4.5-6m) from furthest door
Additional consideration
: Install supplementary gateways near particularly thick walls
Modern Steel Frame Construction
Coverage
: One gateway per 3-4 guest rooms
Mounting height
: 4 feet (1.2m) from floor level
Special consideration
: Avoid direct mounting on metal surfaces
Universal Placement Principles
Position gateways in corridor centers to maximize coverage on both sides
Maintain line of sight to doors whenever possible
Install within proximity to power or network infrastructure
Maintain consistent height aligned with door hardware
Ensure minimum 3-foot clearance from other electronic equipment
Areas Requiring Additional Coverage
Elevator lobbies
: Install gateways on both sides of elevator banks
Stairwells
: Require one gateway per floor level
Extended corridors
: Additional gateway every 50 feet
Meeting spaces
: Dedicated gateway for each conference room
Building corners
: Signal does not propagate around corners effectively
2. SIGNAL ATTENUATION FACTORS
Complete Signal Barriers
The following obstacles prevent signal transmission entirely:
Elevator shafts and cars
Fire-rated metal doors
Electrical and mechanical rooms
Commercial kitchen areas
(microwave interference)
Severe Signal Reduction (75% Range Loss)
These materials and obstacles significantly impair connectivity:
Reinforced concrete walls
Mirror installations
(large wall-mounted mirrors)
Metal door frames and fire exits
Bathroom walls
(combination of plumbing and tile)
Masonry walls
(particularly thick or historic brick)
Moderate Signal Reduction (50% Range Loss)
Common building elements that reduce effective range:
Multiple gypsum board walls
Metal decorative elements or signage
Storage areas with metal shelving
High-density guest areas
(device interference during peak occupancy)
Installation Verification
A practical rule for installers: If a direct walking path from the gateway to the door is obstructed, signal propagation will be similarly impaired. Additional gateways should be installed to ensure reliable coverage.
RECOMMENDATION
For optimal guest experience and system reliability, we recommend installing one gateway per four guest rooms as a maximum coverage ratio. In buildings with challenging construction materials or layouts, this ratio should be reduced further to ensure consistent connectivity and minimize potential service disruptions.