Ảnh nền bài viết blog số 9

Đưa chatbot AI của bạn lên Discord

Bạn muốn tạo một bot AI hội thoại thông minh cho máy chủ Discord? Hướng dẫn từng bước này sẽ giúp bạn hoàn thành chỉ trong 10 phút, không cần viết mã!

Xem video


5 bước đơn giản để tạo bot AI

Làm theo các bước sau để có một chatbot AI hoạt động đầy đủ trên máy chủ Discord:

  1. Tạo máy chủ Discord
  2. Tạo ứng dụng Discord
  3. Thêm bot vào máy chủ
  4. Tạo tài khoản Quickchat AI
  5. Tích hợp bot Discord với Quickchat AI

Bot AI sau khi hoàn thành sẽ trông như thế nào?

Sau khi thiết lập, bot sẽ hoạt động trên Discord, sẵn sàng trò chuyện tự nhiên với các thành viên trong máy chủ.

Kết quả cuối cùng: AI hội thoại thông minh


Cách nhanh nhất: kết nối bằng một cú nhấp

Nếu đã có tài khoản Quickchat AI, bạn có thể bỏ qua hoàn toàn Developer Portal. Trong bảng điều khiển, mở External Apps ở thanh bên trái, chọn Discord, rồi nhấp Add to your Discord server dưới mục Connect.

Màn hình kết nối Discord trong Quickchat AI với nút Add to your Discord server Màn hình kết nối một cú nhấp trong External Apps → Discord.

Discord sẽ yêu cầu bạn cấp quyền cho ứng dụng Quickchat AI dùng chung và chọn máy chủ. Nhấp Authorize là bot hoạt động, sẵn sàng để thành viên @mention trong các kênh. Yêu cầu duy nhất là bạn có quyền Manage Server trên máy chủ đã chọn.

Người mới đăng ký Quickchat AI sẽ thấy quy trình thiết lập dành riêng cho Discord, đưa họ thẳng vào các bước kết nối này.

Màn hình hướng dẫn ban đầu dành cho Discord hiển thị với người mới đăng ký Quickchat AI Người dùng mới bắt đầu từ màn hình dành riêng cho Discord rồi chuyển sang kết nối một cú nhấp.

Các bước dưới đây là phương án thủ công qua Use your own Discord app: bạn tạo ứng dụng Discord riêng và kết nối bằng token bot. Chọn cách này khi muốn tùy chỉnh tên và ảnh đại diện, dùng tin nhắn riêng, Discord AI Actions hoặc nhiều bot trên cùng một máy chủ. Discord Actions cần kết nối bot riêng vì kết nối đó cung cấp token cho các yêu cầu Discord API.


1. Tạo máy chủ Discord

Nếu chưa có tài khoản Discord, hãy tạo tại discord.com. Sau đó thiết lập máy chủ đầu tiên:

Tạo máy chủ đầu tiên


2. Tạo ứng dụng Discord

Truy cập Discord Developer Portal và tạo ứng dụng mới.

Tạo ứng dụng mới


3. Thêm bot vào máy chủ Discord

Đừng quên bật công tắc dưới đây để bot có thể nhận nội dung tin nhắn:

Bật quyền nhận nội dung tin nhắn

Sau khi tạo bot, bạn cần thêm bot vào máy chủ. Cách thực hiện là ghép URL Discord rồi dán vào trình duyệt:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

Con số quyền truy cập đến từ đâu?

Con số quyền truy cập (309237713920) tương ứng với các quyền sau:

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

Đây là bộ quyền tối thiểu để bot hoạt động đúng. Bạn có thể kiểm tra bằng cách vào discord.com/developers/applications, chọn ứng dụng, nhấp Bot bên trái rồi cuộn xuống:

Các quyền của bot Discord

Tìm YOUR CLIENT ID ở đâu?

Cách dễ nhất là nhìn vào thanh địa chỉ của trình duyệt và sao chép dãy số dài trong URL:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

Client ID của bạn

Trong ví dụ này, client ID là 1234567890123456789, nên URL đầy đủ cần mở để thêm bot vào máy chủ là:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

Nếu có vấn đề ở bước này:

  • “Integration requires code grant”: ứng dụng đang bật Require OAuth2 Code Grant. Mở ứng dụng trong Developer Portal, vào Bot, tắt tùy chọn này, lưu rồi mở lại URL mời. (chi tiết)
  • Xuất hiện màn hình bánh hoặc “baked”: đây là trang thành công của Discord, bot đã được thêm. Kiểm tra tại Server Settings → Integrations → Bots and Apps.
  • Mẹo: sau khi dán token bot vào bảng điều khiển Quickchat AI ở bước 5, trang tích hợp Discord sẽ tạo URL mời và hiển thị danh sách kiểm tra thiết lập, nên bạn có thể bỏ qua việc ghép URL thủ công ở trên.

