訊息與按鈕
組合機器人的回覆:文字、相片、訊息下方的按鈕,以及會儲存答案的提問。
本頁內容
要讓機器人傳送文字、相片及「選擇」按鈕,請加入傳送訊息動作。回覆由多個區塊組成,例如先展示商品相片,再傳送說明和按鈕。訊息下方的按鈕也稱為 inline 按鈕。
同一個動作也能提問並等待答案,例如詢問電話並儲存到客戶資料。下文說明區塊、按鈕和提問設定。
訊息區塊
按新增區塊選擇要傳送的內容。可以組合文字問候、相片和課程文件:
- 文字:最多 4,096 字元的格式化文字,支援變數替換和按鈕。
- 相片:圖片及說明文字。
- 檔案:文件及說明文字。
- 語音:OGG/OPUS、MP3 或 M4A,最多 50 MB;Telegram 以語音訊息顯示(
sendVoice)。 - GIF:動畫或無聲 MP4,最多 50 MB(
sendAnimation)。 - 圓形影片:最長 60 秒的正方形 MP4(
sendVideoNote),不能加說明文字。每次傳送都會重新上傳媒體庫檔案;Telegram 不接受由其他方式取得的file_id供sendVoice、sendAnimation或sendVideoNote使用。 - 輪播:2 到 10 張「相片+說明+各自按鈕」卡片。若每張相片都有適用的
file_id(卡片中設定,或從媒體庫取得),Telegram 會以editMessageMedia在同一則訊息中用「‹ ›」切換。只要有一張缺少適用 ID,全部卡片就會分別傳為相片訊息;VK 等其他頻道亦如此。每張卡片的說明及按鈕會保留。 - 延遲:在下一個區塊前等待指定秒數。
- AI:按提示詞產生模型回覆。
- 反應:呼叫另一條反應,可選擇等待它執行完畢。
語音、GIF、圓形影片與輪播也會納入反應的快速群發。區塊可拖曳排序,並選擇依序或隨機顯示。機器人主選單可維持原樣、設定新選單或隱藏。
區塊選項
文字及媒體區塊可設定置頂、靜音、禁止轉發、劇透遮罩、停用連結預覽,以及N 秒後自動刪除。
Inline 按鈕
每個區塊可設定按鈕的文字與類型:
- 文字:把按鈕文字當作使用者答案送出。Telegram 和 VK 使用回覆鍵盤,可回答問題或按文字啟動反應;WhatsApp、Instagram、Messenger 及網站小工具使用不常駐的回覆按鈕。
- 連結:開啟 URL。
- 網頁應用程式:開啟 Telegram Mini App,詳見 Mini App。
- 呼叫反應:按下後啟動另一條反應。
- Inline 查詢:把「@機器人 查詢」放進目前聊天輸入框,或提示選擇其他聊天(
switch_inline_query/switch_inline_query_current_chat)。只適用於在 @BotFather 用/setinline啟用 inline 模式的 Telegram 機器人。GetMyBot 沒有實作answerInlineQuery,因此按鈕只會預填查詢,不會執行搜尋。 - 預填文字:開啟
https://t.me/<機器人>?text=…,把文字放進聊天輸入框,不會自動傳送(prefill)。 - 付款連結:開啟必要的付款 URL。付款由「建立付款」動作建立;這是外部付款頁面,並非 Telegram 原生帳單。
- 通知:點擊時顯示文字,不啟動反應,也不傳送按鈕儲存的 Carry 資料。Telegram 可顯示最多 200 字元的短通知或彈窗;VK 只顯示最多 90 字元的短提示。
回答文字與預填文字
| 目的 | 按鈕設定 | 點擊後 |
|---|---|---|
| 在問卷選「是」 | 「文字」按鈕,標籤「是」;訊息須等待答案 | 將「是」交給對話步驟 |
| 準備諮詢訊息 | 「預填文字」,標籤「聯絡我們」,內容「我想下單」 | 聊天輸入框出現草稿,使用者自行編輯並傳送 |
按鈕標籤與預填內容是不同欄位。預填文字本身不傳訊,也不啟動反應。「呼叫反應」按鈕的點擊會產生獨立的 callback 事件;Inline 查詢和預填文字只在 Telegram 應用內執行,不產生這個事件,因此不能使用 answerCallbackQuery 或 Carry 資料。
按鈕圖示與顏色
可在按鈕文字前顯示付費表情符號圖示。在圖示欄填入 icon_custom_emoji_id,須為正的 64 位整數;例如 007 會視為 7。字母、零、負數或超出範圍的數字會被忽略,按鈕仍會儲存但沒有圖示。
Telegram 只會向具備權限的機器人顯示圖示:透過 Fragment 取得額外使用者名稱,或擁有者使用 Telegram Premium 並直接傳送到私訊/群組。其餘情況 Telegram 會忽略圖示,不會用一般表情符號取代。
樣式(style)可選無顏色的「一般」、藍色的「主要」、綠色的「成功」或紅色的「危險」。
僅用一次(single_use)表示按鈕儲存的資料只能使用一次,例如確認選擇。點擊後變更標籤或刪除訊息則另外在點擊行為中設定。
按鈕旗標
- 換行:將按鈕放到下一列。
- 佔滿整列:讓按鈕獨佔一列,下一顆按鈕也另起一列。
同一列: [商品目錄] [幫助]
換行: [商品目錄]
[幫助]
佔滿整列: [ 幫助 ]
Telegram 和 VK 支援列布局及顏色,重新開啟編輯器後布局會保留。Telegram 付費表情符號需要相容的機器人連接。沒有「在 Telegram 內開啟」開關:Bot API 不提供對應的控制旗標。
各頻道的限制
可為區塊或按鈕選擇頻道。選擇「所有頻道」時,編輯器只提供各頻道都支援的功能;不能儲存不支援的按鈕類型。
- Telegram:URL、Mini App、反應、通知/彈窗、列布局、顏色及有權使用的自訂表情符號。
- VK:URL、反應、短提示、列布局及顏色;只有選擇相容的 VK 連接時,才有 VK Mini App 和 VK Pay。
- WhatsApp:同一則訊息只能有一顆 URL CTA 按鈕,且不能與其他按鈕混用。回覆按鈕最多 3 顆直接顯示;4 至 10 顆以清單顯示。標籤最多 20 字元。無列布局、顏色、Mini App 或通知。
- Instagram/Messenger:目前只傳送快速回覆按鈕,標籤最多 20 字元;不支援 URL、Mini App、通知、列布局或顏色。
- 網站小工具:支援 URL 和回覆按鈕,無列布局、顏色或通知。
- Email:支援連結,包括付款連結;不支援回覆按鈕和通知。
從清單產生的按鈕,只有在支援列布局的頻道才能指定每列按鈕數;其他頻道自行決定布局。按鈕數量及文字長度上限在傳送時檢查。
點擊後的行為
對會向機器人傳送點擊事件的按鈕,可按頻道能力以文字或另一條反應的內容取代訊息、刪除訊息、新增標籤或儲存參數。修改按鈕本身的文字只支援 Telegram,例如把「報名」改成「已選擇」;VK 雖可編輯訊息,但不支援修改按鈕文字。
Telegram 需要機器人用 answerCallbackQuery 確認點擊。GetMyBot 通常會自動確認並清除按鈕上的載入指示;「略過 answerCallbackQuery」會停用此確認。
「呼叫反應」按鈕的點擊提示文字可顯示簡短確認,例如「已選擇課程」(Telegram 最多 200 字元,VK 最多 90 字元,支援變數替換)。Telegram 通常在聊天上方暫時顯示;顯示為彈窗只適用 Telegram,對應 show_alert。留空時只清除載入指示;若略過 answerCallbackQuery,提示和彈窗都不會傳送。
按鈕資料(Carry)
Carry 讓按鈕記住它對應的項目。例如兩件商品都有「購買」按鈕,外套存 product_id=101,洋裝存 product_id=102;點擊洋裝時,下一條反應中的 {{ctx.product_id}} 就是 102。
編輯器稱為點擊時資料。鍵是資料名稱,值可以是數字、文字或變數替換。機器人會在傳送訊息時儲存各按鈕的資料,點擊時才放進該次反應的暫存情境 ctx。
有效期(ttl_seconds)以秒計算;3600 是一小時,0 使用預設的 30 天。到期後資料不可用;僅用一次(single_use)會在第一次點擊後刪除資料。儲存的價格不會隨商品目錄更新,付款前應按商品 ID 重新查價。詳見動態按鈕與參數。
動態按鈕
商品或課程已在清單中時,可用從清單產生動態按鈕,為每項建立一顆按鈕。設定 ctx 中的清單位置、單項別名、每列按鈕數及文字範本,例如 {{item.name}}。詳見動態按鈕與參數。
文字中的付費表情符號
文字區塊的付費表情符號格式按鈕會插入 <tg-emoji emoji-id="…">🙂</tg-emoji>。支援 Telegram Premium 的收件者會看到自訂表情符號,其他人會看到標籤內的備用符號。HTML 和 Markdown 文字區塊都可使用。表情符號 ID 最多 32 位數,可透過 getCustomEmojiStickers 或把含該符號的訊息轉發給 @idstickerbot 查詢。
機器人連結與預填文字
t.me/<機器人>?start=<參數> 會在 Telegram 執行 /start <參數>,無法只帶參數開啟聊天而不執行 /start。可依目的選擇:
- 不顯示回覆的 /start:為「/start 指令」觸發條件設定啟動連結標記,並讓「傳送訊息」沒有區塊。機器人不會為
/start顯示回覆,但標記已進入事件情境,可供同一反應的條件和其他動作使用。 - 預填文字:
https://t.me/<機器人>?text=<文字>只會把文字放入輸入框,不會傳送,也不會觸發/start;使用者自行傳送。 - Bot API 無法在使用者開啟連結時代替他傳訊。最接近的方式是
?start=深層連結,由機器人的反應傳送所需回覆。
等待回覆(對話步驟)
文字區塊可以等待使用者回覆,使流程暫停。多個步驟可形成聊天中的問卷或操作引導。
預期內容類型
可要求文字、選項按鈕、相片、影片、圓形影片、音訊、文件、語音、位置、聯絡人、日曆或骰子。收到其他類型時,該步驟視為不符合要求。
驗證文字
文字答案可依電話、Email、連結、日期、時間或公式驗證。例如要求電話時,任意文字不會被接受,機器人會顯示錯誤提示。公式驗證使用進階公式:成功回傳空文字,拒絕時回傳錯誤文字。
儲存答案
可把答案儲存為使用者參數,之後以 {{param.鍵}} 插入文字或在條件中使用。對話步驟可以逐步填寫客戶資料。
錯誤、提醒和逾時
- 驗證錯誤訊息:答案不符合要求時顯示。
- 提醒:使用者遲遲未回覆時傳送。
- 等待逾時:指定多久後停止等待,並可啟動另一條反應,例如溫和結束問卷。反應關聯會把這條反應顯示為「等待逾時」,對答案啟動的反應顯示為「等待回覆」。
用指令離開步驟
/cancel 或字面上的俄文 отмена 會解除等待,回覆「已取消。」;若已設定取消反應,則啟動該反應。其他指令預設會被視為一般答案並接受驗證,讓問卷可一直等待有效答案。若啟用「機器人指令(例如 /start)中斷等待」(escape_on_command),任何指令(如問卷中途的 /start)都會無提示地解除等待,然後照常執行該指令。
變數替換
變數替換按鈕可插入傳送者資料({{first_name}}、{{username}}、{{user_id}})、事件資料({{text}}、{{chat_id}}、{{datetime}})和參數({{param.鍵}})。完整清單與公式見變數替換與公式。
機器人選單按鈕
選單按鈕動作可選擇預設選單、指令清單,或含文字和 URL 的 Mini App 按鈕。可只用於目前聊天,或設定為機器人的通用選單,例如只向某位客戶提供專屬 Mini App。可用性取決於頻道。