流程設計器指南

了解視覺化流程設計器和所有可用的節點類型。

概述

流程設計器是一個視覺化流程建構工具，讓你可以使用拖放節點為聊天機器人建立對話流程。每個節點代表對話中的特定操作或決策點。你也可以切換到 Copilot 面板，以對話方式讓 AI 幫你建立和修改流程。

流程設計器畫布：左側節點面板與畫布上相連的對話流程節點 — 流程設計器：左側為節點面板，畫布上的節點以連線組成對話流程

開始使用

1. 新增節點

畫布右側的面板可在「節點」與「Copilot」之間切換：

點擊新增： 切換到「節點」面板，點擊任一節點類型即可新增，新節點會以自動排版方式放置在空白處，畫面並會自動導覽至該節點
搜尋節點： 使用面板頂部的搜尋框，輸入關鍵字可同時篩選「現有節點」（點擊即可跳轉查看）與「新增節點」的可用類型
從欄位新增： 在任何「選擇節點」欄位（例如下一步節點）中，可直接點擊「新增節點」建立新節點並自動連接、導覽至該節點，無需切換面板
Copilot 新增： 切換到「Copilot」面板，以對話方式描述需求，AI 會建立節點並自動導覽至該節點

Copilot 面板：以對話方式請 AI 建立文字訊息節點並接到歡迎流程 — Copilot 面板：用一句話描述需求，AI 會自動建立節點並接上流程

2. 編輯節點

開啟設定： 點擊節點開啟右側設定面板
節點名稱： 在「節點名稱」欄位設定節點的顯示名稱，方便識別
必填欄位： 標有紅色星號 * 的欄位為必填，必須填寫才能儲存
變數使用： 在文字欄位中使用 @變數名稱 格式插入變數（前後需要空格）

按鈕列表節點的編輯面板，必填欄位標有紅色星號 — 節點編輯面板：標有紅色 * 的欄位為必填

3. 節點工具列操作

當滑鼠移到節點上時，右側會顯示工具列按鈕：

📋 複製節點： 點擊複製按鈕，會在原節點旁邊建立一個相同的副本（自動位移避免重疊）
# 複製節點 ID： 把節點 ID 複製到剪貼簿，用於網站的 Webchat JavaScript API（Chatbotta.triggerFlow），讓網站從這個節點發起對話
👁️ 切換檢視模式： 在「編輯模式」（顯示所有設定欄位）與「預覽模式」（顯示節點實際運作時的樣子）之間切換
🗑️ 刪除節點： 點擊紅色的刪除按鈕，或在節點被選取時按 Delete / Backspace 鍵

4. 畫布操作

移動畫布： 按住空白處拖曳，或使用觸控板雙指滑動
縮放畫布： 使用滑鼠滾輪、觸控板捏合手勢，或右下角的縮放控制器（+ / - 按鈕）
框選多個節點： 按住 Shift 鍵後在空白處拖曳，可框選範圍內的所有節點
移動節點： 直接拖曳節點到目標位置
復原/重做： Cmd/Ctrl + Z 復原上一步操作，Cmd/Ctrl + Shift + Z 重做

5. 頂部工具列

畫布上方導覽列除了發布相關按鈕，還有幾個實用工具：

測試： 開啟測試聊天室，直接與目前的流程對話進行驗證
變數： 開啟變數列表，統一檢視系統變數，並可新增、編輯常數與變數（設定初始值）
驗證： 自動掃描整個流程，列出警告（例如欄位格式異常並已自動修正）與提示（例如節點目前未連接在流程中），幫助你在發布前找出問題

連接聊天平台

流程設計好之後，要連接到即時通訊平台才會收到顧客的訊息。同一套流程與知識庫可以同時服務所有平台：

LINE 官方帳號貼上 Channel Access Token，Webhook 自動設定

Facebook 與 Instagram 用 Facebook 授權連接粉絲專頁與 Instagram 專業帳號

網站 Webchat 一段程式碼把聊天視窗嵌入你的網站

不同平台支援的訊息類型有差異，例如圖文選單只有 LINE 支援，Messenger 則使用常駐功能表（Persistent Menu）。各節點的平台相容性見節點類型參考。

變數與資料操作

什麼是變數？

變數是用來儲存資料的容器，就像是一個有名字的盒子，可以放入不同類型的資料。在對話流程中，變數可以用來：

儲存使用者輸入的資料（例如：姓名、電話、地址）
保存從 Google Sheets 讀取的資料
進行計算和資料處理
在不同節點之間傳遞資訊

