# Telegram 行內鍵盤建構器 | 免寫 JSON 的 reply_markup

> 不用寫 JSON，就能建立 Telegram 機器人的行內按鈕：視覺化的列與欄、Bot API 的四種類型、callback_data 的位元組計數，以及可用於 cURL、aiogram 或 grammY 的程式碼。免費、不需帳號。

- **來源 (source):** https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215/f/telegram-jiqiren-hangnei-jianpan-jiangoqi
- **平台 (platform):** AiToolsForApps
- **語言 (language):** zh

## 重點摘要

- 不必寫 JSON，就能組出你 Telegram 機器人的行內鍵盤
- 直接在訊息對話氣泡上點選，新增列與按鈕，從 Bot API 的四種類型中選擇，並複製已驗證的 reply_markup。免費、在你的瀏覽器中運作，不需帳號。
- 在看得到的地方編輯：按鈕直接在訊息模型上點選，而不是在另一個表單中。可新增列、在某一列新增按鈕、修改或刪除它，做過頭時還有「復原」。
- Bot API 的四種類型，各有各的規則：url（https
- callback_data 的真實位元組計數：是 64 位元組，而不是 64 個字元。你在輸入時就能看到已用多少，提醒會在傳送前出現，而不是在 400 錯誤之後。

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

這個行內鍵盤建構器是 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 會在不更動結構的前提下，把按鈕文字調整為符合你的語言與領域。

## 包含內容

- 在看得到的地方編輯：按鈕直接在訊息模型上點選，而不是在另一個表單中。可新增列、在某一列新增按鈕、修改或刪除它，做過頭時還有「復原」。
- **Bot API 的四種類型，各有各的規則：url（https** — //、http:// 或 tg://）、callback_data、web_app（僅限 HTTPS）和 switch_inline_query，後者可以留空，用來觸發你機器人的行內搜尋。
- callback_data 的真實位元組計數：是 64 位元組，而不是 64 個字元。你在輸入時就能看到已用多少，提醒會在傳送前出現，而不是在 400 錯誤之後。
- 驗證工具給你的是出錯的路徑，而不是一句「出了點問題」：精確的列與按鈕、沒有文字的按鈕、填到一半的範本目標、格式錯誤的連結或空的 callback，有問題的按鈕還會在模型上以紅色標示。
- 設計層面的提醒，而不只是語法：單列超過八個按鈕（Telegram 會截斷文字）、訊息中超過一百個按鈕，以及重複的按鈕，這幾乎都是複製貼上時的疏漏。
- 五個類別共 29 個現成範本：銷售、社群、內容、客服和 Mini Apps，可看到真實鍵盤的縮圖、待填的空白欄位，並可選擇取代原有鍵盤，或把列加在現有鍵盤下方。
- 在真實的 Telegram 對話氣泡中預覽，提供淺色與深色主題：訊息是依據已用 MarkdownV2 跳脫的文字繪製的，所以預覽是一種驗證，而不是幻覺。
- 組好的程式碼：排好格式的 JSON reply_markup，或是適用於 cURL、python-telegram-bot、aiogram、telegraf 和 grammY 的完整傳送程式碼。帶有 <TU_TOKEN> 和 <CHAT_ID> 佔位符：App 絕不會要求你機器人的 Token，也不會代表你傳送任何東西。

## 常見問題

### 如何在 Telegram 機器人的訊息下方加上按鈕？

貼在訊息下方的按鈕是行內鍵盤（inline keyboard）：它們透過 sendMessage 的 reply_markup 參數傳送，格式為 {"inline_keyboard": [[button, button], [button]]}，其中每個內層陣列就是一列。每個按鈕是一個物件，包含它的 text 和唯一一個動作屬性：url、callback_data、web_app 或 switch_inline_query。在行內鍵盤建構器中，你只要點選訊息模型就能組出這些列，並直接帶走已序列化且驗證過的 reply_markup，或是適用於 cURL、python-telegram-bot、aiogram、telegraf 或 grammY 的完整傳送程式碼片段。

### callback_data 最長可以有多長？為什麼是以位元組計算？

Bot API 把 callback_data 限制為 64 位元組，而不是 64 個字元，因為限制是依該值的 UTF-8 編碼計算。一個 ASCII 字元佔一個位元組，帶重音的母音佔兩個，而表情符號可能佔四個，所以螢幕上看起來很短的資料，也可能超過限制而在傳送時出錯。建構器會在你輸入時顯示真實的位元組計數，一超過就把按鈕標成紅色，並指出具體的列和按鈕。如果你需要的資訊超過容量，一般的做法是在 callback_data 中只存一個簡短的識別碼，其餘交由你的機器人處理。

### 每列最多可以放幾個行內按鈕？總共又是幾個？

Telegram 不會阻止你把一列塞滿，但在放不下時，確實會截斷按鈕的文字，尤其是在手機上。建構器會在同一列達到八個按鈕時提醒你，並在訊息的按鈕總數超過一百個時也提醒，因為從那時起，鍵盤在手機螢幕上就完全無法使用。實用的原則是：帶有描述性文字的按鈕，每列一到兩個；只有非常短的標籤，才放三到四個。在真實的 Telegram 對話氣泡中預覽（提供淺色與深色主題），讓你在傳送任何內容之前先確認。