4. Tạo tài khoản Quickchat AI

Đăng ký Quickchat AI để bot có AI hội thoại tự nhiên như con người.

Quickchat AI cho phép bạn tạo AI Agent với cơ sở tri thức riêng, AI Actions và nhiều tính năng khác, phù hợp cho bot Discord, website và các kênh khác.


5. Tích hợp bot với Quickchat AI

Để kết nối bot với Quickchat AI, lấy Discord Bot Token từ Developer Portal.

  1. Vào Bot SettingsReset TokenCopy Token.

Đặt lại token

  1. Trong bảng điều khiển Quickchat AI, mở External Apps → Discord, chọn Use your own Discord app rồi dán token. Quickchat AI sẽ bật bot và thông báo trạng thái trong lúc khởi động.

Dán token

Nếu bot không trực tuyến

Khi bot khởi động không thành công, trang tích hợp Discord hiển thị lỗi cụ thể cùng liên kết trực tiếp đến cách sửa. Hai lỗi thường gặp nhất:

  • Invalid token: token không đúng hoặc đã được tạo lại. Đặt lại token sẽ làm token cũ hết hiệu lực. Mở bot trong Developer Portal, vào Bot → Reset Token, sao chép token mới, rồi nhấp Reconnect trong Quickchat AI và dán vào. Xem ảnh chụp cụ thể tại Invalid bot token.
  • Message Content Intent đang tắt (báo lỗi PrivilegedIntentsRequired): bot đã kết nối nhưng không thể đọc tin nhắn. Mở bot trong Developer Portal, vào Bot → Privileged Gateway Intents, bật Message Content Intent rồi lưu. Xem đúng công tắc tại Message Content Intent.

Bot khởi động lại mỗi khi bạn thay token hoặc cài đặt, vì vậy hãy đợi tối đa khoảng một phút để bot trực tuyến.

Nếu bot riêng trực tuyến nhưng không bao giờ trả lời

Kiểm tra xem bot Quickchat AI dùng chung qua kết nối một cú nhấp còn trong cùng máy chủ hay không. Khi có cả hai bot, bot dùng chung trả lời còn bot riêng im lặng, dù token, intent và quyền đều đúng. Mở External Apps trong bảng điều khiển Quickchat AI, tìm máy chủ dưới Connected servers của thiết lập một cú nhấp rồi xóa khỏi đó. Bot riêng sẽ tiếp quản ngay. Xem Both bots are in the same server.


Bot AI đã hoạt động!

Quay lại Discord, bot sẽ trực tuyến và sẵn sàng trò chuyện. Chỉ cần @mention bot để bắt đầu.

Bot đang hoạt động

Khi được @mention, mặc định bot trả lời trong kênh. Nếu chọn Thread trong cài đặt Reply in, bot tạo một luồng để người dùng tiếp tục hội thoại mà không cần nhắc tên bot nữa.

Hội thoại trong luồng


Cách bot phản hồi

Có nhiều cách gọi bot, mỗi cách xử lý lịch sử hội thoại khác nhau:

Tình huốngCách gọiLịch sử hội thoại
@mention trong kênh@mention bot trong bất kỳ kênh văn bản nàoTùy cài đặt Reply in bên dưới
Tin nhắn trong luồng của botGửi tin nhắn vào luồng do bot tạoGiữ toàn bộ lịch sử luồng
Trả lời tin nhắn botDùng tính năng Reply của Discord với tin nhắn botBắt đầu hội thoại mới mỗi lần
Lệnh gạch chéo /askNhập /ask cùng câu hỏi, chỉ dành cho bot một cú nhấpBắt đầu hội thoại mới mỗi lần
Tin nhắn riêngGửi DM cho bot, chỉ dành cho ứng dụng riêngGiữ xuyên suốt phiên DM

Một tin nhắn thông thường trong kênh không kích hoạt bot. Đây là chủ ý để bot giữ yên lặng trong máy chủ đông người, cũng là lý do phổ biến nhất khiến bot mới thêm có vẻ không hoạt động. /ask cũng là cách sử dụng dễ tìm hơn: nhập / trong bất kỳ kênh nào sẽ thấy lệnh, và nó hoạt động cả khi nội dung tin nhắn bị hạn chế. Lệnh được đăng ký trên bot dùng chung một cú nhấp, nên nếu kết nối ứng dụng riêng, hãy dùng @mention.

Cài đặt “Reply in”

