Telegram

Có hai cách kết nối AI Agent với Telegram:

1. Add to a Telegram group: quy trình một lần nhấn được khuyến nghị. Không cần BotFather hay token bot, hoạt động trong chưa đầy một phút.
2. Use your own bot: quy trình nâng cao, bạn tạo bot bằng BotFather và tự cung cấp token.

Chúng tôi khuyến nghị quy trình một lần nhấn. Bạn có thể chuyển sang bot riêng sau nếu cần tính năng nâng cao.

Nếu gặp khó khăn, xem Khắc phục sự cố & Câu hỏi thường gặp hoặc liên hệ với chúng tôi.

Kiểm tra ví dụ tùy chọn

• So sánh phương thức triển khai. Đối chiếu các kênh, quyền truy cập website và tính năng bạn khai báo với tùy chọn thiết lập Quickchat AI. Công cụ không kiểm tra website hay tài khoản của bạn.

• So sánh số lượt trả lời theo ngân sách credit. Tính số lượt trả lời AI hoàn chỉnh tối đa của từng mô hình được hỗ trợ từ ngân sách credit đã cung cấp. Công cụ không kiểm tra số dư hay điều kiện sử dụng mô hình.

Kết nối Telegram (khuyến nghị)

Trong bảng điều khiển Quickchat AI, mở External Apps ở thanh bên trái, tìm và mở Telegram. Nhấp Add to a Telegram group.

Telegram mở ra và hỏi bạn muốn thêm bot Quickchat AI dùng chung vào nhóm nào. Chọn nhóm rồi xác nhận. Bạn cần quyền thêm thành viên vào nhóm đó.

Xác nhận nhóm trong bảng điều khiển

Quay lại bảng điều khiển, nhóm xuất hiện dưới Waiting for your confirmation. Nhấp Confirm bên cạnh.

Bước này được thiết kế có chủ ý. Lời mời được gửi như một tin nhắn thông thường mà mọi người trong nhóm đều đọc được, nên Quickchat AI không coi riêng lời mời là bằng chứng xác nhận. Trước khi bạn xác nhận, AI Agent hoàn toàn im lặng trong nhóm. Mục này hiển thị người đã thêm bot, giúp bạn nhận ra nhóm không mong đợi và xóa thay vì xác nhận.

Xong! 🎉 AI Agent đã hoạt động trên Telegram. Thành viên bắt đầu trò chuyện bằng cách @nhắc đến bot trong nhóm hoặc trả lời một tin nhắn của bot.

Ghi chú

Bảng điều khiển hiển thị huy hiệu Admin ở các cuộc trò chuyện mà bot là quản trị viên Telegram. Đây là trạng thái, không phải yêu cầu: bot dùng chung trả lời dù có là quản trị viên hay không. Các thao tác kiểm duyệt như tắt tiếng và cấm do Telegram AI Actions thực hiện, yêu cầu bot riêng thay vì bot dùng chung.

Liên kết nhắn tin riêng

Mỗi AI Agent cũng có liên kết riêng để mở cuộc trò chuyện một đối một trên Telegram. Trên trang Telegram, bật Direct message link rồi sao chép liên kết hiện ra. Bất kỳ ai mở liên kết đều có thể nhắn riêng cho Agent; bot trả lời ngay, không cần xác nhận, vì cuộc trò chuyện riêng chỉ có một người và bot.

Liên kết mặc định tắt. Bạn có thể tắt lại bất cứ lúc nào để ngăn cuộc trò chuyện riêng mới.

Quản lý cuộc trò chuyện

Trang Telegram liệt kê mọi cuộc trò chuyện bot dùng chung phục vụ trong Connected chats. Từ đó bạn có thể:

• Chọn Add to another group theo cùng quy trình một lần nhấn, để một AI Agent phục vụ nhiều nhóm.
• Tắt một cuộc trò chuyện để tạm dừng trả lời mà không ngắt kết nối.
• Chọn Disconnect để ngắt kết nối. Bot rời nhóm và ngừng trả lời; bạn có thể thêm lại bất cứ lúc nào.

