行內鍵盤建構器

不必寫 JSON,就能組出你 Telegram 機器人的行內鍵盤

直接在訊息對話氣泡上點選,新增列與按鈕,從 Bot API 的四種類型中選擇,並複製已驗證的 reply_markup。免費、在你的瀏覽器中運作,不需帳號。

inline_keyboard 是由列組成的陣列,而每一列又是物件的陣列:多一個逗號、少了 https:// 的網址,或一個 65 位元組的 callback_data,Bot API 就會回你一個 400。

這個行內鍵盤建構器是 App 的「機器人」分頁:左側輸入訊息,下方組出鍵盤,上方則看到 Telegram 對話氣泡,就是你的訂閱者收到時的樣子。沒有另一個表單,也沒有放 JSON 矩陣的文字框:你新增一列,在該列新增按鈕,再直接在模型上點選每個按鈕進行編輯。你看到的,就是即將被序列化的內容。

每個按鈕都有文字(最多 64 個字元),以及 Bot API 支援的四種類型之一:連結(url)、callback(callback_data)、Mini App(web_app)和行內搜尋(switch_inline_query)。類型決定驗證方式:連結必須以 https://、http:// 或 tg:// 開頭,Mini App 需要 HTTPS,而 callback_data 附有真實位元組(而非字元)的計數,因為 Telegram 的 64 上限是以 UTF-8 位元組計算,一個表情符號就會一次吃掉四個。

在交給你任何東西之前,鍵盤會先通過結構描述驗證工具,它不會只說「有錯誤」,而是給出確切的路徑:「第 2 列,第 3 個按鈕:callback_data 有 71 位元組,上限為 64」。它會把沒有文字的按鈕、無效的類型、填到一半的範本目標、格式錯誤的連結,以及空的或過長的 callback 標為錯誤;而 Telegram 雖然接受、但用起來會出問題的情況則標為提醒:單列超過八個按鈕、訊息中超過一百個按鈕,以及重複的按鈕。有問題的按鈕在模型上會顯示紅色邊框,所以你能在原地看到錯誤。

完成之後,你就能帶走:排好格式的 reply_markup JSON,或是已為 cURL、原始 Bot API、python-telegram-bot、aiogram、telegraf 或 grammY 組好的完整訊息,文字由 App 的同一個引擎以 MarkdownV2 跳脫。如果你不想從零開始,還有 29 個鍵盤範本,分成五個類別(銷售、社群、內容、客服和 Mini Apps),可看到真實鍵盤的縮圖:填入空白欄位,選擇取代你現有的鍵盤或加在下方,而如果你輸入頻道的主題,AI 會在不更動結構的前提下,把按鈕文字調整為符合你的語言與領域。

免註冊

直接在這裡試用 行內鍵盤建構器

工具載入中…

免費使用,不需要帳號。如果想儲存結果,之後再註冊即可。

儲存/註冊

行內鍵盤建構器 的優點

Ventaja 1

在看得到的地方編輯:按鈕直接在訊息模型上點選,而不是在另一個表單中。可新增列、在某一列新增按鈕、修改或刪除它,做過頭時還有「復原」。

Bot API 的四種類型,各有各的規則:url(https

//、http:// 或 tg://)、callback_data、web_app(僅限 HTTPS)和 switch_inline_query,後者可以留空,用來觸發你機器人的行內搜尋。

Ventaja 3

callback_data 的真實位元組計數:是 64 位元組,而不是 64 個字元。你在輸入時就能看到已用多少,提醒會在傳送前出現,而不是在 400 錯誤之後。

Ventaja 4

驗證工具給你的是出錯的路徑,而不是一句「出了點問題」:精確的列與按鈕、沒有文字的按鈕、填到一半的範本目標、格式錯誤的連結或空的 callback,有問題的按鈕還會在模型上以紅色標示。

Ventaja 5

設計層面的提醒,而不只是語法:單列超過八個按鈕(Telegram 會截斷文字)、訊息中超過一百個按鈕,以及重複的按鈕,這幾乎都是複製貼上時的疏漏。

Ventaja 6

五個類別共 29 個現成範本:銷售、社群、內容、客服和 Mini Apps,可看到真實鍵盤的縮圖、待填的空白欄位,並可選擇取代原有鍵盤,或把列加在現有鍵盤下方。

Ventaja 7

在真實的 Telegram 對話氣泡中預覽,提供淺色與深色主題:訊息是依據已用 MarkdownV2 跳脫的文字繪製的,所以預覽是一種驗證,而不是幻覺。

Ventaja 8

組好的程式碼:排好格式的 JSON reply_markup,或是適用於 cURL、python-telegram-bot、aiogram、telegraf 和 grammY 的完整傳送程式碼。帶有 <TU_TOKEN> 和 <CHAT_ID> 佔位符:App 絕不會要求你機器人的 Token,也不會代表你傳送任何東西。

組好鍵盤,複製後貼進你的機器人

建構器、驗證工具和程式碼片段都在你的瀏覽器中計算:免註冊、免費用。若想儲存帶有鍵盤的訊息以便日後重複使用,以及使用 AI 調整文字,則需要免費帳號。

在使用人工智能的功能中,回答由人工智能生成,不能替代专业人士的建议。