Connect your LINE Official Account to your gym software
The four credentials, the two addresses, the five steps in order, and the three settings on LINE's side that stop every message without a word of warning. Written from a real setup, not from a marketing page.
LINE About 1 hour Free up to 20 active members. LINE sign-in and automatic messages included.
One customer paid to have this done. That is the most honest measure of the difficulty. Nothing in any single step is complicated, but the console is unfamiliar and two of the mistakes cannot be undone without starting a channel again.
Four things have to exist first
None of them is provided by your software. You bring your own LINE accounts, and the connection points at them.
This is what your members add as a friend, and what your messages are sent from.
This is where most of the work happens.
Other staff do not see the integrations screen at all.
Four fields, from two different channels
Two belong to the channel that signs your members in, two to the channel that sends the messages. Mixing them up is the most common reason a connection saves cleanly and then does nothing.
1 LINE Login
Channel ID (LINE Login)LINE Login channel → Basic settings
2 LINE Login
Channel secret (LINE Login)Same channel, same tab
3 Messaging API
Messaging API access tokenMessaging API channel → Messaging API tab
You may have to press Issue the first time.
4 Messaging API Often missed
Channel secret (Messaging API)Messaging API channel → Basic settings
A different tab from the token above. This is the one people miss.
The two addresses
Messaging API
webhook URLhttps://…/api/line/webhook
LINE Login
callback URLhttps://…/api/line/callback
Two addresses travel the other way, from your software into LINE: a webhook URL that goes into the Messaging API channel and brings your members' replies in, and a callback URL that goes into the LINE Login channel and links a member's account to their profile. They are not interchangeable. Put each one in the other's box and everything still looks normal: the connection saves, sign-in works, and replies simply never arrive. Copy them, never retype them, since a trailing slash is enough to break sign-in.
Five steps, in this order
Do not skip ahead. Step five only becomes possible once steps two and four are both done, and it is the step that decides whether any message is ever delivered.
- Create a provider
A provider is just a container. Both channels you are about to create have to live inside this same one. Name it after your studio.
- Create a Messaging API channel
This channel is your Official Account: it is what sends the messages. Once it exists, open its Messaging API tab, issue the access token, and paste it into field 3. Its Basic settings tab gives you field 4.
- Give that channel the webhook address
Still in the Messaging API tab, paste the webhook URL, turn on Use webhook, and press Verify. LINE should answer Success. Both parts matter: the address, and the toggle underneath it.
- Create a LINE Login channel under the same provider
Check the provider name at the top of the page before you create it. Copy its Channel ID and secret into fields 1 and 2, then paste the callback URL into its Callback URL, and turn on the toggle above it.
- Link the Official Account to the Login channel
In the LINE Login channel, open Basic settings and find Linked LINE Official Account. Press Edit and choose the account you created in step two. Skip this and LINE never offers Add as friend, so nobody becomes a friend, and an Official Account can only write to its friends.
Three switches to turn off
They live in the LINE Official Account Manager, not in the Developers Console and not in your software. All three are on by default, all three interfere, and no software can read them for you.
Off
Chat mode, offChat mode tells LINE a human will answer inside the LINE app. While it is on, LINE keeps incoming messages to itself and never calls the webhook, so nothing your members write reaches your inbox.
Off
Greeting messages, offLINE sends its own welcome the moment someone adds your account as a friend. Since members usually become friends at the exact moment they book, they receive LINE's greeting stacked on top of your booking confirmation.
Off
Auto-reply messages, offSame reasoning. LINE's automatic replies land on top of whatever your software sends, and they compete with the keyword replies you set up yourself.
Turn these off before you tell members they can reach you on LINE. Undoing the confusion of duplicate messages costs more than the two minutes this takes.
The only test that proves anything
No indicator can tell you a message reached a real phone, because LINE reports a send as successful even when it quietly drops it. So test it the way a member experiences it. You need one phone with LINE installed.
- Sign in as a member on a phone with LINE installed, using Continue with LINE
If LINE offers Add as friend, accept it. If it never offers, stop and go back to step five.
- Book a class
The confirmation should reach LINE within a few seconds, from your Official Account, under your studio's name.
- Write anything back to the Official Account, then open the inbox
Your message should appear there within twenty seconds, attached to that member.
If all three work, every part of the chain has been exercised: the Login channel, the friend link, the messaging token and the webhook. Nothing else needs checking.
LINE is one piece of a bigger picture. The page for gyms based in Thailand takes the rest of what changes here: the PromptPay QR at the counter, the receipt with your tax number on it, the PDPA, and why your booking page shows up in search.
When nothing arrives, in order of likelihood
All five look like a working connection from inside the software. Work down the list.
1
The Official Account is not linked to the Login channelSilent and total. LINE never offers Add as friend, so nobody is a friend and nothing is delivered.
Fix: Step five. Members who already signed in are offered the friend prompt the next time they sign in.
2
The two channels sit under different providersAccounts link, every send reports success, nothing arrives. LINE issues a different user identifier per provider, so two channels under two providers can never recognise the same person.
Fix: A new channel under the right provider, and every member links again. There is no other way, and a channel can never be moved.
3
The two addresses are swappedSign-in works, messages go out, replies never come back. Putting each address in the other's box looks completely normal.
Fix: Recheck both boxes on LINE's side, character for character. A trailing slash or a www. is enough to break it.
4
Chat mode is still onYour outgoing messages work perfectly. Nothing your members write ever reaches the inbox.
Fix: LINE Official Account Manager, Chat mode off.
5
The messaging token was revokedFails silently as well, and nothing monitors it.
Fix: If messages stopped on a particular day and nothing else changed, reissue the token and paste it in again.
LINE sign-in and the 26 automatic messages are included free up to 20 active members, then 2,490 THB a month.
Prices shown in THB.
We connect LINE for you, as an optional paid service.
Questions
Questions people actually ask
Do I need my own LINE Official Account?
How long does the setup take?
Why does everything look connected while no message is delivered?
Can members reply, and where do their replies go?
What can be sent on LINE?
Can one gym use several Official Accounts?
Does a member need an email address?
Is LINE included in the free plan?
Keep reading