Skip to main content

Listen Message Processor

Listen Message Processor 用於等待並接收使用者的訊息輸入。

基本用法​

Listen Message Processor 用於暫停工作流程並等待使用者發送訊息。當工作流程執行到此 processor 時，系統會停止執行並等待使用者輸入，接收到訊息後會將內容儲存到變數中供後續 processor 使用，然後繼續執行下一個 processor。這是建立互動式工作流程的核心 processor，適用於聊天機器人、問答系統等需要與使用者進行對話的場景。

配置參數​

Name​

  • 顯示在畫布上的名稱，用於在工作流程中識別此 processor

Description​

  • 用於補充此 processor 的用途，提升工作流程的可讀性與可維護性

輸出變數​

當 Listen Message Processor 成功接收使用者訊息後，會產生以下變數供後續 processor 使用：

prevMessage​

  • 類型：string
  • 說明：使用者發送的文字訊息內容

prevBlobs​

  • 類型：Blob[]（選填）
  • 說明：如果使用者同時上傳了檔案（圖片、音訊、影片、文件等），相關資訊會儲存在此陣列中

每個 Blob 物件包含以下屬性：

屬性類型說明
blobIdstring檔案的唯一識別碼
fileTypestring檔案類型，可能值：IMAGE、AUDIO、VIDEO、DOCUMENT、BINARY
fileNamestring（選填）原始檔案名稱
sizenumber檔案大小（位元組）
mimestringMIME 內容類型

連接關係​

Success​

當成功接收到使用者訊息時，工作流程會從此連接點繼續執行下一個 processor 。

使用範例​

Echo Bot 回應機制​

在 Push Message processor 中使用 prevMessage 變數：

設定類型：選擇 Expression 編輯器：在 Editor 中輸入：

prevMessage

這樣就能建立一個簡單的 Echo Bot，將使用者輸入的內容原樣回傳。

處理檔案上傳​

在 Router 中判斷是否有檔案上傳：

條件名稱：有檔案 設定類型：選擇 Expression 編輯器：

prevBlobs && prevBlobs.length > 0

注意事項​

  1. 工作流程暫停：當執行到 Listen Message processor 時，工作流程會暫停等待使用者輸入，直到收到訊息才會繼續

  2. 變數覆蓋：每次使用 Listen Message 都會更新 prevMessage 和 prevBlobs 變數

  3. 檔案處理：上傳的檔案會暫存在系統中，可透過 blobId 在後續 processor 中引用