在自動旅程的動作中,寫成 {{變數名}} 的部分,會在執行時替換成每位好友的實際值。本文將說明可使用的變數清單、可輸入的位置,以及與群發訊息、自動化訊息的變數之間的差異。
變數的運作方式
變數是用半形雙大括號將名稱括起來,直接寫在輸入欄中。沒有專用的插入按鈕,需以手動輸入的方式新增。
例如在訊息內文中如下撰寫,發送時就會替換成好友的顯示名稱。
您好,{{line.displayName}}!
- 括號內前後有無空白皆可運作(
{{ line.displayName }}也可以) - 不支援的變數名稱,或找不到值的變數,原則上會原樣保留為文字(只有 HubSpot 等含服務名稱的屬性變數會變成空白)
- 替換會在自動旅程執行時發生。測試時請以實際的好友確認運作
可使用變數的動作與輸入欄
可使用變數的是以下動作的輸入欄。其他輸入欄不會被替換。
| 動作 | 可使用變數的輸入欄 | 補充 |
|---|---|---|
| 發送訊息 | 訊息內文(文字) | 所有變數皆可使用 |
| 提問 | 問題內文 | 選項的標籤與錯誤訊息中無法使用 |
| 發送 Webhook | 請求內文 | Webhook 網址中無法使用 |
| 設定屬性 | 要設定的值 | |
| 設定 HubSpot 屬性 | 要設定的值 | 日期型屬性也可從 「動作執行時的日期」 「選擇的日期」 等選項設定 |
| 設定 Klaviyo 屬性 | 要設定的值 | |
| 發送 Klaviyo Event | event 名稱 |
以下位置無法使用變數。
- 條件分支的比較值(屬性條件的值無法寫入變數)
- 標籤、延遲、更新圖文選單、AI智慧客服、註冊 HubSpot 自動旅程、加入 Klaviyo List 等各項設定
- 以「自動化訊息」「傳送 LINE 通知訊息」動作所選訊息的內文(自動化訊息的內文中只能使用顯示名稱或整合屬性的變數。若想插入提問的回答或日期,請使用發送訊息動作的文字)
好友基本資訊的變數
好友的 LINE 個人檔案資訊,不論觸發條件的種類為何,隨時都能插入。
| 變數 | 插入的值 |
|---|---|
{{line.userId}} |
好友的 LINE 使用者 ID |
{{line.displayName}} |
好友的顯示名稱 |
{{line.pictureUrl}} |
大頭貼圖片的網址 |
{{line.statusMessage}} |
狀態訊息 |
為了與從舊產品遷移過來的自動旅程相容,{{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.~}}等):好友未連結或值未設定時,會替換為空白 - 不含服務名稱(
{{~}}):任何服務都沒有對應屬性時,會原樣保留為文字
觸發條件特有的變數
可以用 {{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}}(商品名稱)、商品資訊 |
| 瀏覽提醒 | {{trigger.productTitle}}(商品名稱)、商品資訊 |
| HubSpot屬性更新 | {{trigger.propertyName}}(更新的屬性內部名稱)、{{trigger.propertyValue}}(更新後的值) |
加入好友、封鎖觸發條件沒有可用於插入的特有變數。
商品資訊的參照
在 Shopify 整合的觸發條件(購物車放棄、完成購買、出貨完成、補貨通知、瀏覽提醒)中,可以用編號參照對象的商品清單。編號從 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(主要用於網址的查詢參數) |
{{abandoned_checkout_url}} |
購物車挽回用的網址(購物車放棄相關的發送時) |
{{hubspot.內部名稱}}、{{klaviyo.內部名稱}}、{{shopify.內部名稱}}、{{內部名稱}} |
整合服務已同步的屬性 |
需要記住的差異有以下 3 點。
- 顯示名稱的變數名稱不同。自動旅程的動作中是
{{line.displayName}},群發訊息、自動化訊息中則是{{display_name}} {{answers.lastAnswer}}、{{trigger.~}}、{{date.~}}等自動旅程變數,在自動化訊息的內文中不會被替換。即使是從自動旅程發送自動化訊息也一樣- 群發訊息的編輯器有 「插入變數」 按鈕,可從清單選擇後插入。自動化訊息與自動旅程則是手動輸入
群發訊息、自動化訊息的變數,除了文字之外,也能用於 Flex 訊息或卡片式訊息的內文。對於未設定值的好友會顯示「--」,因此請使用所有人都有值的屬性,或撰寫即使未設定也自然的文案。
無法正確替換時
若變數原樣顯示出來,請依以下順序確認。
- 變數名稱的拼寫:請確認是否與清單一致,包含大小寫。括號請使用兩個半形的
{{ }}相疊 - 輸入的位置:變數只能在對應的輸入欄使用。在條件分支的比較值或自動化訊息的內文中,自動旅程的變數不會被替換
- 與觸發條件的組合:
{{message.text}}需由收到訊息、{{trigger.params.date}}需由點擊日期時間選擇按鈕等,在對應的觸發條件觸發時才會帶入值 - 屬性的同步設定:整合服務的屬性,只有選為同步對象的才能插入。請確認整合設定中的同步屬性
- 好友的連結狀態:若好友未與 HubSpot 聯絡人等進行連結(ID 連結),該服務的屬性會變成空白