Telegram Bot API 申請教學 2026：BotFather 拿 Token、查 Chat ID 一次搞定

Telegram Bot API 可以免費使用，只要有 Telegram 帳號，找官方的 BotFather 建立機器人就能拿到 Token，再傳一則訊息給 Bot 就能查出 Chat ID。Token 是機器人的密碼，Chat ID 是訊息的送達地址。整個流程不用寫程式，我實際跑一遍大約十分鐘。

Telegram Bot API 能做什麼、要不要錢、有什麼限制

Bot API 讓機器人幫你收訊息、回訊息、傳通知。同類的情境都能套用，像是每天定時推播天氣與新聞、系統出錯時通知你、讓 AI 在手機上回答問題。下面是我查過 Telegram 官方 Bots FAQ 與 Bot API 文件 的整理，查證日期是 2026 年 11 月。

項目	官方說法
費用	機器人預設可以免費傳訊息給使用者
單一聊天室	建議每秒不要超過 1 則訊息，短時間爆量可能可以，持續超過會收到 429 錯誤
群組	每分鐘不要超過 20 則訊息
大量廣播	免費狀態下約每秒 30 則；開啟付費廣播後可到每秒 1000 則，超出免費額度的訊息每則 0.1 Stars，且需要 Bot 有至少 10 萬 Stars 餘額與 10 萬月活躍使用者
Token 期限	官方文件沒有寫期限；外洩或遺失時用 BotFather 的 /token 重新產生
接收訊息方式	長輪詢（getUpdates）與 Webhook 只能擇一，設了 Webhook 就不能用 getUpdates
未讀訊息保留	Bot 沒取走的訊息最多保留 24 小時

個人通知與 AI 助手的用量，離付費門檻差很遠。

Telegram Bot API 申請步驟

在開始之前，先把兩個東西講清楚。API Token 是你家 Bot 的鑰匙，Chat ID 是訊息要送去的地址。這一段的操作只需要 Telegram，不需要 n8n。

前置準備

1. 擁有 Telegram 帳戶
2. 能夠使用 Telegram 手機或電腦版本

步驟 1：註冊 Telegram 帳戶（如已有帳戶可跳過）

1. 下載 Telegram 應用程式（手機版或電腦版都可以）各版本連結 (點擊前往)

2. 使用手機號碼註冊帳戶
3. 完成手機驗證
4. 設定用戶名稱（可選）

步驟 2：與 BotFather 對話創建 Bot

BotFather 是 Telegram 官方用來管理所有 Bot 的機器人，把它想像成 Bot 的「戶政事務所」就對了。

1. 在 Telegram 中搜尋「@BotFather」（有藍色勾勾的才是官方的喔！）。

2. 點擊進入與 BotFather 的對話。
3. 在對話框輸入指令 /newbot 並送出，開始創建新的 Bot。

4. 按照指示為你的 Bot 命名（這個名字會顯示在對話列表，可以隨便取，但別人也會看到）。

5. 設定 Bot 的「用戶名稱」（這是獨一無二的 ID，別人可以透過它搜尋到你的 Bot，而且必須以 bot 結尾，例如 n8n_helper_bot）。

6. 如果名稱被佔用，就換一個試試。發揮你的創意！(注意看機器人說的內容，看不懂英文就翻譯)

7. 成功後，BotFather 會給你一段很長的「Token」，這就是你的 API 金鑰！這段程式碼千萬不要外洩，它就等於你 Bot 的密碼。趕快把它複製下來，我們馬上會用到。

步驟 3：取得你的 Chat ID

如果說 API Token 是你家 Bot 的鑰匙，那 Chat ID 就是你家的地址。n8n 需要知道要把訊息傳到「哪裡」，這個「哪裡」就是 Chat ID。

1. 點擊上一步 BotFather 給你的 Bot 連結(上圖兩個紅框，上面那一個)，開啟和自己 Bot 的對話，然後點擊「開始」。

2. 這時候你的 Bot 沒反應是完全正常的，因為我們還沒教它要說什麼。

3. 隨便傳個訊息給它，例如「Hello」。

4. 接著，打開你的瀏覽器，在網址列輸入以下網址，並將 {YOUR_BOT_TOKEN} 換成你剛剛拿到的 API 金鑰：
   https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates
