LINE Official Account Integration
Connect the LINE Official Account you already have so appointment notifications, the rich menu, and conversational booking all run in LINE. Dolyu doesn't create a new account for you. Create one first in LINE Official Account Manager.
In this guide
- Connect your existing LINE Official Account with three credentials
- Let customers and team members get appointment notifications in LINE
- Set up the rich menu so customers can open your booking page in one tap
- Turn on conversational booking so customers can book right inside a LINE chat
Who can do this
Only the Owner and Admins can change LINE settings. Members link their own LINE notifications in Notification settings.
Connect your LINE Official Account
Go to Settings → LINE. If you haven't connected an account yet, the connection wizard opens. Complete its five steps.
Gather the three credentials
In the LINE Developers Console, open your Messaging API channel and copy these three credentials:
| Credential | Where to find it |
|---|---|
| Channel ID | Basic settings tab |
| Channel secret | Basic settings tab |
| Channel access token | Bottom of the Messaging API tab. Click "Issue" to issue a long-lived token |
Paste the credentials and finish connecting
Paste the three credentials as the wizard prompts. On the last step, "Webhook", click Verify and complete setup. Dolyu sets the webhook URL in LINE automatically and shows the verification result. If your LINE webhook URL already points to another system that's still running, Dolyu doesn't overwrite it. See Share an Official Account with another system.
Turn on Use webhook
If you see a message that "Use webhook" isn't on, go to the Messaging API tab in the LINE Developers Console and turn on that toggle. Then verify again as prompted. Dolyu can't turn it on for you; you have to do it in LINE. While it's off, customer messages don't reach Dolyu.
Once connected, you can do the following on the Account tab:
- Click Test connection to confirm the access token is still valid.
- Click Check webhook status to see whether LINE is sending messages to Dolyu. If notifications aren't arriving, check here first.
- After you reissue the Channel secret or access token in LINE, click Update credentials, paste the new value, and save.
- Click Disconnect to stop sending notifications and receiving messages through LINE. To reconnect, run the wizard again on the Account tab.
Overview
Once connected, two more tabs appear: Overview and Rich menu. The Overview tab has three sections:
- Official account — Connection status. If there's a problem, click Fix to go to the Account tab and fix it.
- LINE notifications — Whether you and your team members have linked LINE notifications, and how many customers can get LINE notifications.
- LINE features — Toggles for conversational booking and the welcome message for new friends. Changes take effect immediately.
Link LINE notifications for your team and customers
Signing in with LINE isn't the same as LINE notifications
Team members and customers who sign in to Dolyu with LINE still need to link here to get LINE notifications.
Customers can start linking from the booking confirmation page, their account page, or their Profile page:
Open LINE or scan the QR code
On a phone, tap Receive booking notifications on LINE. On a computer, click Show QR code to connect on your phone, then scan the code with a phone.
Send the pre-filled message
LINE pre-fills "Receive booking notifications". After the customer taps "Send", the Official Account replies with a link button.
Confirm the account
The customer taps the button in the reply, signs in to their existing Dolyu customer account, and confirms. If it's the wrong account, they can switch.
Finish linking
The customer completes the steps on the LINE screen. The original web page then updates automatically to show they're linked.
When customers start from the link button in the welcome message for new friends or on the rich menu, they don't need to send any text. Tapping the button sends them the same link button.
Team members link from that business's Notification settings page by sending the pre-filled verification text shown on screen. The Notifications tab on your Profile lists your link status for each business you belong to. For any business that isn't linked, click Connect now to link it. The Owner and Admins can see who hasn't linked yet in the "Team members" list on the Overview tab and click Send invite to remind them.
For which notifications are sent through LINE and how to turn them on or off, see Notification Settings.
Set up the rich menu
Design your Official Account's rich menu and point its buttons at your booking page. Customers can then open your booking page from the bottom of the chat window.
Apply a theme
Click Apply theme at the top of the editor and select an industry template (for example, nails, hair, or yoga). It replaces all current buttons and images.
Swap in your own photos and set button actions
Replace the template's sample photos with your own, and assign an action to each button, such as opening your booking page or Link LINE notifications (customers).
Deploy to LINE
Click Deploy menu and confirm. The rich menu appears in LINE only after you deploy it.
When a button's action is Link LINE notifications (customers), customers who tap it start linking LINE notifications without sending any text. Link LINE notifications (staff, internal only) is for team members. Everyone who has added your Official Account as a friend can see the rich menu, so think it through before you add that button.
Turn on conversational booking
Under "LINE features" on the Overview tab, turn on Enable conversational booking. The change takes effect immediately.
- Trigger — Rich menu button, Keyword (e.g. “book,” “reserve”), or Both. We recommend Both.
- Rich menu button — On the Rich menu tab, set a button's action to Book in LINE and deploy the menu. Only buttons with this action start a booking in the chat. Other buttons open your booking page on the web.
- Turn off LINE's auto-response — In LINE Official Account Manager, go to "Settings" → "Response settings". Set "Response mode" to "Bot" and turn off "Auto-response messages". Otherwise, conversational booking won't work.
How customers book in a LINE chat
When a customer sends a message containing a booking keyword, or taps Book in LINE on the rich menu, your Official Account replies with the cards below, in order. The keywords are book, reserve, 預約 and 訂位 (Chinese for "book" and "reserve"), and 予約 (Japanese for "book").
Choose a service
Customers swipe through up to 12 service cards. Each card shows the name, price, and duration.
Add another service or continue
If Allow multiple services per booking is on, the customer can tap Add another service to keep choosing, or tap Next. If it's off, the flow moves straight to the next step.
Choose a staff member
The card lists the staff members who can perform all the selected services, plus No preference. This step is skipped if there's only one staff member or if Let customers choose a staff member is turned off.
Choose a date
Up to 12 dates with availability in the next 28 days, starting today, appear below the chat box.
Confirm the booking
The confirmation card shows the appointment time, services, and total. When the customer taps Confirm booking, the booking is made and your Official Account replies with the booking details.
Customers can tap Cancel at any time to end the flow. After 30 minutes of inactivity, the flow ends automatically.
In these cases, your Official Account replies with a link to your booking page so the customer can book there instead:
- Dolyu can't tell which customer is messaging, for example because they haven't linked LINE notifications yet
- The customer's account has no email address, or the booking requires a phone number and their account doesn't have one
- The service requires signing a consent document or filling out a booking form
- The service has "Customers choose a headcount" turned on, or "Staff needed" set to "No staff needed"
- Less than 20% of this month's LINE message quota is left
Share an Official Account with another system
LINE can send messages to only one webhook URL. If your Official Account is also connected to another system, that system can receive the messages and relay them to Dolyu (relay mode). Without relaying, appointment notifications still go out, but LINE notification links, conversational booking, and the welcome message for new friends don't work.
Set up relaying in the other system
In the other system's relay settings, enter the Dolyu webhook URL shown on the Account tab. Ask the other system's provider to relay LINE's request body and x-line-signature unchanged.
Turn on relay mode
On the Account tab, click Switch to relay mode. You don't need to disconnect LINE or reconnect, and customers and team members who already linked don't need to link again.
Point the LINE webhook URL to the other system
On the Messaging API tab in the LINE Developers Console, change the Webhook URL to the one the other system provides, and make sure "Use webhook" is on.
Confirm relaying works
Send a message to your Official Account, then click Check webhook status. Confirm that the time Dolyu last received a LINE event has updated.
If the other system relays too many requests, they get an HTTP 429 response, and Dolyu doesn't process them. Have the other system retry them later. Events that aren't retried never reach Dolyu.
When sharing an Official Account:
- Don't reissue the Channel access token or Channel secret. Have the other system use the current token. You can copy it from the Messaging API tab in the LINE Developers Console. Reissuing stops Dolyu's LINE notifications. If you must reissue, see Common questions below.
- Let only one system send the welcome message for new friends. If you don't want Dolyu to send it, turn off Send a welcome message when someone adds you as a friend on the Overview tab.
- Let only one system manage the rich menu. Clicking Deploy menu makes Dolyu's menu the default rich menu in LINE. If the current menu was created by another system, the confirmation dialog warns you first.
- Both systems share this month's message quota. Messages the other system sends count toward it too.
If you stop using the other system, click Receive directly with Dolyu on the Account tab. The webhook URL switches back to Dolyu.
Common questions
What LINE Official Account plan do I need to connect?
Either an unverified or a verified account works, as long as you can create a Messaging API channel in the LINE Developers Console and get the three credentials. If an agency manages your Official Account, ask them to set this up for you.
How many LINE Official Accounts can one Dolyu business connect?
One. A Dolyu business can connect only one LINE Official Account.
Can customers get notifications without adding the Official Account as a friend?
No. Customers need to add your Official Account as a friend first. If a customer blocks the Official Account later, they stop getting LINE notifications.
If someone switches phones, do they need to link again?
No. The link is tied to the LINE account, so switching phones or reinstalling LINE doesn't affect it.
What happens to a team member's link after they leave?
After you remove the team member, they no longer get LINE notifications from your business.
What if I reissue the Channel access token or Channel secret?
On the Account tab, click Update credentials, paste the new value, and save. When you reissue a token, LINE's dialog sets the old token to expire after 0 hours (immediately) by default. You can change this to up to 24 hours to give yourself time to update Dolyu. Once the token expires, LINE notifications stop and the Account tab shows the connection wizard instead. Reconnect through the wizard.
What happens when this month's LINE message quota runs out?
LINE notifications pause, and Dolyu sends notifications by email instead. The Owner and Admins get notified. When you upgrade your LINE Official Account plan or the quota resets next month, LINE notifications resume automatically. You don't need to change anything in Dolyu. Customers without an email address don't get notifications while LINE is paused.
Troubleshooting
| Issue | Likely cause | What to do |
|---|---|---|
| The connection test fails | One of the three credentials was pasted incorrectly or has extra spaces | Copy it again from the LINE Developers Console. The Channel access token is long, so make sure you copy all of it |
| Credentials are correct and the test succeeds, but customer LINE notification links and conversational booking don't respond | The "Use webhook" toggle is off | Turn on "Use webhook" on the Messaging API tab in the LINE Developers Console |
| Notifications were working, then all stopped one day | The Channel access token was reissued in LINE but not updated in Dolyu | On the Account tab, click Update credentials and paste the new token. If the tab shows the connection wizard instead, reconnect through the wizard |
| Everything was working, then LINE notification links and conversational booking stopped responding | The Channel secret was reissued in LINE but not updated in Dolyu | On the Account tab, click Update credentials, paste the new Channel secret, and save |
| The "Account" tab says the LINE webhook points to another system | Your LINE webhook URL is set to another system that's still running | If you still use that system, click Switch to relay mode. If not, click Receive directly with Dolyu |
| The webhook status check reports requests with mismatched signatures | The relaying system changed the request, or the two systems use different Channel secrets | Have the other system relay requests unchanged, and make sure both systems use the same Channel secret |
| The other system reports HTTP 429 when relaying to Dolyu | Too many requests relayed in a short time | Have the other system retry later. Events that aren't retried never reach Dolyu |
| A customer's linking screen keeps waiting for confirmation | The link timed out, or the account hasn't been confirmed yet | Have the customer tap Try connecting again on the screen to start over |
| Tapping Book in LINE on the rich menu does nothing | Conversational booking is off | On the Overview tab, turn on Enable conversational booking |
| Tapping a rich menu button does nothing | The button's URL is wrong or no longer works | Check the button links on the Rich menu tab |