n8n Telegram API串接教學:打造你的AI AGENT個人助手

一直聽說n8n,但n8n到底能怎麼互動呢?最快的方法當然是串接到自己常用的社交軟體,像是Telegram或LINE就很常用,本篇就會教你如何串接到Telegram。

如果你想知道怎麼串接到LINE可以觀看:n8n Line API 串接教學

因為串接過程需要在n8n自行建立節點,如果你不想自己建立,可以下載我的免費模板,該模版能讓你每天定期搜集新聞,並將重點新聞傳送到Telegram或LINE給你,並且配上一張符合新聞內容的圖!

一、Telegram API申請:先拿到跟機器人溝通的鑰匙

在我們開始用 n8n 發揮創意之前,得先讓 Telegram 願意跟我們的 n8n「溝通」。這就需要申請一把獨一無二的鑰匙(API Token)和一個專屬的地址(Chat ID)。

本教學將帶你一步步申請 Telegram API 並創建 Bot,適合完全沒有經驗的新手。

前置準備

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

步驟 1:註冊 Telegram 帳戶(如已有帳戶可跳過)

  1. 下載 Telegram 應用程式(手機版或電腦版都可以)各版本連結 (點擊前往)
Telegram桌面應用程式下載頁面
  1. 使用手機號碼註冊帳戶
  2. 完成手機驗證
  3. 設定用戶名稱(可選)

步驟 2:與 BotFather 對話創建 Bot

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

  1. 在 Telegram 中搜尋「@BotFather」(有藍色勾勾的才是官方的喔!)。
在Telegram中搜尋BotFather
  1. 點擊進入與 BotFather 的對話。
  2. 在對話框輸入指令 /newbot 並送出,開始創建新的 Bot。
對BotFather輸入斜線newbot指令
  1. 按照指示為你的 Bot 命名(這個名字會顯示在對話列表,可以隨便取,但別人也會看到)。
為Telegram Bot命名
  1. 設定 Bot 的「用戶名稱」(這是獨一無二的 ID,別人可以透過它搜尋到你的 Bot,而且必須以 bot 結尾,例如 n8n_helper_bot)。
設定Telegram Bot的用戶名稱
  1. 如果名稱被佔用,就換一個試試。發揮你的創意!(注意看機器人說的內容,看不懂英文就翻譯)
BotFather提示用戶名稱已被佔用的訊息
  1. 成功後,BotFather 會給你一段很長的「Token」,這就是你的 API 金鑰!這段程式碼千萬不要外洩,它就等於你 Bot 的密碼。趕快把它複製下來,我們馬上會用到。
BotFather回傳的成功訊息包含API Token

步驟 3:取得你的 Chat ID

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

  1. 點擊上一步 BotFather 給你的 Bot 連結(上圖兩個紅框,上面那一個),開啟和自己 Bot 的對話,然後點擊「開始」。
開啟與自己建立的Telegram Bot的對話視窗
  1. 這時候你的 Bot 沒反應是完全正常的,因為我們還沒教它要說什麼。
點擊開始按鈕後Bot沒有回應
  1. 隨便傳個訊息給它,例如「Hello」。
發送訊息給自己的Telegram Bot
  1. 接著,打開你的瀏覽器,在網址列輸入以下網址,並將 {YOUR_BOT_TOKEN} 換成你剛剛拿到的 API 金鑰:
    https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates
  2. 你會看到一堆像亂碼的文字 (那是 JSON 格式),別怕,仔細找到 "chat":{"id":123456789} 這一串,那個數字 123456789 就是你的 Chat ID!把它也複製下來。(圖裡兩個紅框處的ID都行)
瀏覽器中getUpdates的JSON回傳結果中的Chat ID

恭喜!至此,我們已經擁有跟 Bot 溝通所需的一切:API TokenChat ID

二、n8n串接教學 (如果使用我的模板)

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

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

步驟 1:設定 Telegram Trigger(觸發器)

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

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

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

在n8n的AI知識助手模板中找到Telegram Trigger節點

步驟 2:填入 API 憑證

  1. 填入你從 BotFather 那裡取得的 API Token,按右上角的 Save。如果 API 正確,會顯示綠色提示。
在n8n憑證設定中填入Telegram Bot的API Token

步驟 3:啟用所有 Telegram 節點

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

步驟 4:設定你的 Chat ID

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

步驟 5:測試!

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