Trong bảng điều khiển Quickchat, dưới Channels > External Apps > Discord, có danh sách “Reply in:” với hai lựa chọn:

  • Channel (mặc định): bot trả lời trực tiếp trong kênh được nhắc đến. Mỗi @mention bắt đầu hội thoại mới, không nhớ tương tác trước đó.
  • Thread: bot tạo luồng mới cho mỗi @mention. Luồng được đặt tên theo bot và người dùng, ví dụ “Aria & john_doe”. Bên trong luồng, bot trả lời mọi tin nhắn mà không cần @mention và giữ toàn bộ lịch sử hội thoại.

Tin nhắn riêng

DM yêu cầu ứng dụng Discord riêng. Bot dùng chung một cú nhấp chỉ trả lời trong máy chủ, vì phản hồi các DM gửi đến bằng một danh tính dùng chung sẽ ảnh hưởng tới tất cả máy chủ nó phục vụ.

Với ứng dụng riêng, không cần @mention trong DM. Bot trả lời mọi tin nhắn và giữ lịch sử xuyên suốt phiên. Khi trả lời DM, bot không truy cập được lịch sử kênh trong máy chủ.

Lưu ý: Bot chỉ phản hồi trong các luồng do chính nó tạo. Nếu ai đó tạo luồng thủ công rồi viết vào đó, bot sẽ không trả lời.


Cách bot hiểu ngữ cảnh của kênh

Khi ai đó @mention bot trong kênh, bot không chỉ thấy riêng tin nhắn có nhắc tên mình. Nó tự động lấy các tin nhắn gần đây và đưa vào prompt của AI dưới dạng bản ghi có dấu thời gian. Nhờ vậy, bot hiểu cuộc thảo luận đang diễn ra và tham chiếu điều mọi người đã nói trước đó.

Ví dụ về ngữ cảnh nhìn từ phía AI:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

Bot cũng đọc tin nhắn trong các luồng đang hoạt động và đã lưu trữ của kênh, nên nội dung thảo luận trong luồng cũng nằm trong ngữ cảnh.

Khi ai đó dùng Reply của Discord để trả lời một tin nhắn cụ thể, bot thu hẹp ngữ cảnh xuống những tin nhắn ngay xung quanh tin nhắn được trả lời thay vì lấy toàn bộ lịch sử gần đây. Điều này cung cấp ngữ cảnh tập trung vào cuộc trao đổi mà người dùng đang nhắc tới.

Nội dung đặc biệt trong tin nhắn, như nhãn dán, GIF, ảnh, nội dung nhúng và phản ứng, được biểu diễn bằng chú thích để bot biết chúng tồn tại dù không nhìn thấy trực quan trong bản ghi ngữ cảnh. Token @mention được thay bằng tên hiển thị dễ đọc.

Không cần cấu hình. Ngữ cảnh kênh được bật mặc định cho mọi bot Quickchat AI trên Discord.

Bot dùng ngữ cảnh kênh để trả lời câu hỏi tiếp theo

Tìm kiếm AI thông minh trên toàn bộ lịch sử máy chủ

Mặc định bot chỉ đọc tin nhắn từ kênh được nhắc tên. Khi bật Smart AI search over server history, AI có thể tìm tin nhắn từ bất kỳ kênh văn bản nào trong máy chủ. AI quyết định xem kênh nào dựa trên câu hỏi của người dùng.

Ví dụ, nếu ai đó hỏi trong #general: “cuộc thảo luận về chuyển đổi hệ thống ở #engineering kết luận thế nào?”, bot có thể đọc lịch sử gần đây của #engineering và trả lời dựa trên thông tin tìm được.

Tính năng này cũng hỗ trợ lọc theo khoảng thời gian và phân trang, để AI xem lịch sử xa hơn khi cần.

Chế độPhạm viPhù hợp với
Mặc địnhChỉ kênh hiện tạiBot cộng đồng đa dụng
Smart AI search over server historyBất kỳ kênh nào trong máy chủBot hỗ trợ, truy xuất kiến thức liên kênh

Lưu ý: Smart AI search over server history hiện ở giai đoạn beta. Nếu quan tâm, hãy liên hệ qua email hoặc máy chủ Discord của Quickchat.

Công tắc Smart AI search over server history trong cài đặt tích hợp Discord


Gửi hình ảnh cho bot

Người dùng có thể đính kèm ảnh khi @mention bot, và AI sẽ xử lý bằng khả năng thị giác. Các định dạng được hỗ trợ gồm PNG, JPG, JPEG, GIF và WebP. Nếu đính kèm nhiều ảnh, bot xử lý ảnh đầu tiên.

URL ảnh từ CDN của Discord được gửi cùng văn bản tin nhắn tới mô hình AI dưới dạng đầu vào đa phương thức, nên AI thấy cả chữ lẫn ảnh trong cùng lượt. Không cần cấu hình vì khả năng hiểu ảnh được bật mặc định.

