Tới nội dung chính

Tự động hoá · 9 phút đọc · 2026-11-13

Tạo AI agent Telegram bằng n8n: bot trả lời có trí nhớ

Ba node Telegram Trigger, AI Agent và Telegram đủ để bot trả lời bằng AI và nhớ từng cuộc chat. Bài đi từng bước theo tài liệu chính thức, kèm cách sửa lỗi webhook HTTPS hay gặp.

Để tạo một Telegram AI agent n8n, bạn nối ba node thành một luồng: Telegram Trigger nhận tin người dùng gửi cho bot, AI Agent chuyển câu đó cho model (ChatGPT, Gemini hoặc Claude qua khoá API) để soạn câu trả lời, rồi node Telegram gửi nó về đúng cuộc chat. Gắn thêm Simple Memory thì bot nhớ được vài lượt trước của từng cuộc chat. Chỗ dễ vướng nhất thường không nằm ở phần AI mà ở webhook, vì Telegram chỉ gửi tin tới một địa chỉ HTTPS công khai.

Các bước dưới đây theo tài liệu chính thức của Telegram Bot API và n8n, đọc ngày 13/11/2026. Nếu bạn chưa từng tạo workflow nào, đi qua bài luồng n8n đầu tiên trước.

Cần chuẩn bị gì trước khi bắt đầu

  • n8n đang chạy. Chưa cài thì làm theo bài cài n8n trên Windows. Bản npm hiện tại là 2.47.5 và cần Node.js từ 20.19 đến 24.x.
  • Một địa chỉ HTTPS công khai trỏ tới n8n. Telegram Trigger đăng ký webhook với Telegram, mà Telegram chỉ nhận URL HTTPS ở cổng 443, 80, 88 hoặc 8443. Địa chỉ http://localhost:5678 không dùng được; máy nhà thì xem mục webhook phía dưới.
  • Khoá API của một model: OpenAI, Google Gemini (tạo ở Google AI Studio) hoặc Anthropic.
  • Một tài khoản Telegram để chat với @BotFather và nhắn thử bot.

Tài liệu không ghi thời gian làm, nên mình không đoán con số.

Telegram AI agent n8n chạy theo luồng nào

Khi ai đó nhắn bot, Telegram gửi một bản cập nhật (Update) tới webhook của n8n. Trường message trong đó chứa chat.id là mã cuộc chat và text là nội dung chữ.

AI Agent là node gốc, bên dưới gắn các sub-node: một Chat Model, Simple Memory và tool. Tài liệu n8n ghi "You must connect at least one tool sub-node to an AI Agent node". Muốn hiểu kỹ cách agent chọn tool, hay muốn model chạy trên máy bằng Ollama thay khoá API, xem bài dựng AI agent miễn phí bằng n8n.

Cuối luồng, node Telegram gửi câu trả lời về đúng mã chat, mỗi tin tối đa 4096 ký tự. Phần lớn lỗi của một n8n Telegram bot nằm ở khâu nhận tin chứ không phải khâu gửi.

Cách tạo bot AI trên Telegram: phần @BotFather

  1. Trong Telegram, mở chat với @BotFather và gửi lệnh /newbot. Xong khi BotFather hỏi tên cho bot mới.
  2. Gõ name, tức tên hiển thị trong danh bạ. Tên này đổi lại được bằng /setname.
  3. Gõ username dài 5–32 ký tự, chỉ gồm chữ Latin, số và dấu gạch dưới, bắt buộc kết thúc bằng "bot", ví dụ tetris_bot hoặc TetrisBot. Username không đổi được về sau. Bị từ chối thì thử tên khác.
  4. Chép token BotFather trả về. Token có dạng một dãy số, dấu hai chấm, rồi một chuỗi ký tự. Giữ nó như mật khẩu: ai có token là điều khiển được bot.
  5. Dán địa chỉ dưới đây vào trình duyệt, thay phần YOUR_BOT_TOKEN bằng token vừa chép và giữ nguyên chữ bot đứng ngay trước token.
text
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getMe

Xong khi trình duyệt hiện thông tin của bot vừa tạo. Báo lỗi thì kiểm token có dính dấu cách hoặc thiếu chữ bot phía trước không.

