觸發器
觸發器是反應所回應的事件。在編輯器的觸發器區塊中,可以同時啟用多個類型:它們以**「OR」**的方式結合——只要任意一個觸發器條件滿足,反應即觸發。額外的限制(標籤、參數、聊天)可在條件中單獨設定。
文字訊息
對文字或媒體說明觸發。在**「搜尋內容」**欄位中選擇模式:
- 關鍵字 — 詞語/詞組清單。**「匹配方式」參數:包含、完全匹配、開頭為、正規表達式;以及「區分大小寫」**選項。
- 連結 — 訊息中包含 URL。
- Email — 包含電子郵件地址。
- 提及(@username) — 包含提及。
- 任何文字 — 任何文字訊息。
指令
對 slash 指令觸發。在**「指令(不含 /)」**欄位中列出名稱,例如 help、menu。機器人會回應 /help 和 /menu。
指令 /start
專門針對 /start 的觸發器。Payload 欄位可捕捉 deep-link 參數(/start <payload>);留空則匹配任何 /start。這是推薦連結和行銷活動連結的基礎。
Inline 按鈕點擊(callback)
對 inline 按鈕的點擊觸發。「按鈕資料(callback_data)」欄位與「匹配方式」(完全匹配、開頭為、包含、正規表達式)決定要捕捉哪些按鈕。
媒體
對所選類型的附件觸發:照片、影片、影片訊息、文件、音訊、語音、GIF、貼圖、骰子、遊戲、投票、聯絡人、地理位置、地點、相簿。
系統事件
對聊天事件觸發:透過連結加入、被加入聊天、離開聊天、被移出聊天、狀態改變、申請加入、對訊息的反應、反應計數。適合用於歡迎訊息、管理與審核申請。
回覆與轉發
- 回覆(reply)訊息 — 當訊息是對另一條訊息的回覆時觸發。
- 轉發訊息 — 對轉發的訊息觸發。
每第 N 條訊息
對用戶的每第 N 條訊息觸發(**「第幾條訊息」**欄位)。適合定期提示或防刷屏。
排程(日期)
在指定的時間點觸發(日期清單)。排程反應會在時間到達時傳送給活躍訂閱者——請參閱群發。
傳入的 Web 請求(webhook)
對來自外部的 HTTP 請求觸發。設定路徑(完整 URL 由機器人地址和路徑組成)、Secret Token(用於保護)以及方法(POST / GET / PUT / ANY)。請求資料進入執行上下文,可在動作中透過 {{ctx.欄位}} 存取。詳情請參閱Web 請求與 webhook。