### 使用建構器需要機器人的 Token，或是註冊嗎？

兩者都不需要。建構器、reply_markup 驗證工具、預覽和程式碼片段都完全在你的瀏覽器中計算：你可以不建立帳號、免費使用。App 也絕不會要求你機器人的 Token，或代表你傳送訊息：你複製的程式碼帶有 <TU_TOKEN> 和 <CHAT_ID> 佔位符，由你在自己的環境中填入。只有兩件事需要免費帳號：儲存帶有鍵盤的訊息以便日後重複使用，以及請 AI 把範本的按鈕文字調整為符合你頻道的主題。

### 行內按鈕有哪些類型？哪一種適合我？

共有四種，建構器以選擇器的形式提供：連結（url），可開啟網頁、頻道或群組，必須以 https://、http:// 或 tg:// 開頭；callback（callback_data），在按下時把資料傳給你的機器人，只有在你的機器人正在監聽該 callback 時才會有作用；Mini App（web_app），開啟 Telegram Mini App，需要 HTTPS 以及已設定好的機器人；以及行內搜尋（switch_inline_query），讓使用者前往另一個聊天室向你的機器人輸入查詢，並且可以留空。如果你只管理頻道、沒有寫好的機器人，不需要其他支援就能運作的類型是連結：當範本帶有 callback 按鈕時，App 會提醒你。

- [Telegram — 以 AI 製作 Telegram 頻道的貼圖、表情符號與品牌形象](https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215)

## 關於平台

**Telegram — 以 AI 製作 Telegram 頻道的貼圖、表情符號與品牌形象** — 應用程式，來自 AiToolsForApps. 可在以下網址使用: https://tw.aitoolsforapps.com/telegram-stickers-emojis-branding-215/f/telegram-jiqiren-hangnei-jianpan-jiangoqi

### 其他語言

- `es`: https://tw.aitoolsforapps.com/es/aitelegram-stickers-emojis-y-branding-para-telegram-215/f/constructor-de-teclados-inline-para-bots-de-telegram
- `en`: https://tw.aitoolsforapps.com/en/aitelegram-stickers-emojis-and-branding-for-telegram-215/f/inline-keyboard-builder-for-telegram-bots
- `fr`: https://tw.aitoolsforapps.com/fr/aitelegram-stickers-emojis-et-branding-pour-telegram-215/f/constructeur-de-claviers-inline-pour-bots-telegram
- `it`: https://tw.aitoolsforapps.com/it/aitelegram-stickers-emojis-e-branding-per-telegram-215/f/costruttore-di-tastiere-inline-per-bot-di-telegram
- `pt`: https://tw.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215/f/construtor-de-teclados-inline-para-bots-de-telegram
- `de`: https://tw.aitoolsforapps.com/de/aitelegram-stickers-emojis-und-branding-fuer-telegram-215/f/inline-tastenkonstruktor-fuer-telegram-bots
- `bg`: https://tw.aitoolsforapps.com/bg/telegram-sazdavayte-stikeri-i-emodzhita-koito-stickers-priema-215/f/konstruktor-na-inline-klaviaturi-za-botove-v-telegram
- `ja`: https://tw.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-inline-keyboard-builder
- `nl`: https://tw.aitoolsforapps.com/nl/telegram-maak-telegram-stickers-en-emoji-s-die-stickers-accepteert-215/f/inline-toetsenbordbouwer-voor-telegram-bots
- `ko`: https://tw.aitoolsforapps.com/ko/telegram-sticker-emoji-channel-branding-215/f/telegram-bot-inline-keyboard-builder
- `sv`: https://tw.aitoolsforapps.com/sv/telegram-skapa-telegram-stickers-och-emojis-som-stickers-godkanner-215/f/byggare-for-inline-tangentbord-till-telegram-bots
- `da`: https://tw.aitoolsforapps.com/da/telegram-lav-telegram-stickers-og-emojis-som-stickers-accepterer-215/f/bygger-til-inline-tastaturer-til-telegram-bots
- `id`: https://tw.aitoolsforapps.com/id/telegram-buat-stiker-dan-emoji-telegram-yang-diterima-stickers-215/f/pembuat-keyboard-inline-untuk-bot-telegram
- `cs`: https://tw.aitoolsforapps.com/cs/telegram-stickery-a-emoji-pro-telegram-ktere-stickers-prijme-215/f/konstruktor-inline-klavesnic-pro-boty-telegram
- `fi`: https://tw.aitoolsforapps.com/fi/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/inline-nappaimiston-rakentaja-telegram-boteille
- `pl`: https://tw.aitoolsforapps.com/pl/telegram-tworz-stickery-i-emoji-ktore-przyjmie-stickers-215/f/konstruktor-klawiatur-inline-dla-botow-telegram
- `no`: https://tw.aitoolsforapps.com/no/telegram-lag-telegram-stickers-og-emojier-stickers-godtar-215/f/bygger-for-inline-tastatur-til-telegram-botter
- `ar`: https://tw.aitoolsforapps.com/ar/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215/f/telegram-inline-keyboard-builder-for-bots
- `he`: https://tw.aitoolsforapps.com/he/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/boneh-mikladot-inline-le-botim-shel-telegram