Một số ví dụ thực tế cho cộng đồng Discord:

  • Cộng đồng lập trình viên: người dùng chụp stack trace hoặc thông báo lỗi rồi nhờ bot giải thích
  • Cộng đồng thiết kế: người dùng chia sẻ mẫu giao diện UI và xin ý kiến bot
  • Cộng đồng trò chơi: người dùng chia sẻ ảnh cài đặt trò chơi và hỏi cách tối ưu
  • Hỗ trợ thương mại điện tử: khách hàng gửi ảnh sản phẩm lỗi cho bot hỗ trợ

Người dùng gửi ảnh chụp màn hình cho bot, bot phân tích ảnh để trả lời câu hỏi


Kết nối AI Actions với Discord

AI Actions cho phép bot gọi API và công cụ bên ngoài trong hội thoại Discord. Bạn cấu hình một lần trong bảng điều khiển Quickchat tại AI Agent > Actions & MCPs, rồi dùng trên mọi kênh như Discord, widget website, WhatsApp, Telegram và các kênh khác.

Có hai loại hành động:

Loại hành độngChức năng
API ActionGửi yêu cầu HTTP như GET, POST, PUT, DELETE tới endpoint bên ngoài, với tham số, header và body có thể cấu hình
Remote MCPKết nối tới máy chủ Model Context Protocol để truy cập công cụ và nguồn dữ liệu bên ngoài

Một số ví dụ bạn có thể xây dựng bằng AI Actions trên Discord:

  • Bot theo dõi đơn hàng: kết nối API Action với backend thương mại điện tử để thành viên hỏi “đơn #12345 của tôi ở đâu?” và nhận trạng thái thời gian thực.
  • Bot GitHub issue: nối Remote MCP với repo GitHub để lập trình viên hỏi ngay trong Discord: “có lỗi nào đang mở mang nhãn critical không?”
  • Bot ticket hỗ trợ: để bot trả lời từ tài liệu và chỉ mở luồng ticket riêng có nhắc vai trò hỗ trợ cho những gì không giải quyết được.
  • Trợ lý kiểm duyệt: chọn mẫu timeout, kick, ban và slowmode để quản trị viên thực hiện bằng ngôn ngữ tự nhiên.
  • Bot đặt lịch họp: kết nối Remote MCP với Cal.com hoặc Google Calendar để người dùng đặt lịch với nhóm qua Discord.
  • Tích hợp CRM: kết nối HubSpot để bot ghi lại khách hàng tiềm năng hoặc tạo ticket hỗ trợ từ hội thoại Discord.
  • Ghi khách hàng tiềm năng và phản hồi: kết nối Google Sheets để bot ghi khách hàng tiềm năng, câu hỏi chưa được trả lời và yêu cầu demo từ Discord thẳng vào bảng tính nhóm đang sử dụng.

Thiết lập API Action

  1. Trong bảng điều khiển Quickchat, vào AI Agent > Actions & MCPs.
  2. Nhấp Add Action. Với thao tác Discord được hỗ trợ, chọn Discord Action rồi chọn mẫu. Mẫu hỗ trợ yêu cầu máy chủ, kênh và vai trò; các mẫu kiểm duyệt cài đặt trực tiếp. Quickchat tạo sẵn yêu cầu, mô tả, tham số, xử lý phản hồi và điều kiện chạy, tất cả đều có thể chỉnh sửa.
  3. Chỉ chọn hành động HTTP Request tùy chỉnh khi cần endpoint không có trong thư viện. Đặt tên, chẳng hạn “Kiểm tra trạng thái đơn hàng”, và mô tả để AI biết khi nào dùng, ví dụ “Dùng khi người dùng hỏi trạng thái đơn hàng. Hỏi mã đơn hàng trước.”
  4. Đặt phương thức HTTP, chẳng hạn GET, URL endpoint và các tham số cần thiết rồi lưu.

Giờ Agent có thể dùng hành động trên các kênh được hỗ trợ. Actions trong thư viện Discord là HTTP Request Actions thông thường có thể chỉnh sửa, nên hãy xem lại quyền truy cập, đích và tham số sau khi thay đổi. Để tìm hiểu chi tiết, xem hướng dẫn HubSpot AI Actions, hướng dẫn bot kiểm duyệt Discord về timeout, kick, ban, vai trò và slowmode dưới dạng AI Actions, hoặc tài liệu Actions.

Trang Actions & MCPs trong bảng điều khiển Quickchat hiển thị API Action đã cấu hình


Đọc thêm

Các hướng dẫn sau trình bày chi tiết những chủ đề liên quan:


Đăng ký Quickchat AI để bắt đầu tạo AI Agent, hoặc tham gia cộng đồng Discord: discord.gg/KqkHwvPRNH