5. 你會看到一堆像亂碼的文字 (那是 JSON 格式)，別怕，仔細找到 "chat":{"id":123456789} 這一串，那個數字 123456789 就是你的 Chat ID！把它也複製下來。(圖裡兩個紅框處的ID都行)
6. 注意！如果你只得到 {"ok":true,"result":[]}，但沒看到其他內容，就傳訊息給你的TG機器人，然後再輸入上面那串 https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates，就能正常獲得。 那串實際應該會長 https://api.telegram.org/bot865465657315:AAGn64565465461lXMtPr-N_a6987999b54Qo/getUpdates，類似這樣，別保留 {}。

恭喜！至此，我們已經擁有跟 Bot 溝通所需的一切：API Token 和 Chat ID。

拿到 Token 之後要注意的事

Token 只放在自己的設定檔或工具的憑證欄位裡，不要貼到公開的文章、截圖或聊天室。如果不小心外洩，到 BotFather 用 /token 指令重新產生，舊的 Token 就會失效。

常見錯誤與排查

狀況	原因與處理
getUpdates 回傳 {"ok":true,"result":[]}	還沒傳訊息給 Bot，或訊息已超過 24 小時。先傳一則「Hello」，再重新整理網址
getUpdates 一直沒資料，但 Bot 其實有收到訊息	Bot 設定了 Webhook（例如 n8n 的 Telegram Trigger 工作流正在啟用）。官方文件寫明設了 Webhook 時 getUpdates 不會運作，要先停用該工作流再查
網址回傳 401 Unauthorized	Token 複製不完整或多了空格，也可能忘了把 {YOUR_BOT_TOKEN} 的大括號拿掉
收到 429 Too Many Requests	發送太快。同一個聊天室每秒不要超過 1 則，群組每分鐘不要超過 20 則，等一下再重送
Bot 沒反應	一開始 Bot 沒反應是正常的，它只是一個帳號，要接上程式、n8n 或 AI Agent 之後才會回話
用戶名稱被佔用	換一個以 bot 結尾的名稱再試

讓 AI Agent 幫你用 Telegram Bot

現在有 AI Agent 了，Telegram Bot 不一定要靠工作流軟體才能用。你可以把 Bot Token 和 Chat ID 交給 AI Agent，請它在做完事情之後傳訊息給你，也可以把 Telegram 當成跟 Agent 聊天的窗口，在手機上交代事情，它做完再回報。

幾個我會拿來用的情境，同類型的需求都能照這個方式延伸：

• 讓 Agent 每天整理新聞或研究資料，用 Telegram 把重點傳給你。
• 長時間任務跑完，請 Agent 傳一則通知，不用一直盯著電腦。
• 系統或網站出問題時，由 Agent 傳訊息提醒你。

金鑰的處理方式很重要。Token 放在 .env 或工具的設定檔，不要直接貼進聊天視窗，不然對話紀錄裡就留下了你的機器人密碼。

如果你還不確定 AI Agent 跟一般聊天機器人差在哪，可以先看 AI Agent 是什麼；想了解 Agent 怎麼接外部工具，看 MCP 與 Claude Code 教學。

在 n8n 裡串接 Telegram Bot

我的 n8n 學員很多，這一段保留完整步驟。拿到 Token 與 Chat ID 之後，可以選用我的模板，或是從零手動建立。

方法一：使用我的模板

串接Telegram需要在n8n裡面新增Telegram節點，而如果你使用我開發的 AI知識助手 ，或是 你的專屬新聞編輯室 的模板，在裡面都已經串接好Telegram做為n8n協作媒介。

如果你沒使用我的模板，可以跳到下一個章節開始觀看。

步驟 1：設定 Telegram Trigger（觸發器）

1. 在 AI知識助手 模板中找到「Telegram Trigger」節點，雙擊點開。點上面的憑證，並選擇紅框處的創建新憑證。
2. 如果是 你的專屬新聞編輯室 模板，則找到Telegram節點並做一樣的操作。

AI知識助手模板能讓你將想要研究的文章、影片、圖片、錄音…等內容，通過Telegram交給AI研究，並讓AI返回重點的同時記錄到Notion資料庫，有需要可以參考這個超級個體包。

組合包內總共五個模板，有這篇文章提到的 AI知識助手 和 你的專屬新聞編輯室 ，購買後怎麼使用都有教學，並且能在專屬群組裡發問，新手問題也歡迎。

步驟 2：填入 API 憑證

1. 填入你從 BotFather 那裡取得的 API Token，按右上角的 Save。如果 API 正確，會顯示綠色提示。

步驟 3：啟用所有 Telegram 節點

