Connect your LINE Official Account

Every step from creating an Official Account to a test on your phone, each with a screenshot. Follow this guide too if you already have an Official Account or connected it to another system before.

This guide walks you through connecting your LINE Official Account to SomaTrace. Once connected, messages clients send to your Official Account on LINE show up in SomaTrace's 「LINE 收件匣」 (LINE inbox). You can also send booking links and booking notifications to clients from SomaTrace.

For the SomaTrace Studio plan. It takes about 20–30 minutes, in 40 steps. Screens last checked: 2026-10-20.

First, pick your path

You don't have a LINE Official Account yet

Start at Part A, step 1. Part A adds about 10 minutes.

You already have a LINE Official Account

Jump straight to step 13 and skip all of Part A.

You already have one, and you enabled Messaging API before (for example, for another system)

Start at step 13. Step 15 will show you how to skip steps 16–20.

Both paths use the same step numbers (40 in total). They just start in different places. When you see a note for "existing accounts", follow that part.

There are 40 steps in total. Each step does one thing and has a screenshot. The red box shows where to click. A small label above each step tells you which website you are on. Each step ends with "what you should see". Only move on when your screen matches.

Before you start (check each item)

About 20–30 minutes (10 more if you are creating an Official Account from scratch). Don't step away for too long in the middle. A computer (Windows or Mac), ideally with the Chrome browser. Phone screens are too small, and LINE Developers is hard to use on a phone. A phone with LINE installed (you will send a test message from it at the end). Your LINE account is an "Admin" of this Official Account. (In LINE Official Account Manager, on the 「帳號一覽」 (Account list) page, the 「權限」 (Permissions) column should say 「管理員」 (Admin).) Your SomaTrace account is on the Studio plan. (In SomaTrace → Settings, the "Plan & subscription" row at the top says "Studio".) If not, you can finish the LINE side but won't be able to connect. Please upgrade first. Has this Official Account "been connected to another system"? (For example, another booking system, customer service tool or e-commerce tool.) If so, read point 1 of "Things to know" before you start. Sign in to LINE Official Account Manager and LINE Developers with the "same LINE account" the whole way through. Have a pen and paper ready. You will write down the Official Account's @ID (step 8 for a new account, step 13 for an existing one) and its Channel ID (step 15 for an existing account, step 20 for a new one). Already have an Official Account and enabled Messaging API before? This guide works for you too. Watch for the "existing account" notes in each step (steps 13, 15, 25, 30 and 35).

The 3 websites you will use

You will switch between these 3 websites. A small label above each step (same color as in the table) tells you which website you are on. Open each website in its own browser tab and keep them open.

WebsiteAddressScreen languageWhat you do there
LINE Official Account Managermanager.line.bizChineseCreate the Official Account, enable Messaging API, turn on Webhook, turn off auto-response
LINE Developersdevelopers.line.biz/console/English or Japanese only (no Chinese)Copy two passwords
SomaTraceapp.somatrace.appChinesePaste the passwords, click 「串接」 (Connect), test the connection, read messages

LINE Developers only comes in English and Japanese. Every English button you need is named in this guide.

The 2 things you "copy → paste"

Connecting really just means copying these 2 things from LINE Developers and pasting them into SomaTrace. They are like keys. Don't take photos of them or send them to anyone.

ItemCopy fromPaste intoWhat it looks like
① Channel secretLINE Developers → "Basic settings" tab (step 27)SomaTrace → 「LINE 整合」 (LINE integration) → first box, "Channel secret" (step 28)32 letters and numbers
② Channel access tokenLINE Developers → bottom of the "Messaging API" tab (step 31)SomaTrace → second box, "Channel access token" (step 32)A very long string (about 170 characters), may wrap onto several lines

After you click 「串接」 (Connect), SomaTrace sets the address that receives messages (the Webhook URL) on LINE for you. You don't paste it yourself.

Part A (optional): Create a LINE Official Account

Steps 1–12 | Only if you "don't have an Official Account yet". If you already have one, jump straight to step 13