Dựng workflow trong n8n

  1. Tạo credential Telegram với kiểu xác thực "API bot access token", dán token vào ô "Access Token". Credential này dùng chung cho cả node Telegram lẫn Telegram Trigger.
  2. Thêm node Telegram Trigger, chọn credential vừa tạo và chọn sự kiện "Message" (mọi tin mới gửi đến: chữ, ảnh, sticker…).
  3. Thêm node AI Agent nối sau Trigger, ở tham số Prompt chọn "Define below" rồi điền ô "Prompt (User Message)" bằng biểu thức lấy message.text. Lựa chọn "Take from previous node automatically" cần trường chatInput mà tin Telegram không có.
  4. Mở tuỳ chọn "System Message" và viết vài câu định hướng, ví dụ: trả lời bằng tiếng Việt, ngắn gọn, nói thẳng khi không biết.
  5. Bấm "+ Chat Model", chọn OpenAI Chat Model hoặc Google Gemini Chat Model, tạo credential bằng khoá API, rồi chọn một model trong danh sách n8n tự nạp theo tài khoản của bạn.
  6. Nối Simple Memory vào AI Agent, đặt "Session Key" bằng mã chat lấy từ Telegram Trigger và để "Context Window Length" (số lượt trước đưa vào ngữ cảnh) ở mức nhỏ.
  7. Nối một tool vào AI Agent, ví dụ Calculator có sẵn trong danh sách tool. Nếu n8n báo thiếu tool khi chạy, đây là bước bạn đã bỏ sót.
  8. Thêm node Telegram sau AI Agent, chọn Resource = Message, Operation = Send Message; ô Chat ID lấy mã chat từ Telegram Trigger, ô Text lấy câu trả lời của AI Agent.
  9. Trong Additional Fields của node đó, bấm "Add Field", thêm "Append n8n Attribution" rồi tắt đi để bỏ câu "This message was sent automatically with n8n" ở cuối mỗi tin.
  10. Bấm "Execute workflow" rồi nhắn bot một câu trong chat riêng. Xong khi bot đáp lại bằng câu trả lời của AI. Nếu nút cứ kẹt ở trạng thái chờ sự kiện, xem mục lỗi phía dưới.
  11. Thử ổn rồi thì bấm "Publish" để workflow chuyển sang chạy thật.

Biểu thức gợi ý cho các ô

Bốn biểu thức dưới đây suy ra từ cấu trúc Update của Telegram; tài liệu n8n không ghi sẵn chúng. Bạn chạy Trigger một lần, mở kết quả của node rồi kéo đúng trường từ đó.

text
Prompt (User Message):  {{ $json.message.text }}
Chat ID (node Telegram): {{ $('Telegram Trigger').item.json.message.chat.id }}
Text (node Telegram):    {{ $json.output }}
Session Key (Simple Memory): {{ $('Telegram Trigger').item.json.message.chat.id }}

Riêng ô Text, tên trường output mới là phỏng đoán: mở kết quả của node AI Agent, xem câu trả lời nằm ở trường nào rồi kéo đúng trường ấy vào. Session Key theo mã chat giúp mỗi người, mỗi nhóm có bộ nhớ riêng; khoá tĩnh kiểu my_test_session khiến mọi người dùng chung một bộ nhớ, chỉ hợp khi thử.

Simple Memory không phải kho lưu lâu dài và không dùng được khi n8n chạy queue mode cho workflow production. Cần bộ nhớ bền qua lần khởi động lại thì dùng Postgres Chat Memory hoặc Redis Chat Memory.

Sửa lỗi webhook khi n8n chạy ở máy nhà

Lỗi điển hình là "Bad request: bad webhook: An HTTPS URL must be provided for webhook": n8n đang tạo webhook bằng http:// hoặc localhost. Bạn đặt biến N8N_WEBHOOK_URL bằng địa chỉ HTTPS công khai (bản cũ hơn 2.30.0 dùng tên WEBHOOK_URL), thêm N8N_PROXY_HOPS=1 nếu chạy sau reverse proxy, rồi khởi động lại n8n.

bash
export N8N_WEBHOOK_URL=https://n8n.example.com/
export N8N_PROXY_HOPS=1

Trên PowerShell, tương đương là đặt $env:N8N_WEBHOOK_URL="https://n8n.example.com/" rồi chạy n8n start trong cùng cửa sổ.

Ở máy nhà không có tên miền, bạn cần một tunnel. Nhiều bài cũ hướng dẫn n8n start --tunnel, nhưng tài liệu n8n hiện tại không còn lệnh đó; tunnel mà n8n mô tả giờ là công cụ cho người phát triển chạy từ mã nguồn, cần Docker. Để thử, cách gọn hơn là Cloudflare Quick Tunnel, không cần tài khoản hay tên miền (ví dụ của Cloudflare dùng cổng 8080, với n8n đổi thành 5678):

