在自動旅程的動作中,寫成 {{變數名}} 的部分,會在執行時替換成每位好友的實際值。本文將說明可使用的變數清單、可輸入的位置,以及與群發訊息、自動化訊息的變數之間的差異。
變數的運作方式
變數是用半形雙大括號將名稱括起來撰寫。支援的輸入欄有 「插入變數」 按鈕,可打開清單選擇,也可以手動輸入。旁邊的 「表情符號」 、 「LINE 表情符號」 按鈕可插入表情符號(LINE 表情符號可用於發送訊息的文字,以及自由填寫、快速回覆的問題內文)。
例如在訊息內文中如下撰寫,發送時就會替換成好友的顯示名稱。
您好,{{line.displayName}}!
- 括號內前後有無空白皆可運作(
{{ line.displayName }}也可以) - 不支援的變數名稱,或找不到值的變數無法被替換(只有 HubSpot 等含服務名稱的屬性變數會變成空白)。內文中若殘留無法替換的變數,該則訊息不會發送
- 在變數後面加上
or '替代文字',找不到值時就會帶入替代文字(例:{{line.displayName or '貴賓'}}) - 替換會在自動旅程執行時發生。測試時請以實際的好友確認運作
值未設定時的替代文字(or 語法)
在變數後面加上 or '替代文字',沒有值的好友會帶入替代文字,即使名稱等尚未設定,文案也能保持自然。
{{line.displayName or '貴賓'}}您好!
在這個範例中,可取得顯示名稱的好友會收到「田中太郎您好!」這樣帶有名稱的訊息,無法取得的好友則會收到「貴賓您好!」。
or的前後請加上半形空格。大寫的OR也可運作- 替代文字請以引號(
'或")包住。使用輸入法輸入的全形引號也可運作 - 含服務名稱的屬性變數也適用,例如
{{hubspot.~ or '無'}} - 將替代文字設為空白(
or ''),沒有值時就不顯示任何文字 - 數字
0會被視為有值,不會被替換為替代文字 - 群發訊息、自動化訊息的變數(如
{{display_name or '貴賓'}})也可使用相同寫法
可使用變數的動作與輸入欄
可使用變數的是以下動作的輸入欄。其他輸入欄不會被替換。
| 動作 | 可使用變數的輸入欄 | 補充 |
|---|---|---|
| 發送訊息 | 訊息內文(文字) | 所有變數皆可使用 |
| 提問 | 問題內文 | 選項的標籤與錯誤訊息中無法使用。問題內文中也可以使用{{display_name}}與{{line_user_id}}(群發訊息、自動化訊息的變數) |
| 發送 Webhook | 請求內文 | Webhook 網址中無法使用 |
| 設定欄位 | 要設定的值 | |
| 設定 HubSpot 屬性 | 要設定的值 | 日期型屬性也可從 「動作執行時的日期」 「選擇的日期」 等選項設定 |
| 設定 Klaviyo 屬性 | 要設定的值 | |
| 發送自訂事件 | 事件名稱、數值、貨幣 | |
| AI智慧客服 | 歡迎訊息 |
以下位置無法使用變數。
- 條件分支的比較值(屬性條件的值無法寫入變數)
- 標籤、延遲、更新圖文選單、註冊 HubSpot 自動旅程的各項設定
- 以「自動化訊息」「傳送 LINE 通知訊息」動作所選訊息的內文(自動化訊息的內文中只能使用顯示名稱或整合屬性的變數。若想插入提問的回答或日期,請使用發送訊息動作的文字)
好友基本資訊的變數
好友的 LINE 個人檔案資訊,不論觸發條件的種類為何,隨時都能插入。
| 變數 | 插入的值 |
|---|---|
{{line.userId}} |
好友的 LINE 使用者 ID |
{{line.displayName}} |
好友的顯示名稱 |
{{line.pictureUrl}} |
大頭貼圖片的網址 |
{{line.statusMessage}} |
狀態訊息 |
好友的獲取來源(從哪裡成為好友)也能作為變數插入。「首次」是最初加入好友時的來源,「最新」是最近一次掃描 QR Code 或連結的來源。
| 變數 | 插入的值 |
|---|---|
{{line.firstSourceType}} |
首次來源的類型(追蹤 QR Code、網站加好友 CTA 等) |
{{line.firstSourceName}} |
首次來源的 QR Code 名稱(經由 CTA 時為設置名稱) |
{{line.firstSourceCategory}} |
首次來源的分類 |
{{line.firstSourcePageUrl}} |
首次來源的頁面 URL(加好友開始的頁面) |
{{line.lastSourceType}} |
最新來源的類型 |
{{line.lastSourceName}} |
最新來源的 QR Code 名稱 |
{{line.lastSourceCategory}} |
最新來源的分類 |
{{line.lastSourcePageUrl}} |
最新來源的頁面 URL |
沒有記錄獲取來源的好友,這些變數會以空值插入。條件分支(LINE 個人檔案)也能選擇相同項目作為條件欄位;不過比較值不能插入 {{line.firstSource...}} 等變數。
為了與從舊產品遷移過來的自動旅程相容,{{lha_line_user_id}} 也會替換成 LINE 使用者 ID。
收到訊息、點擊操作的變數
可以插入觸發此觸發條件的訊息或按鈕操作的內容。觸發時的值會保留到流程結束為止,因此即使是在延遲或提問之後的動作也能使用。
| 變數 | 插入的值 | 可使用的觸發條件 |
|---|---|---|
{{message.text}} |
收到的訊息內文 | 收到訊息 |
{{postback.data}} |
被點擊按鈕的 postback 資料 | 收到 Postback |
{{trigger.params.date}} |
以日期時間選擇按鈕選擇的日期(yyyy-MM-dd) | 收到 Postback(日期時間選擇) |
{{trigger.params.datetime}} |
以日期時間選擇按鈕選擇的日期時間 | 收到 Postback(日期時間選擇) |
提問回答的變數
{{answers.lastAnswer}} 會替換成好友在前一個提問動作中所回答的內容。可用於複述回答,或運用回答進行說明。
| 變數 | 插入的值 |
|---|---|
{{answers.lastAnswer}} |
前一個提問的回答(選項的值、自由填寫的文字,若為日期選擇則為 yyyy-MM-dd 格式的日期) |
例如,在日期選擇的提問之後接上發送訊息動作,並將內文寫成如下內容,就能複述所選的日期。
您選擇的是 {{answers.lastAnswer}},我了解了!
日期、時間的變數
可以插入動作執行當下的日期或時間。適合用於提醒或在問候語中嵌入日期。
| 變數 | 插入的值 | 範例 |
|---|---|---|
{{date.today}} |
執行日的日期 | 2026-07-22 |
{{date.now}} |
執行的日期時間(含時區) | 2026-07-22T18:30:00+09:00 |
{{date.year}} |
年 | 2026 |
{{date.month}} |
月 | 7 |
{{date.day}} |
日 | 22 |
{{date.hour}} |
時 | 18 |
{{date.minute}} |
分 | 30 |
{{date.dayOfWeekJa}} |
星期(日文) | 火曜日 |
{{date.dayOfWeek}} |
星期(英文) | TUESDAY |
{{date.formatted}} |
日文格式的日期時間 | 2026年07月22日 18:30 |
日期與時間會以工作區設定的時區計算(未設定時為日本時間)。
整合服務的屬性變數
若已與 HubSpot、Klaviyo、Shopify 整合,可指定屬性的內部名稱來插入已同步的值。可插入的,僅限在各服務整合設定中選為同步對象的屬性。
| 變數 | 插入的值 |
|---|---|
{{hubspot.屬性的內部名稱}} |
HubSpot 已同步的聯絡人屬性 |
{{klaviyo.屬性的內部名稱}} |
Klaviyo 已同步的個人資料屬性 |
{{shopify.屬性的內部名稱}} |
Shopify 已同步的顧客資料 |
{{屬性的內部名稱}} |
省略服務名稱的寫法(會依 HubSpot → Klaviyo → Shopify 的順序尋找值) |
找不到值時的行為會因寫法而異。
- 含服務名稱(
{{hubspot.~}}等):好友未連結或值未設定時,會替換為空白 - 不含服務名稱(
{{~}}):任何服務都沒有對應屬性時,會原樣保留為文字 - 無論哪種寫法,只要以
or指定替代文字(如{{hubspot.firstname or '貴賓'}}),未連結或未設定時就會帶入替代文字
觸發條件特有的變數
可以用 {{trigger.鍵名}} 的形式,插入各觸發條件特有的資訊。主要的鍵如下。
| 觸發條件 | 可使用的變數 |
|---|---|
| 收到訊息 | {{message.text}}(收到的內文) |
| 收到 Postback | {{postback.data}}、{{trigger.params.date}}、{{trigger.params.datetime}} |
| 掃描 QR 碼 | {{trigger.qrCodeId}}(被掃描的 QR 碼 ID) |
| 影片觀看完成 | {{trigger.trackingId}}(影片的追蹤 ID) |
| 購物車放棄 | {{trigger.checkoutUrl}}(購物車挽回用的網址)、商品資訊 |
| 完成購買 | {{trigger.orderNumber}}(訂單編號)、{{trigger.totalPrice}}(總金額)、商品資訊 |
| 出貨完成 | {{trigger.orderNumber}}(訂單編號)、商品資訊 |
| 補貨通知 | {{trigger.productTitle}}(商品名稱)、商品資訊 |
| 補貨(Amp) | 商品資訊(如 {{trigger.products.0.title}}) |
| 瀏覽提醒 | {{trigger.productTitle}}(商品名稱)、商品資訊 |
| HubSpot屬性更新 | {{trigger.propertyName}}(更新的屬性內部名稱)、{{trigger.propertyValue}}(更新後的值) |
| ID連結 | {{trigger.provider}}(整合服務名稱)、{{trigger.linkKind}}(連結類型)、{{trigger.source}}(連結來源)、{{trigger.externalObjectId}}(外部物件 ID)、{{trigger.qrCodeId}}(QR Code ID)、{{trigger.pageUrl}}(連結頁面 URL) |
加入好友、封鎖觸發條件沒有觸發條件專屬的變數。想插入加好友的來源或頁面時,請使用好友基本資訊的獲取來源變數:{{line.firstSourceType}}、{{line.firstSourceName}}、{{line.firstSourceCategory}} 與 {{line.firstSourcePageUrl}}。
商品資訊的參照
在 Shopify 整合的觸發條件(購物車放棄、完成購買、出貨完成、補貨通知、瀏覽提醒)與 Amp Back in Stock 整合的補貨(Amp)觸發條件中,可以用編號參照對象的商品清單。編號從 0 開始,0 代表第一個商品。
| 變數 | 插入的值 |
|---|---|
{{trigger.products.0.title}} |
第一個商品的商品名稱 |
{{trigger.products.0.price}} |
第一個商品的單價 |
{{trigger.products.0.quantity}} |
第一個商品的數量 |
第二個以後的商品,請像 {{trigger.products.1.title}} 這樣改變編號來參照。若指定編號的商品不存在,會原樣保留為文字。
與群發訊息、自動化訊息的變數的差異
群發訊息與自動化訊息的內文中也能使用變數,但與自動旅程的變數是不同種類。雖然格式同樣是雙大括號,但可用的變數名稱不同。
群發訊息、自動化訊息的內文中可使用的,是好友的個人檔案與整合屬性的變數。
| 變數 | 插入的值 |
|---|---|
{{display_name}} |
好友的顯示名稱 |
{{line_user_id}} |
好友的 LINE 使用者 ID(主要用於網址的查詢參數) |
{{hubspot.內部名稱}}、{{klaviyo.內部名稱}}、{{shopify.內部名稱}}、{{內部名稱}} |
整合服務已同步的屬性 |
需要記住的差異有以下 2 點。
- 顯示名稱的變數名稱不同。自動旅程的動作中是
{{line.displayName}},群發訊息、自動化訊息中則是{{display_name}}(例外是提問動作的問題內文,兩種寫法都可以使用) {{answers.lastAnswer}}、{{trigger.~}}、{{date.~}}等自動旅程變數,在自動化訊息的內文中不會被替換。即使是從自動旅程發送自動化訊息也一樣
群發訊息、自動化訊息的變數,除了文字之外,也能用於 Flex 訊息或卡片式訊息的內文。對於未設定值的好友會顯示「--」,因此請以 or 指定替代文字(如 {{display_name or '貴賓'}}),或使用所有人都有值的屬性。內容饋給篩選條件的「值」也能使用相同的變數,每次發送都會依好友逐一挑選商品。
無法正確替換時
內文中若殘留無法替換的變數,該則訊息不會發送。輸入未登錄的變數名稱時,編輯器也會顯示警告。發送停止或出現警告時,請依以下順序確認。
- 變數名稱的拼寫:請確認是否與清單一致,包含大小寫。括號請使用兩個半形的
{{ }}相疊 - or 語法的寫法:替代文字請以引號包住,並在
or前後加上半形空格(如{{line.displayName or '貴賓'}})。未加引號,或在同一個變數中使用 2 次以上的or時不會被替換 - 輸入的位置:變數只能在對應的輸入欄使用。在條件分支的比較值或自動化訊息的內文中,自動旅程的變數不會被替換
- 與觸發條件的組合:
{{message.text}}需由收到訊息、{{trigger.params.date}}需由點擊日期時間選擇按鈕等,在對應的觸發條件觸發時才會帶入值 - 屬性的同步設定:整合服務的屬性,只有選為同步對象的才能插入。請確認整合設定中的同步屬性
- 好友的連結狀態:若好友未與 HubSpot 聯絡人等進行連結(ID 連結),該服務的屬性會變成空白