Show steps 1–12 (only if you don't have an Official Account yet)

Step 1: Click 「建立」 (Create) on the left

You are on: the 「帳號一覽」 (Account list) page

Type manager.line.biz in the browser's address bar and press Enter. If asked to sign in, sign in with your LINE account. In the menu on the "left" of the screen, click 「建立」 (Create).

Step 1: Click 「建立」 (Create) on the left
Step 1: Click 「建立」 (Create) on the left

The browser "opens a new tab", and the page title is 「建立LINE官方帳號」 (Create a LINE Official Account).

After you click 「建立」 (Create), the page opens in a new tab, not the one you were on. If nothing seems to change, look for a new tab at the top of the browser.

Step 2: Fill in 「帳號名稱」 (Account name)

You are on: the new 「建立LINE官方帳號」 (Create a LINE Official Account) tab, section 1 「登錄公司/店鋪資訊」 (Company / store info)

Scroll down to 「帳號資訊」 (Account info). Click the box to the right of 「帳號名稱」 (Account name) (the gray text says 「例如:Brown咖啡館」, e.g. Brown Cafe). Type your business name, for example "Mei's Bodywork Studio". Up to 20 characters.

Step 2: Fill in 「帳號名稱」 (Account name)
Step 2: Fill in 「帳號名稱」 (Account name)

Your business name is in the box, and the number on the right shows the character count, for example "8/20".

This name appears in clients' LINE friend lists and chats, so use a name they recognize.

Step 3: Fill in 「電子郵件帳號」 (Email address)

You are on: the same page, the box below 「帳號名稱」 (Account name)

Click the box to the right of 「電子郵件帳號」 (Email address). Type the email you use most.

Step 3: Fill in 「電子郵件帳號」 (Email address)
Step 3: Fill in 「電子郵件帳號」 (Email address)

Your email is in the box, and the number on the right is no longer "0/240".

This box starts out "empty". It is not filled in for you. If you leave it empty, the final 「確定」 (OK) won't go through.

Step 4: Choose 「業種」 (Industry)

You are on: the same page, 「業種」 (Industry) at the bottom

「公司所在國家或地區」 (Country or region) is already 「台灣」 (Taiwan). Leave it. 「公司名稱」 (Company name) is optional. Click the dropdown on the left of 「業種」 (Industry) (it says 「選擇業種大分類」, choose a category) and choose 「美容、沙龍」 (Beauty & salons). Click the dropdown on the right (it says 「選擇業種小分類」, choose a subcategory) and pick the closest match, for example 「美容美體spa/沙龍、美甲沙龍、按摩」 (Beauty spa / salon, nail salon, massage).

Step 4: Choose 「業種」 (Industry)
Step 4: Choose 「業種」 (Industry)

Both dropdowns show your choice instead of 「選擇業種…」 (Choose an industry...).

For physical therapy or medical work, you can choose 「醫療相關」 (Medical) as the category. For other services, choose 「生活相關服務」 (Lifestyle services). Your choice doesn't affect the connection.

Step 5: Click 「確定」 (OK)

You are on: the bottom of the same page

Scroll all the way to the bottom. Click the green 「確定」 (OK) button.

Step 5: Click 「確定」 (OK)
Step 5: Click 「確定」 (OK)

The progress bar at the top moves to section 2, 「確認輸入內容」 (Confirm your details), and lists what you just entered.

Clicking 「確定」 (OK) means you agree to the 「LINE官方帳號服務條款」 (LINE Official Account Terms of Use) and the 「LY Corporation隱私權政策」 (LY Corporation Privacy Policy) shown above it.

Step 6: Decide whether to tick 「將LINE 商家報加入好友」 (Add LINE Business News as a friend)

You are on: the 「確認輸入內容」 (Confirm your details) page, the 「即時掌握經營官方帳號的實用資訊」 (Get useful tips for running your account) section in the middle

First check the account name and email above for typos. If something is wrong, click 「取消」 (Cancel) to go back and fix it. Below is a checkbox, 「將LINE 商家報加入好友」 (Add LINE Business News as a friend). It is "ticked" by default. Leave it ticked if you want LINE's business tips. If not, click it to untick.

Step 6: Decide whether to tick 「將LINE 商家報加入好友」 (Add LINE Business News as a friend)
Step 6: Decide whether to tick 「將LINE 商家報加入好友」 (Add LINE Business News as a friend)

The checkbox is how you want it (the screenshot shows it unticked). Either way, it doesn't affect the connection.

Step 7: Click 「完成」 (Done) and pass the "I'm not a robot" check

You are on: the 「確認輸入內容」 (Confirm your details) page

Click the green 「完成」 (Done) button. An image check (reCAPTCHA) pops up, for example "Select all images with motorcycles". Click the matching images, then click 「驗證」 (Verify).

Step 7: Click 「完成」 (Done) and pass the "I'm not a robot" check
Step 7: Click 「完成」 (Done) and pass the "I'm not a robot" check

The progress bar at the top moves to section 3, 「申請完成」 (Application complete), with large text saying 「您的LINE官方帳號已建立完成」 (Your LINE Official Account has been created).

The image check often comes "one round after another" (motorcycles, bicycles, traffic lights, crosswalks...). You're not doing anything wrong. Keep answering until the page changes.

Step 8: Click 「稍後進行認證(前往管理畫面)」 (Verify later, go to the management page)

You are on: the 「您的LINE官方帳號已建立完成」 (Your LINE Official Account has been created) page

First look at the 「基本ID」 (Basic ID) line. The part starting with @ is your Official Account ID (for example @770vmxpd). Write it down. You'll need it later. Scroll to the bottom and click the white button 「稍後進行認證(前往管理畫面)」 (Verify later, go to the management page).

Step 8: Click 「稍後進行認證(前往管理畫面)」 (Verify later, go to the management page)
Step 8: Click 「稍後進行認證(前往管理畫面)」 (Verify later, go to the management page)

You are now in LINE Official Account Manager, on a page titled 「同意我們使用您的資訊」 (Allow us to use your information).

Click the white 「稍後進行認證(前往管理畫面)」 (Verify later) button at the bottom, not the green 「申請認證帳號」 (Apply for a verified account) button above it. A verified account needs a separate review and has nothing to do with connecting.

Step 9: Click 「同意」 (Agree)

You are on: the 「同意我們使用您的資訊」 (Allow us to use your information) page

You must agree on this page to use the Official Account. Scroll down and click the green 「同意」 (Agree) button.

Step 9: Click 「同意」 (Agree)
Step 9: Click 「同意」 (Agree)

The page changes to 「LINE官方帳號使用條款更新啟事」 (Update to the LINE Official Account Terms of Use).

Step 10: Click 「了解並繼續使用」 (I understand and want to proceed)

You are on: the 「LINE官方帳號使用條款更新啟事」 (Update to the Terms of Use) page

Scroll down and click the green button 「了解並繼續使用 / I understand and want to proceed」.

Step 10: Click 「了解並繼續使用」 (I understand and want to proceed)
Step 10: Click 「了解並繼續使用」 (I understand and want to proceed)

A small window pops up: 「開始經營帳號前 (1/2)」 (Before you start (1/2)).

Step 11: Click 「下一步」 (Next)

You are on: the small window 「開始經營帳號前 (1/2)」 (Before you start (1/2))

Click the green 「下一步」 (Next) button at the bottom right of the small window.

Step 11: Click 「下一步」 (Next)
Step 11: Click 「下一步」 (Next)

The small window changes to 「首先來增加好友人數吧 (2/2)」 (First, let's get more friends (2/2)).

Step 12: Click 「前往主頁」 (Go to home)

You are on: the small window 「首先來增加好友人數吧 (2/2)」 (First, let's get more friends (2/2))

Click the white 「前往主頁」 (Go to home) button at the bottom right of the small window. (Don't click the green 「增加好友人數」 (Get more friends) button next to it for now.)

Step 12: Click 「前往主頁」 (Go to home)
Step 12: Click 「前往主頁」 (Go to home)

You see your Official Account's home page, with your account name and @ID at the top left. Part A is done! Go straight to step 14.

Done: the Official Account home page, with the account name and @ID at the top left
Done: the Official Account home page, with the account name and @ID at the top left

Part B: Enable Messaging API in LINE Official Account Manager

Steps 13–20 | Lets your Official Account "talk" to SomaTrace

Step 13: Click the Official Account you want to connect and write down its @ID

You are on: the 「帳號一覽」 (Account list) page

Type manager.line.biz in the address bar, press Enter and sign in. In the 「帳號一覽」 (Account list), click the name of the Official Account you want to connect. Once inside, look at the "top left" of the screen. The text starting with @ next to the account name is the @ID (for example @513hdyzo). Write it down. You'll need it in steps 33 and 37.

Step 13: Click the Official Account you want to connect and write down its @ID
Step 13: Click the Official Account you want to connect and write down its @ID

You are on that Official Account's home page. The top left shows your account name and @ID, and this @ID belongs to the account you want to connect.

After clicking in: the @ID is next to the account name at the top left
After clicking in: the @ID is next to the account name at the top left

The 「帳號一覽」 (Account list) does "not" show the @ID, only the account name, friends, permissions and plan. If you have several accounts with similar names, click in and check the @ID at the top left to make sure it's the right one.

If you just finished Part A, you are already on the home page and wrote down the @ID in step 8. You can skip this step.

If your account isn't in the list, or 「權限」 (Permissions) isn't 「管理員」 (Admin), you are signed in with the wrong LINE account. Switch to the LINE account that is the Admin.

Step 14: Click 「設定」 (Settings) at the top right

You are on: the Official Account home page

At the "top right" of the screen, at the far right of the row under the green text, there is a gear icon, 「設定」 (Settings). Click it.

Step 14: Click 「設定」 (Settings) at the top right
Step 14: Click 「設定」 (Settings) at the top right

The page changes to 「帳號設定」 (Account settings), with a menu on the left: 帳號設定 (Account settings), 權限管理 (Manage permissions), 回應設定 (Response settings), Messaging API, 登錄資訊 (Registration info)...

Step 15: Click 「Messaging API」 on the left and check 「狀態」 (Status)

You are on: the 「設定」 (Settings) page

In the menu on the left, click 「Messaging API」 (below 「回應設定」, Response settings). Look at what the 「狀態」 (Status) line says, then follow one of the paths below:

Click 「Messaging API」 in the left menu (a new account then shows the status 「未使用」 (Not in use) and the 「啟用Messaging API」 (Enable Messaging API) button, see step 16)
Click 「Messaging API」 in the left menu (a new account then shows the status 「未使用」 (Not in use) and the 「啟用Messaging API」 (Enable Messaging API) button, see step 16)

The page title is now 「Messaging API」. Next, check 「狀態」 (Status):

Status is 「未使用」 (Not in use) (new account): There is a green 「啟用Messaging API」 (Enable Messaging API) button in the middle → continue in order with step 16.

Status is 「使用中」 (In use) (existing account, enabled before): → Read the "existing account" note below, then jump straight to step 21.

Existing account: status 「使用中」 (In use). This page already shows the Channel ID, Channel secret and 「Webhook網址」 (Webhook URL) (the secret and URL are masked)
Existing account: status 「使用中」 (In use). This page already shows the Channel ID, Channel secret and 「Webhook網址」 (Webhook URL) (the secret and URL are masked)

Existing accounts must do this

When the status is 「使用中」 (In use), write down the 「Channel ID」 under 「Channel資訊」 (Channel info) (10 digits, for example 2011814704). In step 25, you need this number to find your account in LINE Developers.

The 「Webhook網址」 (Webhook URL) on this page may already hold an address (from a system you connected before, or an old SomaTrace address), with a 「儲存」 (Save) button next to it. You don't need to change it here: when you click 「串接」 (Connect), SomaTrace replaces it with its own address. If it belongs to another system, SomaTrace asks you first.

When the status is 「使用中」 (In use), do "not" look for an enable button, and skip steps 16–20. If this Official Account is connected to another system right now, read "FAQ Q5" first.

There is also a 「複製」 (Copy) button next to 「Channel secret」. What you copy here is the same secret you copy in LINE Developers in step 27. Use either one.

Step 16: Click 「啟用Messaging API」 (Enable Messaging API)

You are on: the 「Messaging API」 page

Click the green 「啟用Messaging API」 (Enable Messaging API) button in the middle of the screen.

Step 16: Click 「啟用Messaging API」 (Enable Messaging API)
Step 16: Click 「啟用Messaging API」 (Enable Messaging API)

A small window pops up: 「選擇服務提供者」 (Choose a provider).

If this is your first time, a window may first ask for your 「姓名」 (Name) and 「電子郵件」 (Email) and ask you to agree to the terms (developer registration). Fill it in, tick to agree, then confirm. You'll then reach 「選擇服務提供者」 (Choose a provider).

Step 17: Choose 「建立服務提供者」 (Create a provider) and enter a name

You are on: the small window 「選擇服務提供者」 (Choose a provider)

Make sure the dot is on 「建立服務提供者」 (Create a provider) (usually already selected). Click the box below it (the gray text says 「輸入服務提供者名稱」, enter a provider name). Type your business or company name, for example "Mei's Bodywork Studio".

Step 17: Choose 「建立服務提供者」 (Create a provider) and enter a name
Step 17: Choose 「建立服務提供者」 (Create a provider) and enter a name

The name you typed is in the box, and the number on the right shows the character count (for example "8/100").

Once chosen, the provider "can never be changed". Unless you have a specific reason, "create a new one" like this and use your own business name.

If other names are listed below (for example, ones created when you connected another system), don't choose them unless you're sure you want that one.

Step 18: Click 「同意」 (Agree)

You are on: the small window 「選擇服務提供者」 (Choose a provider)

Click the green 「同意」 (Agree) button at the bottom right of the small window (the white one on the left is 「取消」, Cancel; don't click it).

Step 18: Click 「同意」 (Agree)
Step 18: Click 「同意」 (Agree)

The small window changes to 「隱私權政策及服務條款」 (Privacy policy and terms of service).

Clicking 「同意」 (Agree) means you agree to the 「LINE官方帳號API服務條款」 (LINE Official Account API Terms of Use) shown above.

Step 19: Leave both boxes empty and click 「確定」 (OK)

You are on: the small window 「隱私權政策及服務條款」 (Privacy policy and terms of service)

Both 「隱私權政策」 (Privacy policy) and 「服務條款」 (Terms of service) are optional. You can "leave them empty". Click the green 「確定」 (OK) button at the bottom right.

Step 19: Leave both boxes empty and click 「確定」 (OK)
Step 19: Leave both boxes empty and click 「確定」 (OK)

The small window changes to 「啟用Messaging API」 (Enable Messaging API), with a line on a green background at the top: 「請注意,一旦與提供者連動即無法變更或解除。」 (Note: once linked to a provider, this can't be changed or removed.)

If you have your own privacy policy page on your website, you can enter its address (starting with https://). You can change it later.

Step 20: Final check, then click 「確定」 (OK)

You are on: the small window 「啟用Messaging API」 (Enable Messaging API)

Check that 「帳號名稱」 (Account name) and 「服務提供者名稱」 (Provider name) are what you want. Click the green 「確定」 (OK) button at the bottom right.

Step 20: Final check, then click 「確定」 (OK)
Step 20: Final check, then click 「確定」 (OK)

After a brief spinner, you're back on the 「Messaging API」 page. 「狀態」 (Status) now says 「使用中」 (In use), and below it are 「Channel資訊」 (Channel info: Channel ID, Channel secret) and 「Webhook網址」 (Webhook URL). Write down the 「Channel ID」 (10 digits) now. You'll need it if you can't find your channel in step 25. Part B is done!

Done: the status shows 「使用中」 (In use) (the Channel secret is masked)
Done: the status shows 「使用中」 (In use) (the Channel secret is masked)

The warning 「一旦與提供者連動即無法變更或解除」 (once linked to a provider, this can't be changed or removed) is true: this Official Account will stay under this provider for good. Only click when you're sure.

Part C: Open 「LINE 整合」 (LINE integration) in SomaTrace

Steps 21–23 | Get the place you'll paste into ready first

Step 21: Open SomaTrace and click the gear, 「設定」 (Settings), on the left

You are on: SomaTrace (in a new tab)

In a new tab, open app.somatrace.app and sign in to SomaTrace. In the row of small icons on the far left of the screen, click the gear at the bottom, 「設定」 (Settings).

Step 21: Open SomaTrace and click the gear, 「設定」 (Settings), on the left
Step 21: Open SomaTrace and click the gear, 「設定」 (Settings), on the left

The page title is 「設定」 (Settings), with sections such as 「帳戶」 (Account), 「匯出」 (Export), 「偏好設定」 (Preferences) and 「經營與對外」 (Business & booking).

If your screen is in English, you can go to Settings → Language and choose 中文 (Chinese). This guide uses the Chinese screens.

Step 22: Click 「LINE 整合」 (LINE integration)

You are on: the 「設定」 (Settings) page

Scroll down to the 「經營與對外」 (Business & booking) section. Click the 「LINE 整合」 (LINE integration) row.

Step 22: Click 「LINE 整合」 (LINE integration)
Step 22: Click 「LINE 整合」 (LINE integration)

The page title is now 「LINE 整合」 (LINE integration).

If 「LINE 整合」 (LINE integration) says 「已串接」 (Connected) on the right, SomaTrace is already connected to an Official Account. To switch to another account or reconnect, first disconnect using "Appendix A-1", then come back to step 23.

Step 23: Open the 「LINE 官方帳號」 (LINE Official Account) section

You are on: the 「LINE 整合」 (LINE integration) page

Find the 「LINE 官方帳號」 (LINE Official Account) row at the top. This row "opens on one click and closes on the next". First check whether there are two boxes below it (Channel secret, Channel access token): ‧ You see two boxes = it's already open. Don't click again. ‧ You don't (only one line of text, or just the title) = it's closed. Click 「LINE 官方帳號」 (LINE Official Account) once. Check again after clicking: if you see two boxes, you're set. If they disappeared, you closed it. Click once more.

Step 23: Open the 「LINE 官方帳號」 (LINE Official Account) section
Step 23: Open the 「LINE 官方帳號」 (LINE Official Account) section

You see two boxes: on top, "Channel secret" (gray text 「貼上 LINE channel secret」, Paste your LINE channel secret), and below, "Channel access token" (gray text 「貼上 channel access token」, Paste the channel access token), with a 「串接」 (Connect) button at the bottom. Don't click it yet. Keep this tab open. You'll come back to paste.

After opening, do you see 「官方帳號 ID」 (Official Account ID), 「本月訊息用量」 (Messages this month), 「Webhook URL」 and a 「取消串接」 (Disconnect) button instead of two boxes? Then SomaTrace is already connected to an account. To switch accounts or reconnect, first disconnect using "Appendix A-1".

Part D: Find your channel in LINE Developers and copy the "Channel secret"

Steps 24–28 | The first key (existing accounts: pay close attention to step 25)

Step 24: Open LINE Developers

You are on: LINE Developers (in another new tab)

In another new tab, open developers.line.biz/console/. If asked to sign in, choose to sign in with your LINE account (usually "Log in with LINE account"), and use "the same" LINE account as in LINE Official Account Manager.

Step 24: Open LINE Developers
Step 24: Open LINE Developers

You see the "LINE Developers" page, with "Recently visited channels" at the top. Scroll down to see the "Providers" list. The left menu also has "Providers".

This website is "English or Japanese only". There's no Chinese. Every English button you need is named in the steps.

If this is your first time in LINE Developers, you may be asked for your name and email to "register a developer account". Fill it in and agree.

Another way in: at the bottom of the 「Messaging API」 page from step 15/20, there is a blue link "LINE Developers Console". Clicking it also opens LINE Developers.

Step 25: Find which "provider" your Official Account is under

New account (you did step 17): In the "Providers" list, click the name you chose in step 17 (for example "Mei's Bodywork Studio") → go straight to step 26. Existing account / you don't remember which one: Use Method A. The provider name is often different from the Official Account name, and can even match the name of another Official Account of yours, so searching by name is easy to get wrong. Use Method B only if Method A doesn't open. Method A (most reliable and fastest): Type developers.line.biz/console/channel/YOUR-CHANNEL-ID/messaging-api in the address bar (replace "YOUR-CHANNEL-ID" with the 10 digits, for example developers.line.biz/console/channel/2011814704/messaging-api) and press Enter. Your Official Account's page opens directly → skip to the "check" in step 26. The page may open scrolled halfway down, and the left menu may briefly show "Provider not found". That's normal: wait 2–3 seconds and scroll to the top. Method B (only if Method A doesn't open): Click the first name under "Providers" in the left menu → look in "Channels" for a card whose name = your Official Account name. If it's not there, click the next name on the left and look again, until you find it. Once found, always check the Channel ID in step 26: the same name doesn't mean the same account.

New account: click the name you chose in step 17
New account: click the name you chose in step 17

You found a card with your Official Account name and "Messaging API" below it (with Method A, you're already on the Official Account's page).

Existing account: the Official Account 「測試」 (Test) sits under a provider with a different name (breadcrumb: TOP › provider name › 測試; other names are masked). The number in the address is the Channel ID
Existing account: the Official Account 「測試」 (Test) sits under a provider with a different name (breadcrumb: TOP › provider name › 測試; other names are masked). The number in the address is the Channel ID

Don't click "Create" to make a new provider or channel just because you can't find it! An Official Account has only one Messaging API channel, and a new one won't be linked to your Official Account.

If Method A shows an error or says you don't have permission, the LINE account you signed in with isn't a member of this channel. See "FAQ Q4".

"Recently visited channels" at the top only shows channels you "opened recently". Your account may not be there, so don't rely on it alone.

Step 26: Open the card and check the Channel ID matches

You are on: the provider page, "Channels" tab

Click the card with your Official Account name, a small green square and "Messaging API" below. (With Method A you're already on the page. No need to click.) Look at the top of the page: your Official Account name in large text, and below it a row of tabs: "Basic settings", "Messaging API", "LIFF", "Security", "Webhook errors", "Roles" (some accounts have one or two fewer; that's fine). With Method A, the page opens on the "Messaging API" tab. Click the "Basic settings" tab and look at "Channel ID" at the top. Is it the same as the number you wrote down in step 15 (new account: step 20)? Only a match is correct. If not, go back to step 25 and try the next card.

Step 26: Open the card and check the Channel ID matches
Step 26: Open the card and check the Channel ID matches

Your Official Account name is at the top of the page, the "Basic settings" tab is open, and "Channel ID" matches what you wrote down.

Don't click the "Create a new channel" card on the left.

If you created a new account, checking the Channel ID too is the safest.

Step 27: Copy the "Channel secret"

You are on: the "Basic settings" tab

Scroll down with your mouse wheel to the row labeled "Channel secret" on the left. Click the tiny copy icon (two overlapping squares) to the "right" of the letters and numbers.

Step 27: Copy the "Channel secret"
Step 27: Copy the "Channel secret"

Nothing changes on the screen. That's normal. It's already copied.

At the far right of the same row there's a black "Issue" button. Never click it! It creates a new secret, and the old one stops working.

Don't copy the "Channel ID" above it (digits only) or "Your user ID" below it (starts with U). You want the "Channel secret".

In LINE Official Account Manager, under 「設定」 (Settings) → 「Messaging API」 (step 15), the 「複製」 (Copy) button next to Channel secret copies the same secret. Use either one.

Step 28: Paste the "Channel secret" into SomaTrace

You are on: 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account) (the tab you kept open in step 23)

Click the browser tab with 「微象」 (SomaTrace) in its title to switch back to SomaTrace. Paste it into the "top box", Channel secret (gray text 「貼上 LINE channel secret」, Paste your LINE channel secret).

Step 28: Paste the "Channel secret" into SomaTrace
Step 28: Paste the "Channel secret" into SomaTrace

The top box shows a 32-character string of letters and numbers. The 「串接」 (Connect) button below is still faded and can't be clicked, with 「兩格都貼上後才能串接」 (Paste both to connect) next to it. That's normal.

After pasting, check: if you pasted digits only (10 digits), that's the Channel ID by mistake. Go back to step 27 and copy again.

Part E: Issue and copy the "Channel access token", then click 「串接」 (Connect)

Steps 29–33 | The second key

Step 29: Click the "Messaging API" tab at the top

You are on: LINE Developers (switch back to the LINE Developers tab)

Click the browser tab titled "LINE Developers". Scroll back to the top and click "Messaging API" in the row of tabs (to the right of "Basic settings").

Step 29: Click the "Messaging API" tab at the top
Step 29: Click the "Messaging API" tab at the top

A line appears under "Messaging API", and the heading below reads "Messaging API settings".

Step 30: Get the Channel access token (if there is one already, just copy it; don't click Reissue)

You are on: the bottom of the "Messaging API" tab

Scroll all the way to the bottom to "Channel access token" → "Channel access token (long-lived)". Look at the left and right side, then follow one of the paths below: Case 1: There's "already a long string" on the left, and the button on the right says "Reissue" (most existing accounts) → Don't click anything. Go straight to step 31. Case 2: The left is empty, and the button on the right says "Issue" (first time on a new account) → Click "Issue" once. No confirmation window appears. A long string appears on the left, and the button changes to "Reissue". Then do step 31.

This is what it looks like "when a token already exists" (the token is masked). If you see "Reissue" = don't click it. Just copy.
This is what it looks like "when a token already exists" (the token is masked). If you see "Reissue" = don't click it. Just copy.

There's a long string on the left (that's the token), and the button on the right says "Reissue".

Never click "Reissue"! A channel can only have one token. Reissuing makes the old token stop working. If this Official Account is connected to another system, or was connected to SomaTrace before, they will all disconnect immediately.

Step 31: Copy the token

You are on: "Channel access token (long-lived)" at the bottom of the "Messaging API" tab

Click the tiny copy icon to the "right" of the long string (to the left of the black button).

Step 31: Copy the token
Step 31: Copy the token

Nothing changes on the screen. That's normal. It's already copied.

Don't select the string by dragging with your mouse. It's easy to miss or add characters. Always use the copy icon.

Step 32: Paste the token into SomaTrace

You are on: 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account)

Switch back to the tab with 「微象」 (SomaTrace) in its title. Paste it into the "bottom box", Channel access token (gray text 「貼上 channel access token」, Paste the channel access token).

Step 32: Paste the token into SomaTrace
Step 32: Paste the token into SomaTrace

The bottom box shows a long string. Both boxes are now filled.

The order is: Channel secret (short) in the top box, Channel access token (long) in the bottom box. Don't swap them.

Step 33: Click 「串接」 (Connect) and check the @ID

You are on: 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account)

Check that both boxes are filled and the 「串接」 (Connect) button can now be clicked. Click 「串接」 (Connect). The button changes to 「串接中…」 (Connecting…) and finishes in a few seconds. Compare 「官方帳號 ID」 (Official Account ID) with the @ID you wrote down (new account: step 8; existing account: step 13).

Step 33: Click 「串接」 (Connect) and check the @ID
Step 33: Click 「串接」 (Connect) and check the @ID

A green 「已儲存」 (Saved) appears, followed by your Official Account name and @ID (for example 「已儲存 · 已串接到「微象串接教學」(@770vmxpd)」, Saved · connected to “微象串接教學” (@770vmxpd)). Above it you now see 「官方帳號 ID」 (Official Account ID, for example @770vmxpd), 「本月訊息用量」 (Messages this month) and 「Webhook URL」. The two password boxes change to "••••" plus the last 4 characters. The end of the Webhook URL shows "••••"; that's normal, and 「複製」 (Copy) still copies the full address.

Done: 「已儲存」 (Saved), the Official Account ID and the Webhook URL appear (the URL is masked)
Done: 「已儲存」 (Saved), the Official Account ID and the Webhook URL appear (the URL is masked)

If a box pops up saying 「這個官方帳號目前把個案的訊息送到「…」…確定要改接微象嗎?」 (This Official Account currently sends client messages to “…” … Switch to SomaTrace?), the account is wired to another system (for example another booking system). After switching, that system stops receiving messages (Things to know, point 1). Click OK only if you're sure; Cancel changes nothing.

If 「官方帳號 ID」 (Official Account ID) doesn't match the @ID you wrote down, you connected the wrong account (the token came from the wrong channel). Disconnect using Appendix A-1 and go back to step 25 to search again.

When you click 「串接」 (Connect), SomaTrace sets the webhook URL on LINE and asks LINE to send a test message that checks the Channel secret. A notice appears below: for a new account it's usually a yellow 「還差一步:…打開「Webhook」…」 (One more step: … turn on “Webhook” …). That's normal: steps 34–35 turn it on.

If the Channel secret is wrong, red text appears under its box: 「Channel secret 不對,沒有儲存」 (The channel secret is wrong, so nothing was saved). Nothing is saved and both boxes keep what you pasted: copy the Channel secret again from step 27, paste it, and click 「串接」 (Connect) again.

「本月訊息用量」 (Messages this month) shows 「讀取中…」 (Loading…) for a few seconds right after connecting, then the numbers appear. A new account shows 「0 / 200 則」 (0 / 200). An existing account shows what it has used this month (for example 「34 / 200 則 剩 166 則」, 34 / 200, 166 left). Both are normal.

Part F: Turn on Webhook in LINE Official Account Manager

Steps 34–36 | SomaTrace has already set the webhook URL for you. You only need to flip one switch here

Step 34: Click 「回應設定」 (Response settings) on the left

You are on: the 「設定」 (Settings) page

Switch back to the "LINE Official Account Manager" tab. If you're not on 「設定」 (Settings), click the gear 「設定」 at the top right. In the menu on the left, click 「回應設定」 (Response settings) (above 「Messaging API」).

Step 34: Click 「回應設定」 (Response settings) on the left
Step 34: Click 「回應設定」 (Response settings) on the left

The page title changes to 「回應設定」 (Response settings), with 4 switches: 聊天 (Chat), 加入好友的歡迎訊息 (Greeting message), Webhook and 自動回應訊息 (Auto-response messages).

Step 35: Turn on 「Webhook」 and turn off 「自動回應訊息」 (Auto-response messages)

You are on: the 「回應設定」 (Response settings) page

Find the 3rd switch, 「Webhook」: if it's gray, click it to turn it green. If it's already green, leave it. Find the 4th switch, 「自動回應訊息」 (Auto-response messages): if it's green, click it to turn it gray. If it's already gray, leave it. Leave the other switches alone: 「聊天」 (Chat) stays off and 「加入好友的歡迎訊息」 (Greeting message) stays on.

Step 35: 「Webhook」 is green (on) and 「自動回應訊息」 (Auto-response messages) is gray (off)
Step 35: 「Webhook」 is green (on) and 「自動回應訊息」 (Auto-response messages) is gray (off)

「Webhook」 is green (on) and 「自動回應訊息」 (Auto-response messages) is gray (off). Each click briefly shows 「已儲存」 (Saved) at the bottom left.

Existing account: Webhook may already be green, keep it; turn off auto-response messages if green
Existing account: Webhook may already be green, keep it; turn off auto-response messages if green

You must turn off 「自動回應訊息」 (Auto-response messages). Otherwise a client who sends a keyword may get two replies (one from LINE, one from SomaTrace), or only LINE's canned reply.

If 「Webhook」 is pale gray and can't be clicked, with the small text 「如需操作Webhook,請在Messaging API的設定畫面中設定Webhook網址」 (set a webhook URL in the Messaging API settings to use Webhook) below it, the URL isn't set yet. Go back to 「LINE 整合」 (LINE integration) in SomaTrace and follow the notice there (step 33), or click 「測試連線」 (Test connection).

Step 36: Click 「測試連線」 (Test connection) in SomaTrace

You are on: 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account)

Switch back to the tab with 「微象」 (SomaTrace) in its title. Click 「測試連線」 (Test connection) (between 「更新憑證」, Update credentials, and 「取消串接」, Disconnect).

Step 36: Click 「測試連線」 (Test connection) in SomaTrace
Step 36: Click 「測試連線」 (Test connection) in SomaTrace

Two green messages appear: 「連線正常 · your Official Account name」 (Connection OK, for example 「連線正常 · 微象串接教學」) and 「Webhook 已設定好,個案傳的訊息會送到微象。」 (Webhook is set — client messages will arrive in SomaTrace). Check that the name is your Official Account.

If a yellow or red notice appears instead, follow it. What each notice means is in "FAQ Q3".

Don't click 「更新憑證」 (Update credentials) or 「取消串接」 (Disconnect) now.

Part G: Send a real message from your phone (the most important check)

Steps 37–40 | It only counts as done when a message really arrives

Step 37: Add your Official Account as a friend on your phone

You are on: your phone, in the LINE app

Open LINE on your phone, tap 「主頁」 (Home) at the bottom, then tap the 「加入好友」 (Add friends) icon at the top right (a person with a plus sign). Choose 「搜尋」 (Search), choose 「ID」, type your @ID (for example @770vmxpd, including the @) and search. When your Official Account shows up, tap 「加入」 (Add).

You can also find your @ID as "Bot basic ID" at the top of the "Messaging API" tab in LINE Developers. You can also scan the QR code there with your phone to add the friend (masked in the screenshot).
You can also find your @ID as "Bot basic ID" at the top of the "Messaging API" tab in LINE Developers. You can also scan the QR code there with your phone to add the friend (masked in the screenshot).

Your Official Account is in your friend list on LINE, and you may receive a greeting message.

The small window in step 11 said 「帳號建立完成後,此官方帳號將自動成為您所連動的個人LINE帳號的好友。」 (Once the account is created, it automatically becomes a friend of the personal LINE account you used.) If you created it with the same LINE account, it may already be a friend on your phone. Just go to the next step.

Button names in the LINE app may differ slightly between versions.

Step 38: Send a "test" message

You are on: your phone, in the chat with your Official Account

Open the chat with your Official Account. Type 「測試」 ("test") and send it.

The message is sent. Because you turned off 「自動回應訊息」 (Auto-response messages), LINE won't send you a canned reply. That's normal. In the next step, check in SomaTrace that it arrived.

Step 39: Open 「LINE 收件匣」 (LINE inbox) in SomaTrace and find your test message

You are on: the 「LINE 收件匣」 (LINE inbox) page (app.somatrace.app/line-inbox)

Switch back to the SomaTrace tab. Click 「LINE」 (on a phone it's in the row at the bottom of the screen; on a computer or tablet, in the column on the far left). You can also open app.somatrace.app/line-inbox directly. Check that the page title is 「LINE 收件匣」 (LINE inbox).

After sending 「測試」 (test) from the phone, a new message appears at the top of the LINE inbox (13:38), and usage stays at 34 / 200
After sending 「測試」 (test) from the phone, a new message appears at the top of the LINE inbox (13:38), and usage stays at 34 / 200

The title is 「LINE 收件匣」 (LINE inbox). The top entry is your LINE name, with the 「測試」 you just sent below it and an unread count of "1" beside it. If you see this, the connection works! 🎉

The 「LINE 訊息」 (LINE messages) usage at the top doesn't go up (for example, it stays at 「34 / 200 則」, 34 / 200): messages clients send to you don't count toward your quota.

If you see the 「個案」 (Clients) list instead of 「LINE 收件匣」 (LINE inbox), you clicked 「個案」. Click 「LINE」 next to it instead.

Still nothing after 1 minute? Reload the page (F5). If it's still not there, see "FAQ Q6".

Your name may have a small 「未綁定個案」 (Not linked) label next to it. That's normal. Step 40 explains it.

Step 40: (If needed) Link this LINE friend to a client

You are on: a conversation in 「LINE 收件匣」 (LINE inbox)

Click the conversation in the inbox to open it. At the top of the conversation there's a card, 「這位 LINE 好友還沒連到個案」 (This LINE friend isn't linked to a client yet): Someone new: click 「建立為新個案」 (Create as a new client). A client you already have: click 「連結現有個案」 (Link to existing client) and pick them. If the card says 「可能是個案「…」?」 (Could this be “…”?) and it's them, just click 「是,連結」 (Yes, link).

Step 40: the card at the top of the conversation, 「建立為新個案」 (Create as a new client) or 「連結現有個案」 (Link to existing client)
Step 40: the card at the top of the conversation, 「建立為新個案」 (Create as a new client) or 「連結現有個案」 (Link to existing client)

This LINE user is now linked to the client you chose. From now on, their bookings and messages appear under that client.

SomaTrace does "not" match LINE users to clients automatically. You link each one by hand the first time. You don't need to link your own test account.

LINE Official Account Manager shows 「聊天:關閉」 (Chat: Off) at the top. That's normal: once connected, messages go to SomaTrace and don't appear on LINE Official Account's chat page.

Congratulations, you're all set!

From now on, messages clients send to your Official Account show up in SomaTrace's 「LINE 收件匣」 (LINE inbox). Next, in SomaTrace's 「LINE 整合」 (LINE integration), you can set up 「關鍵字自動回覆」 (Keyword auto-reply) (for example, automatically reply with a booking link when a client sends "book"), 「行前提醒」 (Appointment reminder) and more. See "After you connect" below.

After you connect: booking links and appointment reminders

Decide when to send booking links

In SomaTrace, go to 「LINE 整合」 (LINE integration) → 「關鍵字自動回覆」 (Keyword auto-reply), turn on 「自動回覆預約連結」 (Auto-reply with a booking link) and set your keywords. A booking link is sent automatically only when a client's "whole message" exactly matches one of the keywords.

The 「關鍵字自動回覆」 (Keyword auto-reply) section: the 「自動回覆預約連結」 (Auto-reply with a booking link) switch and trigger keywords
The 「關鍵字自動回覆」 (Keyword auto-reply) section: the 「自動回覆預約連結」 (Auto-reply with a booking link) switch and trigger keywords

You don't have to turn on auto-reply. You can use a booking entry in your rich menu, or send the booking link by hand in a conversation.

Also go to 「設定」 (Settings) → 「公開預約頁」 (Public booking page) → 「預約確認與聯絡」 (Confirmation & contact) and decide whether to turn on 「自動成立預約」 (Auto-confirm bookings). This switch decides whether a client's booking waits for your approval after they submit it. It is separate from keyword auto-reply.

The 「自動成立預約」 (Auto-confirm bookings) switch under 「預約確認與聯絡」 (Confirmation & contact) on the public booking page
The 「自動成立預約」 (Auto-confirm bookings) switch under 「預約確認與聯絡」 (Confirmation & contact) on the public booking page

Appointment reminders (optional)

In 「LINE 整合」 (LINE integration), under 「行前提醒」 (Appointment reminder), turn on 「自動傳送行前提醒」 (Send appointment reminders). SomaTrace then reminds clients on LINE the day before their appointment.

The 「自動傳送行前提醒」 (Send appointment reminders) switch and send time in the 「行前提醒」 (Appointment reminder) section
The 「自動傳送行前提醒」 (Send appointment reminders) switch and send time in the 「行前提醒」 (Appointment reminder) section

Only clients who are linked to LINE and haven't blocked you receive them. Each booking sends one message, which uses your LINE monthly message quota (see Things to know, point 4). Bookings made on the same day don't get a reminder.

Things to know (please read all of these)

An Official Account can only be connected to one system. Once it's connected to SomaTrace, any other system it was connected to (another booking or customer service tool) stops receiving messages. Likewise, if you later connect another system, SomaTrace will stop receiving messages. The Channel secret, token and Webhook URL are all keys: don't send screenshots of them to anyone, and don't paste them into LINE chats, emails or social media (including when you contact support). If they leak, follow Appendix A-2 to switch to new ones. Once connected, reply to clients in SomaTrace. Replies sent from the LINE Official Account app or LINE Official Account Manager don't appear in SomaTrace. It's normal for LINE Official Account Manager to show 「聊天:關閉」 (Chat: Off). LINE message quota: Taiwan's free "Light" plan includes 200 messages a month (you can't buy more). Messages SomaTrace sends on its own (for example booking notifications, appointment reminders, broadcasts) count toward the quota. Instant replies to a client's message and greeting messages don't. SomaTrace's 「本月訊息用量」 (Messages this month) shows how many you've used, and it resets on the 1st of each month. Plans and prices: LINE's official page (Taiwan, in Chinese).

FAQ (find the problem you ran into)

Q1. After clicking 「串接」 (Connect) in SomaTrace, 「已儲存」 (Saved) doesn't appear (you get an error)

Check these in order:

① Did you copy the token with the "copy icon"? Selecting it by hand often misses part of it. Go back to step 31, copy again and paste.

② Are the two boxes swapped? The top is the Channel secret (short), the bottom is the token (long).

③ Has anyone clicked "Reissue"? If so, the old token no longer works. Copy "the string shown now".

④ Is your SomaTrace account on the Studio plan? (Settings → "Plan & subscription")

If red text appears under a box (for example "That’s the channel ID (digits only), not the channel secret" or "the two may be swapped"): follow it, then copy and paste again.

If you see 「LINE 不接受這組 access token,沒有儲存」 (LINE rejected this access token, so nothing was saved): the token is wrong or no longer valid. Copy it again as in ① and ③ above, then paste.

Still not working? Write down the error message text (don't include the token in a photo) and contact SomaTrace support.

Q2. I'm not sure I pasted the Channel secret correctly

If 「已儲存」 (Saved) appeared, it's right: when you click 「串接」 (Connect), SomaTrace asks LINE to send a test message that checks the Channel secret, and a wrong one isn't saved. Red text appears under the secret box instead: 「Channel secret 不對,沒有儲存」 (The channel secret is wrong, so nothing was saved) (step 33). Then confirm once more with the phone test in steps 37–39.

If 「測試連線」 (Test connection) later shows a red 「Channel secret 不對」 (for example someone changed the secret in LINE Developers), or the phone test fails: copy the Channel secret again from step 27, paste it together with the token into the same two boxes, and click 「更新憑證」 (Update credentials) (Appendix A-2). The Webhook URL doesn't change, so you don't need to paste anything again on the LINE side.

Q3. 「LINE 整合」 (LINE integration) in SomaTrace shows a yellow or red webhook notice

SomaTrace sets the webhook URL on LINE and checks it again. When you see:

① 「還差一步:…打開「Webhook」、關掉「自動回應訊息」」 (One more step: turn on “Webhook”, turn off “Auto-response messages”): turn on 「Webhook」 in LINE Official Account Manager as in steps 34–35, then click 「再檢查一次」 (Check again).

② 「Channel secret 不對」 (The channel secret is wrong, shown by 「測試連線」, Test connection): copy the Channel secret again from step 27, paste it with the token into the same two boxes and click 「更新憑證」 (Update credentials). It's only saved once the secret is right.

③ 「LINE 那邊的 Webhook 現在送到「…」,不是微象」 (LINE currently sends webhook events to “…”, not SomaTrace): the Official Account was switched to another system. If you want SomaTrace to receive messages, click 「改接微象」 (Switch to SomaTrace) (Things to know, point 1).

④ 「LINE 送測試訊息到微象沒有成功」 (LINE's test message didn't reach SomaTrace) or 「暫時沒辦法確認」 (Couldn't confirm right now): wait a moment and click 「再檢查一次」 (Check again). If it keeps failing, contact SomaTrace support.

⑤ 「沒辦法自動把 Webhook URL 設到 LINE」 (Couldn't set the webhook URL on LINE automatically): set it up by hand as in Appendix A.

Q4. I can't find my provider or Messaging API card in LINE Developers

The provider name is often different from the Official Account name, so this is very common.

① The most reliable way: in LINE Official Account Manager, go to 「設定」 (Settings) → 「Messaging API」, write down the Channel ID, and type developers.line.biz/console/channel/YOUR-CHANNEL-ID/messaging-api in the address bar (see Method A in step 25).

② Or click through the names under "Providers" in the left menu one by one, find the card named after your Official Account, then check the Channel ID in "Basic settings" (Method B in steps 25–26).

③ Check that you're signed in to LINE Developers with the same LINE account as LINE Official Account Manager (profile picture at the top right).

④ If Method A says you don't have permission and Method B can't find it either, someone else (for example a former vendor or colleague) enabled Messaging API for you. Ask them to add you to that provider's "Roles" as "Admin".

⑤ Don't click "Create" to make a new channel. An Official Account has only one Messaging API channel.

Q5. In step 15, 「狀態」 (Status) already says 「使用中」 (In use), and there's no 「啟用Messaging API」 (Enable Messaging API) button

It was enabled before, perhaps by you, or by another system you connected earlier.

You don't need to enable it again. First write down the 「Channel ID」 on the same page, then continue from step 21. In step 25, use the Channel ID to find your channel.

If this Official Account is still used by another system, first read Things to know, point 1: when you click 「串接」 (Connect), SomaTrace switches the webhook to itself (it asks you first), and that system then stops receiving messages. When a token already exists, step 30 says "just copy it, don't click Reissue".

Q6. I sent 「測試」 (test) from my phone, but nothing appears in SomaTrace's 「LINE 收件匣」 (LINE inbox)

① Reload the SomaTrace page (F5).

② In LINE Official Account Manager → 「設定」 (Settings) → 「回應設定」 (Response settings), is 「Webhook」 green (on)?

③ Click 「測試連線」 (Test connection) in 「LINE 整合」 (LINE integration) and see whether a yellow or red notice appears; handle it as in Q3.

④ The Channel secret may be wrong (see Q2).

⑤ Did you send from an old chat from "before adding the Official Account"? Make sure you've added it as a friend.

⑥ Are you looking at 「LINE 收件匣」 (LINE inbox) (app.somatrace.app/line-inbox)? The client list doesn't show LINE messages.

⑦ If you turned on "Error statistics aggregation", check "Webhook errors" in LINE Developers for the reason and send a screenshot to SomaTrace support.

Q7. LINE Official Account Manager says 「聊天:關閉」 (Chat: Off), and the chat page says chat is turned off

This is normal. You don't need to turn it on. Once connected, client messages go to SomaTrace. Read and reply in SomaTrace's 「LINE 收件匣」 (LINE inbox).

The LINE Official Account chat page says 「『聊天』功能目前關閉中」 (Chat is currently off). This is normal
The LINE Official Account chat page says 「『聊天』功能目前關閉中」 (Chat is currently off). This is normal

If you turn 「聊天」 (Chat) on and reply to clients in the LINE Official Account app, those replies won't appear in SomaTrace, and your records end up split across two places.

Q8. The SomaTrace inbox says 「未綁定個案」 (Not linked)

That's normal. SomaTrace can't tell which client this LINE user is. Open the conversation and, in the card at the top, choose 「建立為新個案」 (Create as a new client) or 「連結現有個案」 (Link to existing client) (step 40). If the same person appears as two clients, see Merge clients created through LINE.

Q9. It was working, then suddenly messages stopped arriving or sending

① Someone clicked "Reissue" in LINE Developers → the token stopped working. Copy the new token and click 「更新憑證」 (Update credentials) as in Appendix A-2.

② Someone changed the Webhook URL to another system's address.

③ This month's message quota is used up (check SomaTrace's 「本月訊息用量」 (Messages this month), for example 200 / 200). The quota resets on the 1st of each month, or you can upgrade your plan in LINE Official Account Manager.

Appendix A: Change passwords or switch Official Accounts

First, which case are you in?

Same Official Account, you just need new passwords (wrong Channel secret pasted, someone clicked "Reissue", or the passwords leaked) → follow A-2 and click 「更新憑證」 (Update credentials). No need to disconnect. Switching to a different Official Account → first disconnect with A-1, then do step 13 through step 39, and finally turn off the old account's webhook with A-3.

A-1: Disconnect in SomaTrace

Go to SomaTrace → 「設定」 (Settings) → 「LINE 整合」 (LINE integration). Look below the 「LINE 官方帳號」 (LINE Official Account) row: if you see 「官方帳號 ID」 (Official Account ID), 「Webhook URL」 and a 「取消串接」 (Disconnect) button = it's open. If you see only one line, 「已串接 @…」 (Connected · @...), or nothing = it's closed. Click 「LINE 官方帳號」 (LINE Official Account) once to open it. (This row opens on one click and closes on the next. If you click wrong, click again.) Click 「取消串接」 (Disconnect). The browser shows a confirmation window: 「取消與 LINE 官方帳號的串接?個案將無法再從 LINE 預約,已建立的預約不受影響。」 (Disconnect this LINE OA? Clients can no longer book via LINE; existing bookings are unaffected.) If you're sure, click "OK" (to keep the connection, click "Cancel"). After clicking "OK", 「取消串接」 (Disconnect) shows a spinner and the details above fade. After a few seconds the two empty boxes come back. No need to click again.

The confirmation window after clicking 「取消串接」 (Disconnect) (the URL is masked)
The confirmation window after clicking 「取消串接」 (Disconnect) (the URL is masked)

You're back to the empty form with the two boxes, "Channel secret" and "Channel access token", and the 「串接」 (Connect) button.

The empty form after disconnecting
The empty form after disconnecting

When you reconnect, SomaTrace sets the new webhook URL on LINE for you. You don't paste it yourself.

A-2: New passwords with 「更新憑證」 (Update credentials)

If it's the same Official Account and you only need a new Channel secret or token, you don't need to disconnect:

In LINE Developers, copy the Channel secret (step 27) and the token (steps 30–31). If the passwords leaked, first click "Issue" next to Channel secret and "Reissue" next to the token to get new ones. The old ones stop working, which is exactly what you want here. In SomaTrace, go to 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account) and paste each into its original box (the gray "••••" is the old one; just paste the new one over it). Click 「更新憑證」 (Update credentials) and look for 「已儲存」 (Saved). Click 「測試連線」 (Test connection) and look for 「連線正常」 (Connection OK), then send a message from your phone to confirm (steps 37–39).

「更新憑證」 (Update credentials) doesn't change the Webhook URL, so you don't need to paste anything again in LINE Developers.

A-3: (Recommended) After switching, turn off Use webhook on the "old" Official Account

After you switch to a new Official Account, the old account on LINE's side still points to SomaTrace's old address, which "no longer works". If the old account won't use SomaTrace anymore, turn it off so it doesn't keep sending messages that fail:

In LINE Developers (developers.line.biz/console/), use the method in step 25 to find the "old" Official Account's channel (check the Channel ID carefully so you don't turn off the new one). Click the "Messaging API" tab and scroll down to "Webhook settings". Click "Use webhook" once so it turns gray (off). Go back to LINE Official Account Manager, switch to the old account → 「設定」 (Settings) → 「回應設定」 (Response settings), and check that 「Webhook」 is gray. If you'll reply to clients yourself on the old account from now on, you can turn on 「聊天」 (Chat).

Only turn off the "old" account. The new account's "Use webhook" must stay green (on), or SomaTrace won't receive messages.

Appendix B: Set up the webhook by hand (only if automatic setup fails)

When you click 「串接」 (Connect), SomaTrace sets the webhook URL on LINE for you. Only if 「LINE 整合」 (LINE integration) in SomaTrace says 「沒辦法自動把 Webhook URL 設到 LINE」 (Couldn't set the webhook URL on LINE automatically) do you need to paste it into LINE Developers yourself, as below.

Show the manual setup steps

1. Copy the Webhook URL

You are on: 「LINE 整合」 (LINE integration) → 「LINE 官方帳號」 (LINE Official Account) (after connecting)

Find the 「Webhook URL」 row. Click the 「複製」 (Copy) button at the "far right" of that row. The end of the address shows "••••" on screen; that's normal, and Copy gives you the full address.

Copy the Webhook URL
Copy the Webhook URL

The address is copied (the screen may not change).

2. Click "Edit" under "Webhook URL"

You are on: the "Messaging API" tab

Switch back to the "LINE Developers" tab. Scroll up to "Webhook settings". Under "Webhook URL", click the small white "Edit" button.

Click "Edit" under "Webhook URL"
Click "Edit" under "Webhook URL"

A long box appears, with a green "Update" button and a gray "Cancel" button below it. New account: the box is empty (gray text "Enter your app's webhook URL"). Existing account: the box "already holds an old address". That's an old setting. In the next step, you'll delete it completely first.

3. Clear the box, then paste SomaTrace's Webhook URL

You are on: "Webhook settings"

If the box already holds an old address, "delete all of it" first and check the box is empty. Paste SomaTrace's address. Check: the box holds "only one" address, it starts with https://, and there's no second https:// in the middle.

Clear the box, then paste SomaTrace's Webhook URL
Clear the box, then paste SomaTrace's Webhook URL

The box holds just one address starting with https://, and the 3 small lines below all have green ticks (Don't leave this empty / Enter a valid HTTPS URL / Enter no more than 500 characters).

Existing account: after deleting the old address and pasting the new one, the box holds a single https:// address (the URL is masked)
Existing account: after deleting the old address and pasting the new one, the box holds a single https:// address (the URL is masked)

The most common mistake on existing accounts: if you paste without deleting the old address first, the new address gets added after the old one. That makes one long wrong address, and messages won't arrive. Always delete the whole old address first, then paste.

The left menu also has a "Search..." box. Don't paste there. Paste into the long box to the right of "Webhook URL".

If the old address isn't SomaTrace's (not one you recognize), this Official Account was connected to another system. Once you switch to SomaTrace's address, that system will stop receiving messages (see Things to know, point 1).

4. Click "Update"

You are on: "Webhook settings"

Click the green "Update" button below the box.

Click "Update"
Click "Update"

The box disappears and the address now shows next to "Webhook URL". Below it are "Verify" and "Edit" buttons, plus switches such as "Use webhook".

5. Make sure "Use webhook" is on

You are on: "Webhook settings"

Find the switch to the right of "Use webhook". If it's gray: click it once so it turns green. If it's already green (common on existing accounts): don't click! Clicking again turns it off.

Make sure "Use webhook" is on
Make sure "Use webhook" is on

The "Use webhook" switch is "green" = on.

This switch is the same as 「Webhook」 under 「回應設定」 (Response settings) in LINE Official Account Manager. Turn it on in one place and the other turns on too.

6. Click "Verify" and see "Success"

You are on: "Webhook settings"

Click the black "Verify" button below the address. Wait 1–2 seconds. A small window says "Success". Click the green "OK" to close it.

Click "Verify" and see "Success"
Click "Verify" and see "Success"

The small window says "Success". After clicking "OK" you're back on the page.

If the small window says something other than "Success" (for example an error code), don't go on. Contact SomaTrace support.

7. (Recommended) Turn on "Error statistics aggregation"

You are on: "Webhook settings"

Find the switch to the right of "Error statistics aggregation" and click it so it turns green. Leave "Webhook redelivery" in the middle gray. Don't touch it.

(Recommended) Turn on "Error statistics aggregation"
(Recommended) Turn on "Error statistics aggregation"

"Use webhook" and "Error statistics aggregation" are green, and "Webhook redelivery" is gray. Manual setup is done!

This step is optional. With it on, if messages ever stop arriving, you can check "Webhook errors" for the reason, which helps support look into it.