# 交談腳本變數 ## 概述 在交談腳本中，除了「即時聊天」管道外，您可以透過外部設定腳本變數來控制交談流程。此外，還有許多預設的交談變數可供使用。這些預設變數可以在交談過程中使用，以個性化和自定義您的回答。 這些預設交談變數可以涵蓋用戶的名稱、客戶名稱等相關資訊。您可以根據這些變數提供更加個人化和即時的回應。同樣地，這些變數也可以在「Webhook 交談腳本」中使用，以進行呼叫傳遞。 透過設定腳本變數和使用預設交談變數，您可以根據需求和情境來定制交談腳本，以提供更好的用戶體驗和解決方案。無論是在即時聊天還是透過 Webhook，這些變數都能助您打造更具個性化和互動性的交談。 {% hint style="warning" %} **⚠️ 變數使用注意事項** 請特別留意，**變數並非在所有情境下都會帶有對應值**，實際是否可用，將取決於使用場景與來源條件： 1. **`contact_*` 相關變數**：需已建立或關聯具名聯絡人（Contact）資料，否則將無法帶入對應值。 2. **`page_*` 相關變數**：僅在使用者透過**即時聊天（Live Chat）進線**時才會產生，用於追蹤來源頁面等資訊。 3. **`contactable_liff_user_id`**：僅在整合 **LINE LIFF** 並由**即時聊天啟動**的情境下才會取得，其他管道或未啟用 LIFF 機制時則不會有值。 {% endhint %} ## 預設變數 | 變數 | 名稱 | 描述 | | --------------------------- | --------------- | -------------------------------------------- | | queue.length | 佇列等待人數 | 當前交談佇列中等待、分派中的總數。 | | page.url | 來自網頁位址 | 即時聊天顧客來自網頁的位址。 | | page.title | 來自網頁標題 | 即時聊天顧客來自網頁的標題。 | | contactable\_user\_id | 進線來源識別碼 | 進線來源對應的識別碼，如 LINE 、 Facebook 訊息 API 驗證用的 ID。 | | contactable\_username | 進線來源用戶姓名 | 進線來源對應的用戶顯示名稱，如 LINE 或 Facebook 個人檔案姓名。 | | contactable\_liff\_user\_id | LIFF 用戶編號 | 若透過即時聊天並整合 LIFF，可透過此變數取得 LIFF 用戶的用戶編號。 | | session\_id.session\_id | 腳本 Session 系統代碼 | 當每一交談進入腳本時，將自動產生唯一代碼用於辨識。 | | contact.id | 客戶系統編號 | 進線來源關聯的客戶系統編號。 | | contact.name | 客戶姓名 | 進線來源關聯的客戶姓名。 | | contact.first\_name | 客戶姓氏 | 進線來源關聯的客戶姓氏。 | | contact.last\_name | 客戶名字 | 進線來源關聯的客戶名字。 | | contact.membership\_no | 客戶會員編號 | 進線來源關聯的客戶會員編號。 | | contact.identity\_no | 客戶身分證字號 | 進線來源關聯的客戶身分證字號。 |