反應:基礎
設定機器人回應指令、按鈕和其他事件;了解反應的建立、檢查順序及反應之間的跳轉。
本頁內容
反應是一條機器人行為規則,例如「收到 /price 時傳送價目表」,或「完成付款時加上『已付款』標籤並開通權限」。
在反應頁面設定事件、額外條件和動作。機器人從上往下檢查規則,執行第一條符合的反應。因此,針對特定情況的規則通常要排在「任何訊息都回覆」的通用規則之前。
反應由哪些部分組成
以價目表為例,只要選擇 /price 指令並加入價格訊息即可。只有需要限制特定使用者或聊天時,才要設定其他部分。編輯器有四個分頁:
| 分頁 | 決定什麼 | 例子 |
|---|---|---|
| 觸發條件 | 何時執行:文字、指令、媒體、按鈕、事件或排程 | 使用者傳送 /price |
| 聊天範圍 | 在哪裡執行:私訊、群組中對機器人的呼叫或特定聊天;也可按使用者狀態限制 | 只在私訊中執行 |
| 條件 | 還要檢查什麼:標籤、參數、時間或訊息數 | 使用者有「已付款」標籤 |
| 動作 | 要做什麼:傳訊、變更標籤、記錄資料或呼叫 AI | 傳送價目表 |
建立與編輯
按建立反應或開啟現有反應。編輯器頂部有必填的名稱、編號 #N、描述及啟用開關。左側可選「觸發條件/聊天範圍/條件/動作」,中間填寫設定,右側可預覽 Telegram 訊息中的區塊、按鈕和選單。完成後按儲存。
已儲存反應的編輯器還會顯示執行次數、圖表和最近事件。
變更記錄與還原
在已儲存的反應中開啟變更記錄,可查看最近 20 次修改的時間、作者、修改來源及「修改前/修改後」的差異。你可以先檢查差異,再確認還原至所選修改之前的狀態。
還原會取代尚未儲存的修改,且本身也會記錄在歷史中。它只還原反應設定,不會撤回已發出的訊息或已修改的資料。如果其他人在你查看差異後又修改了反應,請重新載入差異。詳見步驟說明與練習。
順序與優先級
在手動排序、沒有搜尋、篩選器和所選資料夾時,可拖曳清單中的反應。順序決定優先級:每次事件只會執行第一條符合的反應,然後停止檢查。若要繼續檢查並執行後續符合的反應,請加入下一個反應(goto_next)動作。
搜尋、篩選與分組
清單上方可按名稱或編號搜尋,也可以設定:
- 狀態:全部、只顯示啟用或只顯示停用的反應。
- 建立日期起/迄:依你的時區計算,起始和結束日期都包含在內。
- 排序:手動排序(機器人的實際檢查順序)、最新優先或最舊優先。
- 分組:按建立日期的日或月分組。分組只適用於日期排序。若在手動排序下啟用分組,清單會切換至「最新優先」;原本選擇的「最新優先」或「最舊優先」則會保留。選擇手動排序會關閉分組。
篩選會套用到所有反應,可與搜尋及資料夾一起使用;計數器顯示找到的數量。篩選狀態保存在頁面網址,可重新整理、分享連結或用瀏覽器「上一頁」返回。重設篩選器會清除搜尋、篩選、排序和分組,但保留目前資料夾。這些設定只改變清單畫面,不改變機器人實際檢查反應的順序。
啟用與停用
清單列中的開關,或編輯器的啟用開關,可以停用反應而不刪除它。機器人會略過停用的反應。
複製與刪除
清單列有複製和刪除按鈕。複製會建立副本,適合建立設定稍有不同的相似反應。
匯入與匯出
編輯器中的匯出可將反應儲存為 JSON,清單中的匯入可重新載入。可藉此在機器人之間移轉反應,或在平台外保留版本。
群發反應
清單列中的群發按鈕(傳送圖示)可將反應送給機器人的所有活躍訂閱者,也可按標籤縮小受眾。適合公告和通知。詳見群發。
串聯與對話
例如,第一個反應展示商品目錄,按鈕啟動第二個反應展示商品,接著詢問送貨地址。可用以下方式連接反應:
- 連鎖反應(
chain):在執行途中啟動另一個反應。 - 下一個反應(
goto_next):繼續檢查清單中下一條符合的反應。 - 對話步驟:訊息區塊可等待使用者回覆並檢查格式,暫停目前流程。詳見訊息與按鈕。
- 「否則」分支:反應條件不成立時,在「條件」中指定另一個反應。
- 依結果數量選擇下一步(
branch_result):處理搜尋結果為空、單筆、多筆或不完整的情況。 - 依值選擇下一步(
branch_value):例如值為updated時確認申請,值為conflict時請使用者重新讀取狀態。 - 動作結果:對支援此功能的動作,按成功、衝突、找不到記錄或錯誤分別跳到不同反應。詳見分支選擇。
- 呼叫區塊(
call_block):將輸入傳給共用的計算區塊,並在目前反應中取得其已宣告的輸出。詳見區塊庫與版本。
處理資料時,可組合搜尋集合 → 依結果數量選擇下一步 → 按鈕 → 尋找關聯記錄。若清單來自外部服務,可使用處理清單 → 分組與彙總。為每個動作的結果命名,才能在後續動作中選取。新動作實作教學以課程和申請為例,展示兩種流程。
設定時可從先前步驟的資料選取值,無須手動記住路徑。儲存前,在測試資料上檢查目前草稿,比較分支與預期訊息。儲存後,再透過已連接的機器人和頻道走一次真實使用流程,確認實際動作。