三、n8n 串接教學 (不使用模板,從零手動建立)

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

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

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

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

  1. 點擊畫布中央的「+」,在搜尋框中輸入「Telegram」,選擇「Telegram Trigger」節點。這個節點的作用,就是「監聽」你的 Bot 有沒有收到新訊息。
  2. 雙擊打開節點,點擊「Credential」旁邊的「- Create New -」。在n8n的AI知識助手模板中找到Telegram Trigger節點
  3. 在跳出的視窗中,將你從 BotFather 那裡取得的 API Token 貼到「Access Token」欄位裡,然後點擊 Save。在n8n憑證設定中填入Telegram Bot的API Token
  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」開關,啟用你的工作流。為n8n中其他的Telegram節點選擇剛建立好的憑證並啟用工作流
  2. 現在,打開你的 Telegram,傳送任何訊息給你的 Bot。
  3. 如果一切順利,你的 Bot 應該會立刻回傳「Hello, 我是你的第一個手動建立的 AI Agent!」給你!這就代表你已經成功打通了整個流程!

四、如何將它變成你的 AI Agent 個人助手?

剛剛我們做的,只是讓 Bot 變成一個「答錄機」。但 n8n Telegram 串接的威力遠不止於此,這才是你打造 AI Agent 的真正起點。

你可以把 Telegram 當作一個「介面」,而 n8n 就是背後的大腦,你可以串接任何你想要的服務進來。

舉幾個例子,給你一點靈感:

  • 串接 AI 模型: 在 Telegram Trigger 後面,接上一個「OpenAI」或「Google Gemini」節點。把收到的訊息傳給 AI,再把 AI 的回答透過 Telegram 節點傳回給你。一個聰明的聊天機器人就誕生了!
  • 定時任務提醒: 把觸發器換成「Schedule」節點,設定每天早上八點觸發。後面接上一個天氣 API 節點,再把天氣資訊整理後,透過 Telegram 傳給你。你的個人氣象主播就上線了!
  • 自動記帳: 在 Telegram 設定 /cost 晚餐 200 這樣的指令格式。用 n8n 接收後,透過 Code 節點或 Function 節點解析文字,再把「晚餐」和「200」這兩個值寫入 Google Sheets。一個語音記帳本就完成了!

可能性是無限的。n8n 的強大之處在於它擁有數百個節點,你可以像玩樂高一樣,把各種網路服務(Google、Gmail、Notion、資料庫…)全部串在一起,而 Telegram 就是你跟這些複雜系統互動的最簡單窗口。

從今天起,你不再只是一個使用者,你是一個創造者。快去動手試試,打造出你夢想中的那個 AI 個人助手吧!

如果你還不擅長n8n,能跟著我的學習筆記,一步步一起跟著做!

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

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

Q&A常見問題

用 n8n 打造自己的 AI Agent 聽起來很複雜,需要寫程式嗎?

完全不用!這正是 n8n 強大的地方。n8n 是一個「低程式碼(Low-code)」平台,90% 的操作都是用滑鼠拖拉節點、填寫欄位來完成,就像在玩樂高。你只需要依照教學,利用滑鼠點選和設定,就能完成 Telegram 和 LINE 這類訊息軟體的串接,讓它們變成你的 AI Agent 溝通介面——不管是接收訊息、回應聊天、或串接 AI 模型一樣簡單。
但串接Telegram需要先申請API,這篇文章會教你如何申請,並串接到n8n,你還能使用我的免費模板做出自己的n8n Telegram新聞助手。

n8n Telegram API 教學有哪些常見錯誤?如何排除?

常見錯誤有:API Token 輸入錯誤、Chat ID 未正確設置、Telegram Bot 沒有啟用、n8n 節點憑證沒設定好。解決方法:
1.重新檢查 API Token 是否複製完整且無空格
2.Chat ID 取得後正確填入 n8n 節點
3.確認 Telegram Bot 已在 BotFather 正式啟用
4.n8n 的每個 Telegram 節點憑證都要選擇正確
5.暗坑與細節都在本文詳細解析,讓你一次設定就成功

n8n Telegram API 可以做哪些自動化應用?有哪些進階玩法?

n8n 搭配 Telegram API 可用來打造個人 AI 助手、定時通知、語音記帳、自動回覆、串接 OpenAI/Gemini 聊天機器人、甚至自動收集、推送新聞到 Telegram。進階玩法包含:
1.多平台整合(像是 LINE、Discord、Notion 連動)
2.研究內容自動整理推送(AI知識助手模板)
3.新聞編輯室自動推送最新訊息,幫助吸收資訊
4.詳細設定流程與模板在本文都有完整教學,讓你學會一步到位

n8n Telegram API 新手適合怎麼入門?不會寫程式可以玩嗎?

n8n 為低程式碼平台,新手幾乎「不用寫程式」,操作都是拖拉節點與填欄位;你可直接使用本文提供的「免費模板」來快速完成Telegram串接,並跟著圖文教學一步一步設定。
完全沒有程式基礎也能學會,詳細步驟、常見疑問都收錄於本篇,附上新手社群與答疑資源,讓你無痛上手。