如何使用變數？

建立變數，可以透過以下方式：

要求使用者輸入節點（User Input）： 收集使用者輸入並儲存到變數
變數操作節點（Set Variable）： 手動設定變數的值或進行運算
試算表操作節點（Google Sheets）： 從試算表讀取資料並儲存到變數
提取物件節點（Extract Data）： 從複雜的資料結構中提取特定資料
網站程式碼（Webchat JavaScript API）： 在變數列表中點變數的選單，選擇「開放網頁設定」後，網站可用 Chatbotta.setVariables 寫入這位訪客的值（僅限文字與數字），變數名稱旁會出現地球圖示。詳見 Webchat JavaScript API

使用變數時，在文字欄位中使用 @變數名稱 格式（前後必須有空格）：

資料類型

📝 文字（String）： 任何文字內容，例如「張三」、「hello@example.com」
🔢 數字（Number）： 整數或小數，例如 42、3.14、-10
📅 日期時間（DateTime）： 日期和時間資訊，例如 2024-01-15、14:30:00
📋 列表（List）： 多個項目的集合，例如 [「蘋果」，「香蕉」，「橘子」]
📦 物件（Object）： 結構化的資料，例如 { "name": "張三", "age": 25 }

變數選擇器與運算元類型

在許多節點中，標記為「（變數）」的欄位使用變數選擇器元件，可以選擇現有變數、輸入新變數名稱、輸入固定值，或使用系統變數。可用的運算元類型：

🎯 系統變數： 系統自動提供的特殊變數，例如 @input（使用者輸入）、@timestamp（當前時間）
📌 常數： 預先在變數列表中定義的固定值
💾 變數： 你建立或收集的資料，例如 user_name、order_id
✏️ 字面值： 直接輸入的固定值，例如 100、"歡迎"
🏷️ 具名字面值： 從列表中選擇的預設選項，例如按鈕選項

變數使用範例

📝 場景：收集使用者姓名並打招呼

User Input 節點： 設定「請輸入你的姓名」，將輸入儲存到 user_name 變數
文字訊息節點： 使用變數顯示：你好 @user_name ，很高興認識你！

🧮 場景：計算購物車總價

變數操作節點： 設定 item_price = 150（單價）
User Input 節點： 收集購買數量，儲存到 quantity 變數
變數操作節點： 計算 total_price = item_price × quantity
文字訊息節點： 顯示結果：總金額為 @total_price 元

變數命名最佳實踐

✅ 使用有意義的名稱：user_phone 優於 var1
✅ 使用英文和底線：order_total、user_age，保持全小寫加底線的一致風格
❌ 避免使用空格：user name → user_name
❌ 避免特殊符號：user#1 → user_1

串接第三方平台

Google Sheets 節點

流程設計器提供「試算表操作節點」，讓聊天機器人可以直接讀取或寫入 Google 試算表：

將使用者填寫的表單資料（姓名、電話、訂單等）自動記錄到試算表
從試算表讀取資料，作為選項清單或查詢結果顯示給使用者

連接 Google 帳號

先在「專案設定 → 串接設定 → 第三方應用」完成 Google 帳號授權，並確認試算表已與該帳號共用。
新增試算表操作節點

在畫布右側的「節點」面板中新增節點，選擇要執行的操作（取得內容或新增列表）。
設定試算表與範圍

選擇試算表與工作表；讀取時以 A1 標記法指定範圍（例如 A1:D10），寫入時指定各欄位的變數。

實際應用範例：記錄使用者資料到 Google Sheets

User Input 節點（多個）： 收集使用者資訊：姓名、電話、電子郵件
試算表操作節點： 操作選「新增列表」，欄位依序填入 @user_name、@user_phone、@user_email、@timestamp
文字訊息節點： 確認訊息：感謝你， @user_name ！你的資料已記錄。

延伸整合：MCP 連接器

如果需要串接 Google Sheets 以外的外部系統（例如 GitHub、Notion、訂房系統等），可以在「專案設定」的「Copilot 設定」中新增 MCP（Model Context Protocol）連接器，讓設計 Copilot 使用這些外部工具；若也要讓客服 AI 直接面對真實客戶使用，需另外開啟並勾選允許的工具。詳情請參考儀表板與專案設定。

流程開放為 AI 工具

你畫流程，AI 來用

在設計器裡畫好的流程，可以一鍵開放給客服 AI 當作工具使用。顧客問「我這樣買有沒有折扣」，AI 會帶著顧客說的數字去跑你設計的判斷流程，再用結果回答。商家掌握規則，AI 負責對話，兩者分工，回答才可靠。

