反應:基礎
反應是機器人的核心建構單元:一條規則,描述何時觸發、在什麼條件下以及做什麼。機器人是一組有序的反應清單;對每個傳入的事件,平台從上到下逐一遍歷,套用第一個符合條件的反應。此功能區塊在左側選單:反應。
反應的組成
反應有四個部分(編輯器的分頁):
- 觸發器 — 反應所回應的事件:文字、指令、媒體、按鈕點擊、系統事件、排程等。請參閱觸發器。
- 聊天範圍 — 反應的作用範圍:私人對話、向機器人發話的群組、特定聊天;以及依用戶狀態篩選。
- 條件 — 額外篩選器(標籤、參數、時間、訊息數量等)。請參閱條件與聊天。
- 動作 — 觸發後機器人的行為:傳送訊息、設定標籤、寫入集合、呼叫 AI 等。請參閱動作。
建立與編輯
點選建立反應(或開啟現有反應)。編輯器頂部有:名稱(必填)、編號 #N、描述與已啟用開關。左側為 觸發器 / 聊天範圍 / 條件 / 動作的導覽,中間是表單,右側是 Telegram 預覽,顯示帶有區塊、鍵盤和選單的訊息外觀。點選儲存完成儲存。
已儲存的反應,編輯器會顯示統計面板:觸發次數、圖表與最近事件。
順序與優先級
反應清單中可透過拖曳排序——順序決定優先級。對一個事件,第一個符合條件的反應會被觸發,之後遍歷停止。若要繼續遍歷、允許後續符合條件的反應觸發,請新增下一個反應(goto_next)動作。
啟用與停用
清單列中的開關(或編輯器中的已啟用)可啟用或停用反應,而不會刪除它。停用的反應在遍歷中會被跳過。
複製與刪除
清單列中有複製(建立副本)和刪除按鈕。當你需要建立相似但略有不同的反應時,複製功能很方便。
匯入與匯出
反應可匯出為 JSON(編輯器中的匯出按鈕),並重新匯入(清單中的匯入)。這樣可以在機器人之間移轉反應,也可以在平台外保留版本備份。
群發反應
清單列中的群發按鈕(「傳送」圖示)會將此反應傳送給機器人的所有活躍訂閱者——適合公告和通知。可依標籤縮小受眾範圍。詳情請參閱群發。
串聯與對話
多個反應可組合成場景:
- 串聯反應(
chain)——在執行過程中觸發另一個反應的動作。 - 下一個反應(
goto_next)——將控制權傳遞給清單中下一個符合條件的反應。 - 對話步驟——訊息區塊可等待用戶回覆(含格式檢查),讓場景暫停。請參閱訊息與按鈕。
- 「否則」分支——若反應條件未滿足,可觸發另一個反應(在「條件」區塊的欄位中設定)。