觸發器

觸發器是反應所回應的事件。在編輯器的觸發器區塊中,可以同時啟用多個類型:它們以**「OR」**的方式結合——只要任意一個觸發器條件滿足,反應即觸發。額外的限制(標籤、參數、聊天)可在條件中單獨設定。

文字訊息

對文字或媒體說明觸發。在**「搜尋內容」**欄位中選擇模式:

  • 關鍵字 — 詞語/詞組清單。**「匹配方式」參數:包含完全匹配開頭為正規表達式;以及「區分大小寫」**選項。
  • 連結 — 訊息中包含 URL。
  • Email — 包含電子郵件地址。
  • 提及(@username) — 包含提及。
  • 任何文字 — 任何文字訊息。

指令

對 slash 指令觸發。在**「指令(不含 /)」**欄位中列出名稱,例如 helpmenu。機器人會回應 /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

下一步

  • 條件與聊天 — 依受眾和地點縮小觸發範圍。
  • 動作 — 機器人回應時執行的動作。