訊息與按鈕

「傳送訊息」動作由區塊組成機器人的回覆,並附上 inline 按鈕、主選單與對話步驟。這是建構器中功能最豐富的動作——變數替換和按鈕的引用參數也在此設定。

訊息區塊

訊息由一系列區塊組成(點擊新增區塊按鈕):

  • 文字 — 含變數替換與按鈕的格式化文字(最多 4096 個字元)。
  • 照片 — 附說明的圖片。
  • 檔案 — 附說明的文件。
  • 延遲 — 下一個區塊前的暫停秒數。
  • AI — 由模型依提示產生的回覆。
  • 反應 — 呼叫另一個反應(可選擇等待其處理完成)。

區塊可拖曳排序。區塊顯示模式為**「依序」「隨機」(用於隨機回覆)。機器人主選單可保持不變**、設定新選單或隱藏

區塊選項

文字與媒體區塊具有以下旗標:置頂靜音禁止轉發模糊處理(劇透)不顯示連結預覽N 秒後自動刪除

Inline 按鈕

在區塊中可設定按鈕(按鈕文字 + 類型):

  • 文字(callback) — 由機器人端處理點擊事件的按鈕。
  • 連結 — 開啟 URL。
  • 網頁應用程式 — 開啟 Telegram Mini App。請參閱 Mini App
  • 呼叫反應 — 點擊時觸發另一個反應。
  • 收款通知 — 標示為「即將推出」。

按鈕樣式 — 一般、藍色(Primary)、綠色(Success)或紅色(Danger)。**「一次性」**旗標會在點擊後銷毀按鈕。

點擊行為

callback 按鈕可設定點擊後的行為:替換按鈕文字替換訊息(以文字或綁定反應的內容)、刪除訊息、略過 answerCallbackQuery。點擊也可以設定標籤設定參數

按鈕中的參數(Carry)

「Carry — 點擊時的資料快照」區塊會在訊息傳送當下,將一組值附加至按鈕。點擊時,這些值會進入執行情境——這樣每個按鈕都攜帶各自的參數(per-invocation),即使按鈕數量很多也不例外。可設定 payload 的有效期限(秒)。這是「選擇商品 → 結帳時針對該商品」等場景的基礎。

動態按鈕

**「從清單產生動態按鈕」**區塊會將 ctx 中的陣列展開為按鈕——每個元素一個按鈕。可設定:ctx 中的清單鍵值、元素別名、每行按鈕數及按鈕範本(支援 {{alias.field}})。這樣可以建立目錄、記錄清單和來自集合資料的選單。詳情請參閱動態按鈕與參數

預期回覆(對話步驟)

文字區塊可以等待使用者回覆——這會將訊息轉換為對話步驟,並暫停場景直到收到回覆。多個連續步驟可組成對話中的問卷或精靈。

預期內容類型

機器人可以等待特定類型的回覆:文字、從選項中選擇(選項按鈕)、照片、影片、影片備註、音訊、文件、語音訊息、位置、聯絡人、日曆或骰子。若使用者傳送的類型不符,該步驟會將回覆視為不適用。

文字驗證

對於文字回覆,可啟用格式驗證:電話號碼、電子郵件、連結、日期、時間或符合公式(正規表達式)。未通過驗證的回覆將被拒絕,機器人會顯示錯誤訊息。

儲存回覆

使用者的回覆可儲存至參數——之後可在變數替換中以 {{param.key}} 的形式存取,也可用於條件判斷。這樣對話步驟就能逐步建立使用者的迷你資料。

錯誤、提醒與逾時

  • 驗證錯誤訊息 — 回覆未通過驗證時顯示的內容。
  • 提醒 — 使用者沉默時傳送的內容。
  • 逾時後取消等待 — 等待多少時間後停止;逾時時可觸發反應(例如溫和地結束問卷)。此反應在連結中顯示為「等待逾時」,而對應回覆的反應則顯示為「預期回覆」。

變數替換

**「變數替換」**按鈕可插入變數:傳送者資料({{first_name}}{{username}}{{user_id}})、事件資料({{text}}{{chat_id}}{{datetime}})及參數({{param.key}})。完整清單與公式請參閱變數替換與公式

後續步驟