一鍵開放： 在流程設定中將該流程標記為「AI 工具」，並填寫工具說明與參數，AI 就知道什麼情況該呼叫它
上線前自動檢查： 工具流程必須通過三項檢查才能開放：不會對顧客發送訊息、一定有回傳值、沒有無限迴圈
參數只用於這一次計算： AI 傳進來的參數僅供本次呼叫使用，不會寫進顧客資料或影響其他對話

如果要讓 AI 操作外部系統（預約、Cloudbeds、Google 試算表等），請參考 MCP 連接器。

發布

什麼是發布（Launch）？

發布是將你在流程設計器中設計的視覺化流程部署到實際對話平台的過程。發布後，你的聊天機器人才能在實際對話中使用最新的流程設定。

如何發布

儲存變更

點擊右上角的「儲存」按鈕，確保所有變更都已儲存到草稿。
測試流程

使用測試聊天室驗證流程是否正常運作。
發布更新

點擊「發布」按鈕，系統會自動部署最新版本，通常需要 5–30 秒。
驗證上線

部署完成後，到實際的聊天平台測試確認功能正常。

部署快照：編輯不影響進行中的對話

每次發布都會產生一份不可變的流程快照。顧客的對話永遠跑在已部署的版本上，你在設計器裡的修改不會影響正在進行的服務，可以放心改。

上線前自動檢查： 發布時系統會掃描整個流程，把找不到的節點、走不到的分支、迴圈與欄位錯誤全部列出來；有問題就修好再發布，不會有半成品流到顧客面前
同步通路設定： 發布時會同時同步 LINE 圖文選單與 Meta 常駐功能表，不需要另外到各平台後台操作
版本一致： 正在進行中的對話會在已部署的快照上跑完，新版本只對後續對話生效

常見錯誤與解決方法

節點缺少必填欄位

原因： 某些節點的必填欄位（標記 * 的欄位）沒有填寫。

點擊該節點，檢查右側設定面板中所有標記 * 的欄位
填寫所有必填欄位後，點擊「儲存」

節點沒有連接到任何流程

原因： 節點是孤立的，沒有連接到主要流程。

確認該節點是否需要使用，如不需要可以刪除
將節點連接到其他節點，確保它在流程中可以被執行到

偵測到循環引用

原因： 流程中存在無限循環，會導致機器人無法正常運作。

檢查流程圖，找出形成循環的節點路徑
添加條件節點或使用者輸入節點來中斷循環，確保每個循環都有出口條件

變數名稱錯誤或未定義

原因： 在文字欄位中使用了不存在的變數，或變數格式錯誤。

確認變數名稱拼寫正確，且已在之前的節點中設定
確保變數格式為 @變數名稱，前後要有空格

圖片/影片/音訊 URL 無效

原因： 媒體檔案的 URL 格式錯誤或檔案無法訪問。

確認 URL 是以 https:// 開頭，且可以在瀏覽器中正常開啟
確認檔案格式符合平台要求（圖片：JPG/PNG，影片：MP4，音訊：M4A/MP3），大小通常不超過 10MB

缺少訊息起點節點

原因： 沒有設定訊息起點（Welcome）節點，使用者首次進入時不知道要執行什麼。

新增一個訊息起點節點，並連接到歡迎訊息的第一個節點
每個聊天機器人只能有一個訊息起點節點

Google Sheets 連接失敗

原因： 試算表操作節點無法存取指定的試算表。

確認 Google 帳號授權尚未過期，如已失效請重新連接
確認該 Google 帳號對此試算表擁有編輯權限，且工作表名稱與試算表中的分頁名稱一致

最佳實踐建議

命名規範

使用清晰、描述性的節點名稱，例如「詢問使用者姓名」而不是「節點1」。

頻繁測試

每完成一個功能模組就用測試聊天室立即測試，及早發現問題。

定期儲存

養成隨時儲存的習慣，避免意外丟失編輯內容。

發布前驗證

使用頂部工具列的「驗證」功能掃描整個流程，再按下發布。

節點類型參考

包含 25 種節點類型的詳細說明，與設計器面板分組一致：

訊息節點：4 種
列表節點：4 種
邏輯節點：4 種
動作節點：7 種
第三方節點：1 種
功能設定：5 種

每個節點都有完整的欄位說明、使用範例和注意事項。

完整節點類型參考訊息、列表、邏輯、動作、第三方與功能設定節點的欄位說明