1. 模板內其他的 Telegram 相關節點（例如用來傳送訊息的節點）也都需要雙擊打開，將「Credential」選為你剛剛建立好的憑證。(如果是 你的專屬新聞編輯室 模板，也是一樣)。
2. 確認所有相關節點都設定好憑證後，點擊右上角的開關，將 Active 狀態切換為 on，啟用整個工作流。

步驟 4：設定你的 Chat ID

1. 此步驟使用 你的專屬新聞編輯室 模板才需要做，僅使用 AI知識助手 可以跳過。
2. 在 n8n 的內建資料表 (Data tables) 中，新建一個名為「社群金鑰」的資料表（如果已經有了就不用重複建立）。
3. 新增一行，欄位的值都需要跟圖片相同，並在 value 欄位的值裡，填上你先前取得的 Chat ID。這個步驟是為了讓模板知道要把訊息傳給誰。

步驟 5：測試！

1. 現在，對你的 Telegram Bot 傳送訊息，如果設定都正確，你應該就能正常收到 AI知識助手 模板回傳的研究內容了！
2. 若是 你的專屬新聞編輯室 模板，這時也能順利收到新聞才對。

方法二：從零手動建立

如果你不習慣使用別人的模板，想要從一張白紙開始，完全掌控自己的工作流，那這一段就是為你準備的。這個過程能讓你更深刻地理解 n8n 與 Telegram 之間的溝通原理。

步驟 1: 建立一個新的 n8n 工作流

在你的 n8n 主畫布，點擊右上角的「+ Add workflow」，建立一個全新的空白工作流。 [此處應有圖片：n8n的空白工作流畫面]

步驟 2: 設定 Telegram Trigger (讓 n8n 聽到你的聲音)

1. 點擊畫布中央的「+」，在搜尋框中輸入「Telegram」，選擇「Telegram Trigger」節點。這個節點的作用，就是「監聽」你的 Bot 有沒有收到新訊息。
2. 雙擊打開節點，點擊「Credential」旁邊的「- Create New -」。
3. 在跳出的視窗中，將你從 BotFather 那裡取得的 API Token 貼到「Access Token」欄位裡，然後點擊 Save。
4. 回到節點設定，下方的「Updates」欄位可以保持預設的 message，代表只要 Bot 收到任何訊息，這個工作流就會被觸發。
5. 關閉節點，點擊右上角的「Test step」，n8n 會進入等待模式。這時，回到你的 Telegram Bot，隨便傳個訊息給它。如果成功，你會在 n8n 裡看到觸發的資料，這代表 n8n 已經成功收到了你的訊息。

步驟 3: 設定 Telegram Send Message (讓你的 Bot 開口說話)

1. 在「Telegram Trigger」節點右邊的「+」號上，再次搜尋「Telegram」，這次請選擇紫色的「Telegram」節點（它負責傳送訊息）。
2. 雙擊打開節點，在「Credential」欄位選擇剛剛建立好的憑證。
3. 最重要的步驟來了：在「Chat ID」欄位，填入我們在第一部分取得的那個數字 ID。這是在告訴 n8n，要把訊息回傳給誰。
4. 在「Text」欄位，你可以先簡單輸入「Hello, 我是你的第一個手動建立的 AI Agent!」。
5. 關閉節點。

步驟 4: 啟用並測試你的第一個自動化流程

1. 點擊 n8n 畫面右上角的「Active」開關，啟用你的工作流。
2. 現在，打開你的 Telegram，傳送任何訊息給你的 Bot。
3. 如果一切順利，你的 Bot 應該會立刻回傳「Hello, 我是你的第一個手動建立的 AI Agent!」給你！這就代表你已經成功打通了整個流程！

n8n 串接之後還能做什麼

Telegram 在這裡是介面，n8n 是背後的大腦，可以接 OpenAI 或 Gemini 節點做聊天機器人，也能用 Schedule 節點定時推送天氣、新聞，或是用 /cost 晚餐 200 這種指令格式配合 Code 節點，把記帳資料寫進 Google Sheets。

如果你還不擅長 n8n，可以跟著我的 n8n AI Agent 學習筆記一步步做。新手我最推薦先找到適合的模板，先用再說，邊用邊學。我開發的模板都有使用教學，也會教需要的 API 該如何申請，可以逛逛我做的免費模板，有需要也可以參考這個超級個體包，不只包含五個具備實戰能力的模板，還能加入專屬群，能發問新手問題。

如果你想用 LINE 當通知管道，可以看 n8n Line API 串接教學；也可以參考 如何打造個人 AI 助理。

若你喜歡這類文章，歡迎追蹤我的FB帳號，觀看我每天更新的開發與學習分享。

Q&A常見問題