LINE Integration Help
Overview
LINE Integration connects your facility's LINE Official Account to UnlockOS. Once connected, guests can perform check-in, check-out, reservations, and other operations directly through LINE.
Key Features
- 4-step guided setup wizard for LINE Official Account connection
- Automatic rich menu generation and configuration
- Automatic webhook URL setup
- Choose between check-in, reservation, or both services
- Admin notification settings
Prerequisites
The following are required before setting up LINE integration.
| Required | Description |
|---|---|
| LINE Official Account | Create one via LINE Official Account Manager |
| Messaging API | Enable Messaging API on your LINE Official Account |
| Channel ID | Found in LINE Developers Console |
| Channel Secret | Found in LINE Developers Console |
| Channel Access Token | Issue from LINE Developers Console |
Setup Wizard
When LINE is not yet connected, a 4-step wizard is displayed.
Step 1: Create a LINE Official Account
If you already have a LINE Official Account, select "Yes, I have one" and proceed to Step 2.
If you don't have one, select "No, I'll create one" and follow these steps:
- Click the "Open LINE Official Account Manager" button
- Select "Create Account" and choose the free plan
- Enter your facility name as the account name
- After creating the account, click "Done, Next" to continue
Step 2: Enable Messaging API
- In LINE Official Account Manager, go to "Settings" → "Messaging API"
- Click "Enable Messaging API"
- Select a provider and agree to the terms
- Once enabled, click "Enabled, Next" to continue
Step 3: Copy & Paste Channel Information
- Click "Open LINE Developers Console"
- On the target channel's "Basic settings" tab, find the Channel ID and Channel Secret
- On the "Messaging API" tab, issue a Channel Access Token (click "Issue")
- Copy each value and paste it into the corresponding field below
| Input Field | Where to Find |
|---|---|
| Channel ID | Basic settings tab |
| Channel Secret | Basic settings tab |
| Channel Access Token | Messaging API tab (must issue first) |
To verify the credentials, click the "Test Connection" button. If the Channel Access Token is correct, the LINE bot name will appear and the test will succeed.
Once all fields are filled in, click "Next" to proceed to Step 4.
Step 4: Service Selection
Select which services this LINE Official Account will provide. At least one selection is required.
| Setting | Description |
|---|---|
| Check-in Configuration | Select an existing check-in configuration from the dropdown. Enables check-in, key display, and check-out features. |
| Reservation Configuration | Select an existing reservation configuration from the dropdown. Enables reservation list and new reservation features. |
You can select either check-in, reservation, or both. Selecting "None" disables that feature.
Rich Menu Layout
The rich menu displayed to guests in LINE automatically adapts based on your selection. A live preview is shown at the bottom of the form.
| Selection | Rich Menu Layout | Displayed Buttons |
|---|---|---|
| Check-in only | Half size (3×1) | Check-in, Show Key, Check-out |
| Reservation only | Half size (3×1) | Make Reservation, My Reservations, Facility Info |
| Both | Full size (3×2) | Check-in, Show Key, Make Reservation, Check-out, Contact Us, Facility Info |
Review your settings and click "Connect & Auto-Setup" to complete the process. Once connected, the rich menu and webhook will be configured automatically.
Connected State
After LINE integration is complete, the following information and settings are displayed.
Auto-Setup Status
| Item | Description |
|---|---|
| Rich Menu | Status of the menu displayed on guests' LINE screens |
| Webhook URL | Status of the URL that receives notifications from LINE to UnlockOS |
Admin Notification Settings
Configure conditions under which notifications are sent to the facility administrator via LINE.
| Notification Setting | Description |
|---|---|
| Notify admin on check-in | Send notification when a guest checks in |
| Notify admin on check-out | Send notification when a guest checks out |
| Notify admin on payment failure | Send notification when a payment error occurs |
After changing settings, click "Save Notification Settings".
Note: To receive admin notifications, the administrator must have added the LINE Official Account as a friend.
Friend Add QR Code
To get the QR code for guests to add your LINE Official Account as a friend, go to "Grow Friends" in LINE Official Account Manager.
Disconnect
Clicking the "Disconnect" button will remove the LINE integration, rich menu, and webhook settings. You will need to go through the setup wizard again to reconnect.
Guest LIFF App Flow
Once LINE integration is complete, guests tap buttons in the rich menu to interact with the facility. Some buttons launch the LIFF app (LINE in-app browser), while others respond directly within the LINE chat. The following flows describe what guests experience.
First Time Only: Email Registration
Guests who check in from LINE for the first time are shown an email registration screen.
- Enter an email address
- Enter a name (optional — LINE display name is used if omitted)
- Tap "Next" to proceed to the check-in screen
Registration is required only once. On subsequent visits, guests go directly to the check-in screen.
Check-in Flow
- Tap "Check-in" in the rich menu
- A fee breakdown is displayed (contents vary by plan)
- Tap "Check In" to confirm
- After processing, a digital key (QR code or PIN code) is displayed
Key Display
After check-in, or by tapping "Show Key" in the rich menu, the entry key is sent directly as a LINE message — no app launch required. The key information appears as a rich card in the LINE chat.
The card includes:
- QR code image (scan at the door reader)
- PIN code, if applicable (enter on the keypad next to the door)
- Room / unit name
- Check-in date and time
- Key validity period
If the guest has multiple active check-ins at the same facility, all keys are shown one after another as a carousel of cards.
| Key Type | How to Use |
|---|---|
| QR Code | Hold your smartphone screen up to the reader next to the door |
| PIN Code | Enter the code on the keypad next to the door |
The key is valid only during the active stay. It becomes invalid after check-out.
Check-out Flow
- Tap "Check-out" in the rich menu
- Check-in time and fee breakdown are displayed
- Tap "Check Out" to confirm
- A completion screen appears: "Thank you for your stay"
Contact Us
When the rich menu includes "Contact Us" (available when both check-in and reservation are configured), tapping the button opens the LINE chat keyboard directly. Guests can type a message to send to the facility's LINE Official Account.
Reservation List and New Reservation
- Tap "My Reservations" in the rich menu to view the reservation list
- Each reservation shows the plan name, dates, and status
- Tap "Make a New Reservation" to open the booking site (booking.unlockos.io) in an external browser
Troubleshooting
Connection test fails
- Verify the Channel Access Token: Re-issue the token from the Messaging API tab in LINE Developers Console and paste it again.
- Confirm Messaging API is enabled: Check that it is enabled under "Settings" → "Messaging API" in LINE Official Account Manager.
- Check for extra whitespace: Make sure there are no leading or trailing spaces in the pasted token.
Provisioning fails (rich menu or webhook not configured)
- Verify the Channel Secret: Double-check the Channel Secret from the Basic settings tab in LINE Developers Console.
- Contact support: Copy the error message and send it to support@unlockos.com.
Rich menu is not displayed in guests' LINE
- On the connected screen, verify that "Rich Menu" shows "Configured" under Auto-Setup Status.
- The guest may not have added your LINE Official Account as a friend yet. Provide them with the QR code.
- Changes in LINE can take a few minutes to reflect.
Admin is not receiving notifications
- Confirm that the administrator's LINE account has added the LINE Official Account as a friend.
- Confirm that the relevant notification settings are enabled.
LIFF app does not open or shows an error
- "LIFF ID not configured" error: This is a system configuration issue. Contact support@unlockos.com.
- "LINE login required" error: Make sure the guest is tapping the button from within the LINE app. This message appears when accessing the URL directly from an external browser.
- Blank white screen: Restart the LINE app and try again.
Guest check-in fails
- Verify that the guest has completed the one-time email registration.
- Confirm that a check-in configuration is selected in the LINE integration settings (Step 4).
- Confirm that the selected check-in configuration is active and has a valid pricing plan.
Key is not displayed
- Tapping "Show Key" sends the key as a message in the LINE chat — make sure the guest is looking in their LINE chat history, not in an app.
- If check-in succeeded but no key message appears, the smart lock may not be connected. See Lock Connection.
- If the key card shows but cannot be used at the door, verify the lock connection and that the key has not expired.
Guest reservations are not displayed
- Confirm that a reservation configuration is selected in the LINE integration settings (Step 4).
- Confirm that the reservation has "confirmed" status.
FAQ
Q: Can one LINE Official Account be used for multiple facilities?
A: No. Each LINE Official Account can only be linked to one facility. If you manage multiple facilities, create a separate LINE Official Account for each.
Q: Can I connect a LINE Official Account that already uses Messaging API?
A: Yes, but the existing webhook settings will be overwritten with UnlockOS's webhook URL. Please verify your existing webhook setup before proceeding.
Q: Can I change the check-in or reservation configuration after LINE is connected?
A: With the current setup, you will need to disconnect and reconfigure to change service selections.
Q: What can guests do through LINE?
A: Guests tap rich menu buttons to interact with the facility. With a check-in configuration selected, guests can check in, view their digital key (delivered as a Flex Message directly in LINE chat), and check out. With a reservation configuration selected, guests can view their reservation list and make new reservations (redirected to the booking site). When both configurations are active, a "Contact Us" button also appears, letting guests open the chat keyboard to send a message directly to the facility.
Q: What does a guest need to do the first time they check in via LINE?
A: The first time only, guests must register their email address in the LIFF app. After that, their email is linked to their LINE account and they go directly to the check-in screen on subsequent visits.
Q: Is the fee shown to guests before check-in?
A: Yes. The check-in confirmation screen shows a breakdown of applicable charges and the total amount before the guest confirms.
Q: What if I need help with the setup?
A: You can request paid setup assistance using the "Request Setup Assistance" button at the bottom of the page (¥300,000).