bash
cloudflared tunnel --url http://localhost:5678

Lệnh in ra một địa chỉ đuôi trycloudflare.com. Đặt N8N_WEBHOOK_URL bằng địa chỉ đó, khởi động lại n8n, rồi Unpublish và Publish lại workflow. Cần biết: ai có URL là vào được n8n của bạn; địa chỉ đổi mỗi lần tạo Quick Tunnel mới nên phải đặt lại biến; Cloudflare ghi Quick Tunnel chỉ dành cho thử nghiệm. Chạy lâu dài thì đặt n8n lên máy chủ có tên miền và HTTPS, như bài self-host n8n.

Các lỗi khác và cách lùi

  • Thử bằng Test URL được, Publish xong thì im (hoặc ngược lại): Telegram chỉ giữ một webhook cho mỗi bot, chuyển giữa Test URL và Production URL là ghi đè webhook cũ. Tạm Unpublish khi thử rồi Publish lại, hoặc dùng bot thứ hai để thử.
  • Bấm "Execute step" hay "Execute workflow" mà kẹt ở trạng thái chờ: thường do reverse proxy chưa bật websocket; có khi phải thoát workflow rồi mở lại.
  • AI Agent báo "No prompt specified": Prompt chưa đổi sang "Define below", hoặc chưa tham chiếu dữ liệu của node trước.
  • "400 Invalid value for 'content': expected a string, got null": tin đến không có chữ, ví dụ ảnh hoặc sticker, nên biểu thức Prompt ra rỗng. Đặt một node If trước AI Agent để chỉ tin có text mới đi tiếp.

Muốn biết Telegram đang gửi tin đi đâu và lỗi gì, mở địa chỉ dưới đây; kết quả có url đang đặt, pending_update_count và last_error_message.

text
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getWebhookInfo

Bot AI trên Telegram trong nhóm: vì sao bot im

Mặc định mọi bot thêm vào nhóm chạy ở Privacy Mode: bot chỉ thấy lệnh gọi đích danh nó (kiểu /command@this_bot), tin reply vào tin của bot, tin inline gửi qua bot, và lệnh chung như /start nếu bot là bên gửi tin gần nhất. Trong chat riêng thì bot nhận mọi tin.

Có ba đường: gọi bot bằng lệnh hoặc reply tin của bot; đặt bot làm admin nhóm, vì bot admin luôn nhận mọi tin; hoặc gửi /setprivacy cho @BotFather để tắt privacy mode, rồi xoá bot khỏi nhóm và thêm lại thì thay đổi mới có hiệu lực. Telegram khuyên chỉ tắt khi thật cần. Dù tắt, bot vẫn không thấy tin của bot khác. Trong nhóm, bot cũng không được gửi quá 20 tin mỗi phút.

Giữ an toàn token và tiền API

  • Token bot và khoá API chỉ nằm trong credential của n8n, không dán vào ô Text hay System Message.
  • Một Telegram AI agent n8n để mở thì ai tìm ra username cũng nhắn được, và mỗi tin là một lượt gọi model tính vào khoá API của bạn. Muốn giới hạn người dùng, bật tuỳ chọn "Restrict to User IDs" hoặc "Restrict to Chat IDs" của Telegram Trigger, nhiều mã cách nhau bằng dấu phẩy.
  • Lộ token thì gửi /token cho @BotFather để tạo token mới, rồi dán vào credential Telegram.

Kiểm lại

  • Nhắn bot trong chat riêng, nhận được câu trả lời của AI, không còn dòng chữ của n8n ở cuối.
  • Hỏi tiếp một câu nhắc tới câu trước, bot trả lời đúng ngữ cảnh: Simple Memory đang chạy.
  • Hai người nhắn cùng lúc mà không lẫn ngữ cảnh của nhau: Session Key đã theo mã chat.
  • Trang Executions của n8n có lượt chạy xanh.
  • getWebhookInfo trả về url là địa chỉ HTTPS của bạn và last_error_message không có lỗi mới.

Đạt cả năm điều trên là Telegram AI agent n8n của bạn đã chạy đủ vòng. Muốn làm bot tương tự trên Zalo, xem bài tạo bot Zalo cá nhân. Còn nếu bạn cần một AI agent làm việc ngay trong nhóm chat, Deti là mã nguồn công khai của hstation để bạn đọc và tự dựng.