Một cuộc trò chuyện Telegram chỉ kết nối được với một AI Agent tại một thời điểm. Nếu nhóm đã kết nối với Agent khác, hãy ngắt kết nối ở Agent đó trước hoặc chọn nhóm khác.

Khi nào nên dùng bot riêng

Bot một lần nhấn sử dụng danh tính Quickchat AI dùng chung, phù hợp để triển khai nhanh. Tạo bot riêng (xem bên dưới) khi bạn muốn:

• Tên bot, tên người dùng và ảnh hồ sơ tùy chỉnh
• Telegram AI Actions. Bot dùng chung không cung cấp token dưới dạng System Token {{telegram_bot_token}} mà các Actions này cần, nên phải dùng bot riêng.
• Bot trả lời mọi tin nhắn trong nhóm thay vì chỉ khi được gọi đến

Bot dùng chung và bot riêng có thể hoạt động song song ở các nhóm khác nhau. Đừng đặt cả hai trong cùng một nhóm: đây là hai bot Telegram với kết nối độc lập, nên nếu bot riêng tắt chế độ riêng tư, cả hai sẽ cùng trả lời một tin nhắn.

Dùng bot riêng (Advanced setup)

Tạo bot Telegram

Bot Telegram được tạo qua BotFather, bot chính thức của Telegram để quản lý bot. Tất cả diễn ra trong cuộc trò chuyện Telegram thông thường, không cần đăng ký cổng nhà phát triển.

1. Mở Telegram và bắt đầu trò chuyện với @BotFather (tìm dấu xác minh màu xanh).
2. Gửi /newbot.
3. Chọn tên bot. Đây là tên hiển thị trong cuộc trò chuyện, ví dụ “Acme Support”.
4. Chọn tên người dùng. Tên phải duy nhất và kết thúc bằng bot, ví dụ acme_support_bot.

BotFather trả về token bot, một chuỗi như 5175890488:AAEI8qpz.... Bạn sẽ dán vào Quickchat ở bước tiếp theo, nên hãy giữ cuộc trò chuyện mở.

Chú ý

Bảo vệ token bot như mật khẩu. Bất kỳ ai có token đều có thể điều khiển bot. Nếu bị lộ, gửi /revoke cho BotFather để vô hiệu hóa token cũ và lấy token mới.

Mẹo

Bạn có thể tùy chỉnh bot bất cứ lúc nào qua BotFather: /setdescription, /setabouttext, /setuserpic (ảnh hồ sơ) và /setcommands. Gửi /help để xem danh sách đầy đủ.

Kết nối bot với Quickchat AI

1. Mở ứng dụng Quickchat AI và vào External Apps.
2. Nhấp Telegram.
3. Trong Your own bot, nhấp Connect to Telegram và dán token bot.
4. Bật Enable your own bot.
5. Lưu.

Xong. AI Agent đã hoạt động trên Telegram! 🎉

Dùng thử

Mở bot trong Telegram và gửi /start. AI Agent gửi lời chào rồi trả lời các câu hỏi. Với bot dùng chung, dùng Direct message link; với bot riêng, BotFather cung cấp liên kết t.me/<your_bot_username>.

Mọi cuộc trò chuyện cũng xuất hiện trong Quickchat AI Inbox, nơi bạn có thể đọc toàn bộ nội dung, xem tên Telegram của khách truy cập và tiếp quản từ AI bất cứ lúc nào.

Bot nhân vật và nhập vai

Nhân vật là AI Agent có tính cách riêng. Viết trong Identity: nhân vật là ai, nói chuyện thế nào và không bao giờ nói gì thuộc về Main Prompt và Guidelines.

Bot dùng chung phục vụ một AI Agent cho mỗi cuộc trò chuyện, nên nhóm có nhiều nhân vật cần một bot cho mỗi nhân vật. Với từng nhân vật, tạo bot bằng BotFather, đặt tên và ảnh hồ sơ của nhân vật, rồi kết nối với AI Agent tương ứng trong Your own bot, như phần Dùng bot riêng.

Cách thành viên gọi từng nhân vật phụ thuộc chế độ riêng tư Telegram, được BotFather bật cho mọi bot mới:

• Bật chế độ riêng tư (nên giữ bật trong nhóm nhiều nhân vật): bot chỉ nhận trả lời cho tin nhắn của chính nó và lệnh gửi đích danh cho nó. Thành viên nói chuyện với nhân vật bằng cách trả lời tin nhắn của bot. Để gọi nhân vật, gửi /start@ kèm tên người dùng, ví dụ /start@luna_bot, rồi trả lời lời chào.
• Tắt chế độ riêng tư, hoặc bot là quản trị viên nhóm: bot nhận và trả lời mọi tin nhắn trong nhóm, nên mọi nhân vật sẽ trả lời tất cả.

Telegram không bao giờ cho bot xem tin nhắn của bot khác, nên các nhân vật không trả lời nhau.

Mỗi AI Agent có gói riêng. Gói Free dành cho sử dụng cá nhân, phi thương mại; xem Gói & giới hạn.

Khắc phục sự cố & Câu hỏi thường gặp

Tôi đã thêm bot vào nhóm nhưng không có gì xảy ra.

• Kiểm tra mục Waiting for your confirmation trên trang Telegram rồi nhấp Confirm. AI Agent im lặng trong nhóm cho đến khi bạn xác nhận.
• Trong nhóm, bot dùng chung trả lời khi bạn @nhắc đến nó hoặc trả lời tin nhắn của nó. Bot cố ý bỏ qua trò chuyện thông thường giữa thành viên để không làm gián đoạn.
• Nếu nhóm đã kết nối với AI Agent khác, việc liên kết bị từ chối và không có mục nào xuất hiện. Ngắt kết nối nhóm khỏi Agent đó trước hoặc chọn nhóm khác.

Bot riêng của tôi không trả lời.

• Đảm bảo Enable your own bot đang bật và token bot được dán đúng (không thừa khoảng trắng). Nếu không chắc, dùng /revoke trong BotFather rồi dán token mới.
• Gửi /start cho bot trước. Đây là cách Telegram kích hoạt cuộc trò chuyện.
• Một bot kết nối với một AI Agent. Không dùng cùng token cho nhiều Quickchat AI Agent.

Có thể dán token của bot Quickchat AI dùng chung vào Advanced setup không?

• Không, Quickchat AI sẽ từ chối. Token đó thuộc bot phục vụ mọi khách hàng dùng kết nối một lần nhấn; chấp nhận nó sẽ làm gián đoạn Telegram của họ ngay lập tức. Dùng quy trình một lần nhấn hoặc tạo bot riêng bằng BotFather.

Bot có hoạt động trong nhóm không?

• Có. Bot dùng chung trả lời khi được @nhắc đến hoặc được trả lời. Bot riêng mặc định chạy ở chế độ riêng tư của Telegram, chỉ thấy tin nhắn trả lời cho nó hoặc bắt đầu bằng /. Để bot riêng trả lời mọi tin nhắn trong nhóm, mở BotFather, gửi /setprivacy, chọn bot và Disable, rồi xóa bot khỏi nhóm và thêm lại.

Làm sao đổi lời chào?

• Tin nhắn gửi khi dùng /start là lời chào của AI Agent, được cấu hình trong ứng dụng Quickchat AI. Cập nhật ở đó sẽ áp dụng cho mọi kênh, gồm Telegram.

Có thể kết nối bot hiện có không?

• Được. Mở bot trong BotFather, chạy /token để lấy (hoặc /revoke để đặt lại) token, rồi dán vào tích hợp Telegram. Không cần tạo bot mới.

Bot có xử lý hình ảnh và tệp không?

• AI Agent phân tích ảnh, có thể mô tả và trả lời câu hỏi về nội dung ảnh. Với tệp khác (PDF, tài liệu), Agent được thông báo đã nhận tệp và tên tệp nhưng không đọc nội dung. Xem Hình ảnh & tệp để biết thêm.

Xem video

Play

Cần trợ giúp?

Vẫn gặp khó khăn? Liên hệ qua Discord hoặc trang liên hệ, chúng tôi sẽ giúp đưa bot vào hoạt động.