Bot ticket Discord AI: trả lời trước, rồi chuyển tiếp

Quickchat AI trả lời câu hỏi hỗ trợ trong Discord server của bạn từ chính tài liệu của bạn, và chỉ mở thread ticket riêng tư khi không thể trả lời. Hướng dẫn này xây dựng bot đó từ đầu đến cuối, không cần code, trong khoảng nửa giờ.

Kết quả hoạt động như một agent tuyến đầu tốt. Một member hỏi cách reset API key và nhận các bước thực tế trong kênh. Một member hỏi điều tài liệu không bao phủ, và thay vì đoán, bot nói rõ điều đó, mở một thread riêng tư, đưa member vào thread, ping role hỗ trợ của bạn bằng bản tóm tắt một dòng, và chuyển cuộc trò chuyện cho một người có thể trả lời từ Inbox của bạn.

Chọn nhiệm vụ cho bot Discord của bạn

Cấu hình này trả lời câu hỏi hỗ trợ và chuyển tiếp các khoảng trống trong tài liệu của bạn. Chọn hướng dẫn welcome cho lời chào cố định hoặc hướng dẫn moderation cho lệnh quản trị viên.

Bạn cần hai thứ:

• một Quickchat AI Agent (tạo tài khoản của bạn)
• một Discord server nơi bạn là admin

Từ đăng ký đến bài kiểm thử hỗ trợ đầu tiên

1. Nếu bạn đăng ký bằng email và mật khẩu, mở liên kết xác minh trong email. Trong phần thiết lập, mô tả một Discord support Agent, nhấp Create my AI Agent, và hoàn tất các bước thiết lập, bao gồm chọn gói cho mục đích sử dụng dự kiến của bạn.
2. Thêm tài liệu của bạn trong Knowledge Base. Trong External Apps, mở Discord, sau đó Use your own Discord app, và chọn Advanced setup. Bot dùng chung một nhấp có thể trả lời câu hỏi, nhưng không thể chạy các ticket Actions trong hướng dẫn này.
3. Tạo một kênh ticket và một role hỗ trợ có thể mention trong server kiểm thử của bạn. Trong Actions and MCPs, nhấp Add Action, chọn Discord Action, và cài Open Support Ticket với server, kênh và role đó.
4. Sau khi áp dụng hướng dẫn cho Agent bên dưới, @mention bot của bạn với một câu hỏi tài liệu trả lời được, rồi một câu hỏi tài liệu không trả lời được. Câu đầu tiên nên nhận câu trả lời mà không có ticket; câu thứ hai nên mở một thread riêng tư và thông báo cho role hỗ trợ. Thêm một câu tiếp nối vào cuộc trò chuyện thứ hai và kiểm tra rằng không có ticket trùng lặp nào được mở.

Gói Free dành cho mục đích cá nhân, phi thương mại. Chọn gói trả phí trước khi dùng bot cho doanh nghiệp. Hoàn tất kiểm thử hai nhánh trước khi mời khách hàng.

Các ảnh chụp màn hình bên dưới đến từ một Agent kiểm thử tên Lumen, bot hỗ trợ cho một công ty phân tích sản phẩm hư cấu tên Beacon. Công ty này được tạo ra để ví dụ trung lập, nhưng mọi cuộc trò chuyện, mọi API call và mọi ticket thread hiển thị ở đây đều do một Agent thật tạo ra khi chạy pipeline trả lời thật với một Discord server thật.

Bạn sẽ xây dựng gì

Một quyết định cho mỗi câu hỏi. Ở luồng thành công, không có gì được ghi vào Discord.

Ba AI Actions thực hiện việc chuyển tiếp, và Quickchat AI cài cả ba từ một thẻ gallery:

Knowledge base là gì, và vì sao nó quyết định số lượng ticket?

Nếu bạn chưa từng xây dựng AI Agent, đây là khái niệm đáng dành hai phút.

Knowledge base là tài liệu của riêng bạn, được nạp vào Agent và lập chỉ mục để có thể tìm kiếm trong cuộc trò chuyện. Bạn có thể trỏ Quickchat AI đến URL tài liệu trợ giúp để công cụ scrape các trang, dán bài viết thủ công, hoặc upload file. Khi trả lời, Agent tìm kiếm trong đó và trả lời từ những gì tìm thấy, thay vì từ những gì model nền tình cờ nhớ về thế giới. Nếu bạn bắt đầu từ con số không, cách xây dựng knowledge base cho chatbot trình bày nên viết gì và theo thứ tự nào.

Mọi thứ tài liệu của bạn bao phủ sẽ được trả lời. Mọi thứ không được bao phủ sẽ trở thành ticket.

Đó là toàn bộ đòn bẩy của cấu hình này. Deflection không phải mẹo prompt và không phải năng lực model: đó là mức độ bao phủ của bạn. Nếu bot chuyển tiếp nhiều hơn bạn dự kiến, các ticket đang cho bạn biết những trang bạn chưa viết.

Mang tính minh họa, không phải số đo. Điểm chính là hướng đi: viết tài liệu là việc có đòn bẩy cao nhất bạn có thể làm ở đây.

AI có thật sự trả lời câu hỏi hỗ trợ trong Discord được không?

Với các câu hỏi tài liệu của bạn bao phủ, có, và bằng các bước thật thay vì diễn giải lại. Đây là trường hợp deflection từ server kiểm thử, không chỉnh sửa:

Trả lời trong kênh, từ bài viết trong knowledge base. Không tạo ticket, vì không cần ticket.

Nửa thú vị hơn là điều xảy ra khi câu trả lời không có ở đó. Bot nói rõ:

Thất bại trung thực. Knowledge base của Beacon cố ý bỏ qua enterprise SSO, nên đây là nhánh mở ticket.

Một Agent bịa ra quy trình SSO có vẻ hợp lý còn tệ hơn một Agent mở ticket, vì vậy hành vi này đáng được kiểm thử có chủ đích thay vì hy vọng. Chúng ta quay lại điểm này trong kiểm thử.

Hai cách kết nối Discord, và vì sao ticket cần cách thứ hai

Quickchat AI có hai kết nối Discord, và khác biệt này quan trọng trước khi bạn bắt đầu.

Đối với hàng đợi phản hồi công khai hoạt động với bot dùng chung, xem workflow phản hồi và khoảng trống tài liệu. Các private-ticket Actions bên dưới cần credential của Discord bot riêng của bạn.

One-click là đường nhanh. Trong External Apps, bạn mở Discord, nhấp Add to your Discord server, cấp quyền, và bot Quickchat AI dùng chung hoạt động trong server của bạn trong khoảng một phút. Bot trả lời khi member @mention hoặc dùng /ask, và với nhiều server đó là toàn bộ công việc.

Bạn có thể đặt tên cho bot. Trước khi cấp quyền, có trường Bot name in the new server, được điền sẵn bằng tên Agent của bạn, và mỗi server đã kết nối giữ một ô Bot name in this server riêng để bạn đổi sau. Đây là nickname Discord, nên theo từng server và giới hạn 32 ký tự, và xóa nó sẽ đưa bot về Quickchat AI. Thứ vẫn dùng chung là avatar và @username nền, vì một Discord application đang phục vụ mọi server cài nó.

One-click không có nghĩa là chung chung. Bot mang tên Agent của bạn vào server, và bạn có thể đổi theo từng server sau đó.

Advanced setup đăng ký Discord application của riêng bạn. Bạn tạo bot trong developer portal của Discord và dán token của nó vào Quickchat AI một lần. Mất khoảng mười phút và bạn có avatar, @username, direct messages riêng, nhiều bot trong một server, và thứ hướng dẫn này cần: Discord API Actions.

Lý do nên được nói thẳng thay vì xem như một đặc điểm lạ. Các ticket Actions trong hướng dẫn này gọi Discord API với tư cách bot của bạn, dùng credential mà Quickchat AI chèn vào request khi gửi. Token của bot one-click dùng chung thuộc về bot dùng chung, không thuộc về bạn, nên không khả dụng để Actions của bạn gửi. Nếu bạn mở Discord gallery khi chưa kết nối app riêng, công cụ sẽ nói rõ và vô hiệu hóa các thẻ thay vì để bạn xây dựng thứ không thể chạy.

External Apps là nơi cả hai đường bắt đầu. Advanced setup nằm trong callout ở cuối panel Discord.

Bạn cần gì trước khi bắt đầu

Kết nối Discord app của riêng bạn. Trong External Apps, mở Discord, tìm Use your own Discord app và chọn Advanced setup. Tạo application và bot trong developer portal của Discord, bật Message Content Intent, để Require OAuth2 Code Grant tắt, và dán bot token. Quickchat AI xác thực khi bạn nhập. Hướng dẫn Tạo bot Discord AI trình bày chi tiết phần portal nếu bạn chưa từng làm.

Chỉ cấp cho bot những gì bot hỗ trợ cần. Trên kênh ticket: View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads và Manage Threads. Bot không cần quyền Kick, Ban hoặc Timeout, và cố ý không có các quyền đó trong server kiểm thử. Bot hỗ trợ không có lý do để moderation, và một quyền mà bot không có là một quyền bạn không bao giờ phải suy xét.

Trong Discord, tạo hai thứ mà Actions sẽ trỏ tới. Phần này diễn ra trong client Discord, không phải Quickchat AI, và đây là cấu hình duy nhất bạn làm ở đó:

1. Một kênh để mở ticket. Bất kỳ kênh text nào cũng được. Dùng dấu + cạnh danh sách kênh, hoặc dùng lại kênh bạn có. Trong server kiểm thử đó là #support.
2. Một role để gọi khi ticket mở. Server Settings, sau đó Roles, rồi Create Role. Trong server kiểm thử đó là @support.

Ba nơi, và chỉ một nơi là công khai.

Cả hai thứ này quay lại trong Step 3. Khi bạn cài template ticket, Quickchat AI đọc server của bạn trực tiếp từ Discord và hiển thị ba menu thả xuống, một trong số đó là Role picker liệt kê các role tìm thấy. Bạn chọn role hỗ trợ ở đó thay vì nhập ID ở bất kỳ đâu.

Role picker trong Step 3. Nó đọc danh sách từ Discord, nên role bạn tạo bây giờ sẽ xuất hiện ở đây sau giây lát.

Một chi tiết sẽ gây lỗi nếu bạn bỏ qua: picker đó chỉ liệt kê các role mà Discord báo là mentionable, và bỏ qua @everyone. Nếu role hỗ trợ của bạn chưa được đặt mentionable, nó đơn giản sẽ không xuất hiện trong menu thả xuống, không có giải thích. Bộ lọc này có chủ đích, vì toàn bộ nhiệm vụ của template là ping role đó. Đặt trong lúc tạo role và bạn sẽ không gặp vấn đề:

Server Settings, Roles, chọn role hỗ trợ của bạn, và bật mục này trong Display. Nếu không, role không bao giờ đến được picker.

Bot quyết định trả lời hay mở ticket bằng cách nào?

Hầu hết bot ticket Discord không quyết định gì. Ticket Tool, TicketsBot và các công cụ khác đăng một panel được ghim với nút Create Ticket, hoặc đăng ký slash command. Member nhấp vào, ticket mở, và đội ngũ của bạn đọc nó. Thiết kế đó ổn và hoàn toàn dự đoán được, nhưng có nghĩa là mười người cùng hỏi cách reset API key trong tuần này sẽ tạo ra mười ticket.

Cùng mười câu hỏi. Khác biệt là cuối cùng đội ngũ của bạn phải đọc gì.

Bot trả lời trước đọc tài liệu của bạn trước khi quyết định. Và khi cần chuyển tiếp, việc mở một ticket cần đúng bốn thông tin:

• kênh nào thread sẽ mở trong đó
• server nào là nơi câu hỏi đến từ
• ai đang hỏi, để họ có thể được đưa vào thread
• ticket tên gì, và bản tóm tắt một dòng của vấn đề

Điểm thú vị là bốn thông tin đó đến theo ba cách hoàn toàn khác nhau, và chỉ thông tin cuối cùng được AI viết:

Bạn không bao giờ nhập Discord ID, và model không bao giờ thấy kênh hoặc role của bạn.

Những thứ bạn chọn một lần. Kênh ticket và role hỗ trợ của bạn. Bạn chọn chúng từ menu thả xuống khi cài template, và Quickchat AI đóng chúng vào Action. Model không bao giờ thấy và không thể thay đổi chúng.

Những thứ Discord cung cấp. Với mỗi tin nhắn được chuyển tiếp, tích hợp Discord cho Quickchat AI biết tin nhắn đến từ server nào và ai đang nói, dưới dạng {{metadata_discord_guild_id}} và {{metadata_discord_author_id}}. Bot token của bạn đến theo cùng cách, dưới dạng System Token được chèn khi gửi và bị che ở mọi nơi call được log. Không có phần nào do model nhập, và không phần nào có thể được cung cấp bởi public chat hoặc API message.

Những thứ Agent viết. Chủ đề ticket và bản tóm tắt vấn đề một dòng. Đây là các phán đoán duy nhất trong toàn bộ cấu hình, vì vậy việc tinh chỉnh sau này rất ngắn.

Step 1: Tạo Agent và cấp knowledge base cho nó

Tạo Agent của bạn, sau đó mở Knowledge Base và thêm tài liệu. Dán URL help-docs của bạn và để Quickchat AI scrape, hoặc viết bài trực tiếp. Tạo AI support agent từ tài liệu của bạn trình bày chi tiết đường scrape.

Knowledge base của Beacon: reset API key, dashboard trống, cài tracking snippet, gói và thanh toán, và export dữ liệu.

Tài liệu của Beacon cố ý không bao phủ một thứ: thiết lập enterprise SSO. Khoảng trống đó không phải thiếu sót trong bài hướng dẫn này, mà là điểm chính. Mọi knowledge base hỗ trợ đều có những câu hỏi không trả lời được, và toàn bộ giá trị của bot này là điều nó làm khi gặp một câu như vậy. SSO là câu hỏi đó xuyên suốt hướng dẫn này.

Member truy cập bot riêng của bạn bằng cách @mention bot trong một kênh mà bot có thể thấy. Không có gì cần đăng ký. Lệnh /ask có trên bot Quickchat AI one-click dùng chung.

Step 2: Cho Agent biết khi nào trả lời và khi nào chuyển tiếp

Hướng dẫn của Agent nằm trong AI Main Prompt trên Identity. Dán nội dung này, được điều chỉnh cho công ty của bạn:

Bạn là Lumen, trợ lý hỗ trợ cho Beacon, một công cụ phân tích sản phẩm hosted cho các đội phần mềm. Bạn trả lời câu hỏi của khách hàng trong Discord cộng đồng Beacon.
Trả lời từ Knowledge Base bất cứ khi nào có thể. Giữ câu trả lời ngắn và thực tế, hai hoặc ba câu, và đưa ra các bước cụ thể.
Nếu một câu hỏi không được Knowledge Base bao phủ, đừng đoán và đừng bịa các bước. Hãy nói rõ rằng bạn không có thông tin đó, sau đó mở một support ticket:
1. Gọi open_support_ticket một lần, với ticket_subject ngắn 2 đến 4 từ mô tả vấn đề.
2. Sau đó gọi add_ticket_requester để đưa khách hàng vào thread.
3. Sau đó gọi post_in_ticket với issue_summary một dòng về điều khách hàng đã hỏi.
Sau đó nói với khách hàng rằng ticket của họ đã được mở và đội ngũ sẽ theo dõi trong thread mới.
Không bao giờ hỏi khách hàng Discord ID, channel ID hoặc thread ID. Các giá trị đó được điền sẵn cho bạn.

AI Main Prompt trên Identity. Đây là trường luôn có sẵn, không phải danh sách guidelines riêng.

Hai dòng trong khối đó rất quan trọng. “Đừng đoán và đừng bịa các bước” biến khoảng trống knowledge thành câu trả lời trung thực thay vì câu có vẻ hợp lý. Và việc nêu tên ba Actions theo thứ tự khiến Agent gọi chúng như một chuỗi thay vì chọn một Action.

Thứ tự được mô tả trong prompt, nhưng không chỉ được thực thi ở đó. Đó là nội dung của hai phần tiếp theo.

Step 3: Cài ticket Actions bằng một nhấp

Mở Actions & MCPs, nhấp Add Action, và chọn Discord Action.

Discord Action nằm cùng các gallery một nhấp khác.

Gallery mở ra với các template Discord được nhóm theo nhiệm vụ: Support & Tickets chứa template hướng dẫn này dùng, và Moderation chứa bảy template khác.

Tám thẻ. Open Support Ticket là thẻ duy nhất hỏi bạn thông tin.

Chọn Open Support Ticket và bước cấu hình ngắn sẽ mở. Đây là form duy nhất trong toàn bộ cấu hình:

Ba menu thả xuống, và hộp thoại nói trước nó sắp cài gì.

Danh sách lấy trực tiếp từ Discord, được lọc theo những gì thực sự có thể hoạt động. Channels chỉ là text channels:

Chọn kênh mà ticket nên mở bên dưới. Threads được tạo bên trong kênh đó.

Và roles chỉ là các role có thể mention, loại trừ @everyone:

Đây là bộ lọc ẩn role hỗ trợ mà bạn chưa đặt mentionable.

Ba lựa chọn và form hoàn tất:

Toàn bộ cấu hình. Server, channel, role, và nút duy nhất quan trọng.

Nhấp Install and enable. Quickchat AI viết ba Actions ở backend, trong một transaction, đã active.

Ba thẻ, enabled, với biểu tượng Discord. Không còn gì cần điền.

Có hai điều đáng biết về bảy template moderation khi bạn đang ở đây. Chúng không cần cấu hình, vì chúng lấy server, member, role hoặc channel từ chính Discord request, nên nhấp vào thẻ sẽ cài ngay. Và cài template hai lần cho bạn một bản sao thứ hai có thể sửa, thay vì lỗi, đây là cách hợp lý để tạo biến thể.

Một nhấp đó thật sự đã xây dựng gì?

Điều này đáng hiểu dù bạn không phải nhập, vì mọi thứ bạn có thể muốn thay đổi sau này nằm ở đây.

Ba HTTP Request Actions thông thường. Không có gì đánh dấu chúng là đặc biệt.

Chúng được nối với nhau qua hai tính năng bạn đã có trong editor, và cả hai đều đáng biết tên.

Save to memory lấy một giá trị từ response và lưu trên cuộc trò chuyện. open_support_ticket dùng tính năng này để giữ ID của thread mới: Discord trả về thread object, $.id là ID, và nó được ghi vào memory dưới tên discord_ticket_thread_id. Hai Actions tiếp theo đọc lại giá trị đó trong URL, nên chúng tác động lên thread vừa được tạo thay vì thứ bạn phải đặt tên trước. (Save to memory trong tài liệu.)

Run only when chặn Action theo trạng thái cuộc trò chuyện, và được kiểm tra ở phía Quickchat AI trước khi gửi bất kỳ request nào. (Run only when trong tài liệu.)

Cổng kiểm soát biến ba Actions độc lập thành một chuỗi đáng tin cậy.

Đọc sơ đồ đó theo cả hai hướng, vì nó làm hai việc:

• Các bước tiếp theo yêu cầu thread ID tồn tại, nên Agent không thể gọi đội ngũ của bạn về một thread chưa từng được tạo.
• open_support_ticket yêu cầu thread ID không tồn tại, nên Agent không thể mở ticket thứ hai trong cùng cuộc trò chuyện, bất kể cuộc trò chuyện nói gì. Đây là bảo đảm, không phải hướng dẫn: nếu member gửi thêm mười tin nhắn bổ sung chi tiết, họ vẫn có một ticket. Trong chế độ trả lời trong kênh, mỗi trao đổi trong kênh là một cuộc trò chuyện riêng, nên câu hỏi thật sự tiếp theo vẫn có thể mở ticket riêng.

Mỗi Action cũng có Response filter, và mục này dễ bị hiểu sai. Response filter là allowlist: nó nêu các path mà Agent được phép thấy, và mọi thứ khác trong response bị loại bỏ trước khi model đọc. (Response filter trong tài liệu.)

Discord trả về hàng tá trường về server của bạn. Agent được cho xem hai trường.

Thread ID mà chuỗi cần được Save to memory bắt ở phía Quickchat AI, nên Agent không bao giờ phải mang theo nó, và không thông tin nào khác về server của bạn đến model. Thu hẹp allowlist thêm và model sẽ thấy ít hơn. Model không bao giờ thấy nhiều hơn những gì bạn liệt kê.

Con người có thể tiếp quản từ AI không?

Có, và đây là nửa mà hầu hết bot ticket bỏ sót. Một ticket không ai đọc chỉ là một thread.

Human Handoff là một Action tích hợp riêng. Bật nó và mô tả trong Handoff Rules khi nào cuộc trò chuyện nên đến người xử lý, ví dụ “khi khách hàng yêu cầu gặp người, hoặc khi Agent không thể trả lời từ knowledge base”. Quickchat AI sau đó đánh dấu cuộc trò chuyện trong Inbox của bạn bằng bản tóm tắt do AI viết, để người nhận đọc một đoạn thay vì toàn bộ thread. Mọi cài đặt handoff đều có hướng dẫn riêng trong tutorial Human Handoff.

Operator làm việc trong Inbox. Member không bao giờ rời Discord.

Gán cuộc trò chuyện cho chính bạn và trả lời trong composer của Inbox. Câu trả lời đó được gửi thẳng lại kênh Discord mà member đang nói chuyện. Họ không cần tài khoản với bạn, thread email, hoặc đăng nhập portal. AI im lặng từ thời điểm một người sở hữu cuộc trò chuyện, nên bạn không cạnh tranh với bot của chính mình.

Cùng một kênh, cách nhau ba ngày. Agent từ chối và chuyển tiếp; tin nhắn bên dưới đường phân tách được một người nhập trong Quickchat AI Inbox. Lưu ý rằng nó xuất hiện dưới tên bot của bạn, vì bot của bạn là danh tính duy nhất Discord cho phép chúng tôi đăng bằng.

Cùng cuộc trò chuyện từ phía bạn. Lời từ chối của Agent, hai Action calls phía sau, câu trả lời của operator bên dưới, và khung chi tiết đã biết kênh là Discord và chủ đề là single sign-on.

Trong lúc đó, thread ticket riêng tư vẫn ở nơi đội ngũ của bạn trao đổi: đó là không gian làm việc, có member trong đó và role hỗ trợ được ping. Câu trả lời quay lại nơi câu hỏi được hỏi.

Sáu bước. Ba bước là các lần ghi Discord, và cả ba chỉ xảy ra vì thiếu câu trả lời.

Kiểm thử theo cả hai cách

Chạy cả hai nhánh trước khi bạn dựa vào hệ thống này, và kiểm thử kỹ nhất nhánh thất bại trung thực.

Câu hỏi đã được bao phủ. @mention bot trong một kênh mà bot có thể thấy và hỏi điều knowledge base của bạn bao phủ. Bạn nên nhận các bước thật, trong kênh, và không có thread ở đâu cả. Đây là trường hợp tiết kiệm thời gian cho đội ngũ của bạn, và sẽ là phần lớn lưu lượng khi tài liệu của bạn tốt.

Câu hỏi chưa được bao phủ. Hỏi điều tài liệu của bạn không bao phủ. Agent nên nói rõ và sau đó chuyển tiếp. Cùng lúc đó, ticket xuất hiện:

Thread mà Agent đã mở. Bot đặt tên từ vấn đề, đưa member vào, ping role, và tự viết tóm tắt.

Và thread thật sự riêng tư, điều mà danh sách member của nó chứng minh:

Ticket là thread riêng tư. Cuộc trò chuyện hỗ trợ không diễn ra công khai.

Kiểm thử trên toàn bộ cuộc trò chuyện, không chỉ một tin nhắn. Bộ chặn trùng lặp chỉ thể hiện giá trị ở lượt thứ hai, khi member bổ sung chi tiết và bot ngây thơ mở ticket thứ hai.

Một điều run conditions không bao phủ. Chúng chặn lệnh gọi sai thứ tự, nhưng không loại trừ retry trùng lặp: nếu bạn chạy lại notify Action bằng tay, nó đăng tin nhắn thứ hai. Nên biết điều này trước khi thao tác trên ticket đang live.

Để kiểm tra nhiều cách diễn đạt cùng lúc mà không phải nhập tất cả vào Discord, dùng Simulations trong Testing: xây dựng dataset gồm tin nhắn khách hàng, chạy nó với Agent thật của bạn, và đọc kết quả được chấm điểm cùng nhau. Trộn câu hỏi đã được bao phủ và chưa được bao phủ trong một dataset, vì hai nhánh thất bại theo các cách khác nhau.

Sáu câu hỏi, bốn câu đã được bao phủ và hai câu chưa, được chấm trong một lần chạy. Hàng 5 và 6 là các thất bại trung thực, và chúng đạt điểm cao như các câu trả lời.

Viết tiêu chí đánh giá cho grader chỉ có thể thấy transcript, vì đó là tất cả nó nhận được. Có hai thứ nó không thể thấy sẽ gây mất điểm nếu bạn không nói rõ. Nó không thể thấy side effect Discord, nên nếu bạn không nêu, nó đọc “Tôi đã mở ticket cho bạn” như Agent bịa ra khả năng. Và nó không thể thấy knowledge base của bạn, nên nó hạ điểm một câu trả lời đúng, cụ thể như nội dung bịa đặt chỉ vì nó không kiểm tra được con số. Cả hai đáng được nêu mỗi thứ một câu trong tiêu chí, và cả hai sẽ hạ điểm hành vi tốt nhất của bạn nếu bạn bỏ qua.

Làm cách nào để ngăn bot mở quá nhiều ticket?

Đây là phần tinh chỉnh duy nhất mà hầu hết server cần, và chủ yếu không phải vấn đề prompt.

Số lượng ticket là vấn đề knowledge base. Mọi khoảng trống trong tài liệu của bạn trở thành ticket. Nếu bot chuyển tiếp nhiều hơn bạn dự kiến, hãy đọc các ticket: chúng là danh sách câu hỏi mà tài liệu của bạn không trả lời. Đóng các khoảng trống đó làm giảm volume trực tiếp.

Insights cho bạn biết nên viết tài liệu gì tiếp theo. Quickchat AI nhóm cuộc trò chuyện theo chủ đề, nên bạn có thể thấy câu hỏi nào xuất hiện thường xuyên nhất thay vì đoán. Sửa ba chủ đề hàng đầu trong knowledge base và theo dõi tỷ lệ chuyển tiếp giảm.

Không ai cấu hình các mục này. Trong Insights, Advanced, AI-Detected Topics đặt tên chúng từ chính các cuộc trò chuyện, và số lượng là backlog tài liệu theo thứ tự ưu tiên.

Danh sách đó là toàn bộ vòng tinh chỉnh. Giá và API keys xuất hiện nhiều nhất, nên các bài đó được viết trước, và biểu đồ tuần sau cho bạn biết việc đó có hiệu quả không. Các chủ đề ở trên được phát hiện cho bạn; bạn cũng có thể định nghĩa chủ đề riêng trong Manage Topics nếu muốn theo dõi có chủ đích một khu vực sản phẩm cụ thể. Xem AI-Detected Topics, Conversation Topics và quản lý topics trong tài liệu.

Nếu bot chuyển tiếp quá dễ, siết chặt mô tả Action để nó chỉ chạy sau khi Agent đã nói với member rằng không có thông tin. Nếu bot chuyển tiếp quá ít và bắt đầu đoán, tăng cường dòng “đừng đoán và đừng bịa các bước” trong prompt chính.

Có an toàn khi chạy trong server công khai không?

Một bot mà bất kỳ ai trong kênh công khai cũng có thể nói chuyện cần được xem xét kỹ. Điều bảo vệ bot này là cấu hình bạn có thể đọc trong editor, không phải câu chữ prompt, nên nó vẫn giữ hiệu lực bất kể tin nhắn được viết như thế nào.

Member có thể nói chuyện với model. Họ không thể vượt qua cột giữa.

Mỗi ticket Action yêu cầu một lượt Discord thật, từ server của bạn. Hai trong ba run conditions trên mỗi Action kiểm tra rằng tin nhắn thật sự đến qua tích hợp Discord và đến từ server bạn đã chọn khi cài. Các giá trị đó do tích hợp tạo, không phải do tin nhắn, và public chat hoặc API message không thể cung cấp chúng hoặc kế thừa bản lưu cũ. Trỏ public API của Agent vào các Actions này và chúng sẽ từ chối.

Action thêm người vào thread riêng tư không có tham số nào model có thể sửa. URL của nó kết thúc bằng member ID mà tích hợp cung cấp cho tin nhắn hiện tại. Agent không thể truyền ID khác, nên không thể kéo một member tùy ý trong server của bạn vào ticket của người khác.

Mentions bị khóa khi cài đặt. Notify Action gửi danh sách mention rõ ràng chứa member đã hỏi và role bạn chọn, với parsing bị tắt. Một mention mà Agent tình cờ viết vào issue summary sẽ không resolve, và @everyone không bao giờ kích hoạt. Điều này đáng xác minh thay vì tin suông, và đúng là như vậy: role ping và user mention đều đến, còn @everyone dạng literal trong cùng tin nhắn không làm gì.

Threads là riêng tư và không thể mời thêm. Chúng được tạo với type: 12 và invitable: false, nên member được thêm vào ticket không thể đưa người khác vào.

Bot không thể moderation. Nó không có quyền Kick, Ban hoặc Timeout. Kết quả xấu nhất nếu member dụ Agent làm điều không nên là một thread ticket mà họ đã có thể mở bằng cách hỏi bình thường.

Token không bao giờ bị lộ. Nó tồn tại dưới dạng System Token, được chèn khi gửi, và bị che ở mọi nơi call được ghi lại.

Một điều cần quyết định có chủ đích: ticket threads là riêng tư, nhưng bất kỳ ai có role hỗ trợ của bạn đều có thể đọc, điều này đúng với hỗ trợ và đáng biết nếu member có thể dán chi tiết nhạy cảm. Hãy hướng họ sang email cho bất kỳ điều gì thật sự bảo mật.

Bot hỗ trợ Discord AI tốn bao nhiêu?

Gói Free bao gồm AI Actions, Human Handoff, knowledge base, Topics và Insights, với 50 AI credits mỗi tháng cho mục đích cá nhân, phi thương mại. Mục đích kinh doanh yêu cầu gói trả phí; các gói trả phí cũng cung cấp nhiều AI credits hơn. Nếu bạn đang cân nhắc so với việc tự chạy, bot Discord AI miễn phí so sánh trung thực đường self-hosted, bao gồm số giờ phải bỏ ra.

Khi cả hai nhánh đều đạt, hãy cho Agent hoạt động:

1. Chỉ member đến bot. Nói trong topic kênh rằng họ có thể @mention bot. Một bot không ai biết sẽ không deflect gì.
2. Theo dõi ngày đầu tiên. Mọi Action giữ call log với request và response chính xác, và Inbox giữ mọi cuộc trò chuyện, nên bạn có thể thấy bot đã trả lời gì và chuyển tiếp gì.
3. Đọc các ticket đầu tiên như backlog tài liệu. Chúng là các câu hỏi tài liệu của bạn chưa trả lời.

Cùng Agent cũng hoạt động ở mọi nơi khác. Knowledge base, prompt và Human Handoff thuộc về Agent, không thuộc về Discord, nên cùng bot hỗ trợ trả lời trên website widget, trong Slack, trên WhatsApp và qua email, và mọi cuộc trò chuyện vào cùng Inbox. Ba ticket Actions là phần duy nhất dành riêng cho Discord trong cấu hình này. Nếu đội ngũ của bạn làm việc trong Slack thay vì Discord, gửi thông báo handoff tới đó thay vì gọi một Discord role.

Discord AI Agent của bạn còn có thể làm gì?

Cùng gallery có danh mục Moderation: timeout, kick, ban, unban, assign role, slowmode và announcements. Mỗi template đó cài với run condition author_is_admin is true, nên chỉ server administrator mới có thể kích hoạt, và cờ đó đến từ Discord thay vì từ cuộc trò chuyện. Đó là bot khác với hồ sơ rủi ro khác, và nó có hướng dẫn riêng: Xây dựng bot moderation Discord AI.

Bất kỳ Discord endpoint nào khác cũng theo cùng công thức: một HTTP Request Action với header Authorization: Bot {{discord_bot_token}}, một hoặc hai parameter, và mô tả bằng ngôn ngữ thường quyết định khi nào Agent chạy nó. Xây dựng AI Agent thực hiện actions là phiên bản nhập môn của ý tưởng đó, và Kết nối AI Agent của bạn với bất kỳ API nào trình bày trường hợp tổng quát.

Không phải bot Discord nào cũng là bot hỗ trợ. Cùng Agent có thể chạy một nhân vật: Bot roleplay Discord AI dùng cùng knowledge base và memory cho personas thay vì tickets, và bản xây dựng nhân vật đầy đủ trình bày prompt persona, canon và các cài đặt giữ bot đúng nhân vật.

Phụ lục: các request chính xác

Bạn không bao giờ nhập các request này, nhưng chúng đáng đọc một lần, và chúng là thứ bạn sẽ tự xây dựng thủ công với bất kỳ nền tảng nào khác. Các giá trị {{...}} được Quickchat AI điền khi gửi.

1. Mở thread riêng tư

POST https://discord.com/api/v10/channels/YOUR_TICKET_CHANNEL_ID/threads
Authorization: Bot {{discord_bot_token}}
Content-Type: application/json

{ "name": "ticket-{{ticket_subject}}", "type": 12, "auto_archive_duration": 1440, "invitable": false }

type: 12 là thứ làm thread riêng tư. auto_archive_duration tính bằng phút, nên 1440 archive một ticket yên lặng sau một ngày. Save to memory bắt $.id dưới dạng discord_ticket_thread_id.

2. Thêm member đã hỏi

PUT https://discord.com/api/v10/channels/{{metadata_discord_ticket_thread_id}}/thread-members/{{metadata_discord_author_id}}
Authorization: Bot {{discord_bot_token}}

Không có body và không có parameters. Cả hai ID đến từ memory và từ tích hợp.

3. Thông báo cho đội hỗ trợ

POST https://discord.com/api/v10/channels/{{metadata_discord_ticket_thread_id}}/messages
Authorization: Bot {{discord_bot_token}}
Content-Type: application/json

{
  "content": "<@{{metadata_discord_author_id}}> ticket của bạn đã được mở. <@&YOUR_SUPPORT_ROLE_ID> ticket mới: {{issue_summary}}",
  "allowed_mentions": { "parse": [], "users": ["{{metadata_discord_author_id}}"], "roles": ["YOUR_SUPPORT_ROLE_ID"] }
}

Hai chi tiết sẽ tốn thời gian debug thật nếu bạn tự xây dựng. Auth scheme là Bot, không phải Bearer, đây là lỗi phổ biến nhất khi gọi Discord thủ công. Và trong allowed_mentions, parse rỗng cùng với danh sách users và roles rõ ràng là điều bạn muốn: nó chặn @everyone trong khi cho hai mention dự định đi qua. parse không rỗng cạnh danh sách rõ ràng cùng loại sẽ bị từ chối ngay, với 400 MESSAGE_ALLOWED_MENTIONS_PARSE_EXCLUSIVE.

Hướng dẫn liên quan

• Tạo bot Discord AI, phần thiết lập mà hướng dẫn này giả định
• Xây dựng bot moderation Discord AI, cùng gallery hướng đến moderation
• Các bot Discord AI tốt nhất, cách so sánh các lựa chọn
• Bot Discord AI miễn phí, self-hosting thật sự tốn gì
• Bot roleplay Discord AI, cùng Agent chạy một nhân vật thay thế
• Kết nối AI Agent của bạn với HubSpot, cùng gallery một nhấp cho CRM
• Làm cho actions của AI Agent đáng tin cậy, run conditions và memory chuyên sâu
• Kết nối AI Agent của bạn với bất kỳ API nào, công thức tổng quát
• Cách xây dựng knowledge base cho chatbot, nửa quyết định số lượng ticket
• Product tutorial: Human Handoff, giải thích mọi cài đặt handoff

Câu hỏi thường gặp

Làm cách nào để thiết lập bot ticket trong Discord?

Kết nối Discord app của riêng bạn trong External Apps, cấp cho Agent một knowledge base, sau đó mở Actions and MCPs, nhấp Add Action, chọn Discord Action và chọn Open Support Ticket. Chọn server, kênh ticket và role hỗ trợ của bạn từ các menu thả xuống rồi nhấp Install and enable. Bạn không cần host gì và không cần cấu hình gì bên trong Discord ngoài việc tạo kênh và role.

Làm cách nào để tạo bot ticket Discord?

Tạo một Quickchat AI Agent, kết nối Discord app của riêng bạn, sau đó mở Actions and MCPs, nhấp Add Action, chọn Discord Action và chọn Open Support Ticket. Bạn chọn server, kênh ticket và role hỗ trợ từ các menu thả xuống, nhấp Install and enable, và Quickchat AI viết ba AI Actions hoàn chỉnh cho bạn. Hãy cấp cho Agent một knowledge base trước, vì đó là yếu tố quyết định bot sẽ mở bao nhiêu ticket.

AI có thể trả lời câu hỏi hỗ trợ trong Discord không?

Có. Agent tìm kiếm trong knowledge base của bạn và trả lời trong kênh khi tìm thấy câu trả lời. Deflection theo dõi mức độ bao phủ: các câu hỏi tài liệu của bạn bao phủ sẽ được trả lời, còn các câu hỏi tài liệu không bao phủ sẽ trở thành ticket. Mối quan hệ đó là điều hữu ích nhất cần hiểu khi vận hành bot này.

Tôi có cần code để xây dựng bot ticket Discord này không?

Không. Bạn chọn một template từ thư viện Discord, chọn server, kênh và role từ các menu thả xuống, và Quickchat AI viết method, URL, headers, body, parameters, response settings và run conditions ở backend. Bạn không bao giờ phải nhập Discord ID và không bao giờ phải sửa JSON.

Template cài đặt bao nhiêu Actions?

Ba. Một Action mở thread riêng tư trong kênh ticket của bạn và lưu ID của nó vào memory, một Action thêm member đã hỏi, và một Action đăng bản tóm tắt có nhắc đến role hỗ trợ của bạn. Chúng được cài sẵn ở trạng thái enabled và đã được nối với nhau.

Bot biết khi nào cần mở ticket bằng cách nào?

Có hai yếu tố quyết định. Mô tả Action yêu cầu Agent chỉ gọi Action khi câu trả lời không có trong knowledge base, và một run condition làm cho chuỗi chạy mang tính xác định: thread chưa được tồn tại trước khi có thể mở, và phải tồn tại trước khi các bước tiếp theo có thể chạy.

Bot có thể mở ticket trùng lặp không?

Không trong cùng một cuộc trò chuyện. Open Support Ticket có run condition yêu cầu chưa có ticket thread ID nào trong memory, nên sau khi một ticket đã tồn tại, Agent không thể mở ticket thứ hai cho cuộc trò chuyện đó, bất kể prompt nói gì.

Con người có thể tiếp quản cuộc trò chuyện không?

Có. Human Handoff đánh dấu cuộc trò chuyện trong Quickchat AI Inbox của bạn bằng bản tóm tắt do AI viết. Gán nó cho chính bạn, nhập câu trả lời trong Inbox, và câu trả lời sẽ đến cùng kênh Discord mà member đang ở. Họ không rời Discord và không cần có tài khoản với bạn.

Vì sao bot ticket cần Discord app của riêng tôi?

Các ticket Actions gọi Discord API với tư cách bot của bạn, nên chúng cần token của bot. Bot Quickchat AI dùng chung một nhấp có thể trả lời câu hỏi và dùng Google Sheets Actions. Discord token của bot đó không khả dụng cho private-ticket Actions của bạn. Trong External Apps, mở Discord và chọn Advanced setup, mất khoảng mười phút.

Bot cần những quyền Discord nào?

View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads và Manage Threads trên kênh ticket. Bot hỗ trợ không cần quyền Kick, Ban hoặc Timeout, và một quyền mà bot không có là một quyền bạn không bao giờ phải suy xét.

Vì sao role hỗ trợ của tôi không có trong menu thả xuống?

Role picker chỉ liệt kê các role mà Discord báo là mentionable, và loại trừ @everyone. Nếu role hỗ trợ của bạn chưa được đặt mentionable trong Server Settings, Roles, nó sẽ không xuất hiện, vì template sẽ không thể ping role đó.

Bot ticket Discord có an toàn khi chạy trong server công khai không?

Các kiểm soát là cấu hình, không phải câu chữ prompt, nên chúng vẫn có hiệu lực bất kể tin nhắn được viết như thế nào. Mỗi ticket Action yêu cầu lượt đó thật sự đến từ Discord và từ server bạn đã chọn, Action thêm người vào thread riêng tư không có tham số nào mà model có thể sửa, mentions bị khóa vào member đã hỏi và role bạn đã chọn, và threads là riêng tư, không thể mời thêm. Run conditions được kiểm tra trước khi bất kỳ request nào rời Quickchat AI.

Bot hỗ trợ Discord AI tốn bao nhiêu?

Gói Free bao gồm 50 AI credits mỗi tháng cho mục đích cá nhân, phi thương mại. AI Actions, Human Handoff, knowledge base, Topics và Insights được bao gồm. Mục đích kinh doanh yêu cầu gói trả phí; các gói trả phí cũng cung cấp nhiều AI credits hơn.

Điểm khác biệt giữa cách này và Ticket Tool hoặc TicketsBot là gì?

Các công cụ đó dựa trên rule. Member nhấp nút Create Ticket trên một panel được ghim và ticket luôn được mở, kể cả cho câu hỏi mà tài liệu của bạn đã trả lời. Bot này trả lời trước và chỉ chuyển tiếp những gì thật sự không thể giải quyết, nên đội ngũ của bạn đọc các câu hỏi thực sự cần người xử lý.

ChatGPT, Claude hoặc Gemini có thể chạy bot ticket Discord không?

Có, thông qua Quickchat AI. Agent của bạn chạy trên các model mới nhất và gọi Discord API bằng các AI Actions này, nên bot trả lời từ knowledge base của bạn và mở các thread riêng tư thật. Bạn quyết định Actions nào tồn tại và bot được phép làm gì.

Cùng một Agent có thể hoạt động trên các kênh khác ngoài Discord không?

Có. Knowledge base, prompt và Human Handoff thuộc về Agent, không thuộc về Discord, nên cùng bot hỗ trợ đó có thể trả lời trên website widget, trong Slack, trên WhatsApp và qua email. Ba ticket Actions là phần duy nhất dành riêng cho Discord trong cấu hình này.

Member bắt đầu cuộc trò chuyện với bot bằng cách nào?

Bot ticket trong hướng dẫn này dùng Discord app của riêng bạn, nên member bắt đầu bằng cách @mention bot trong một kênh mà bot có thể thấy. Agent trả lời trong cùng kênh và chỉ mở thread ticket khi không thể trả lời. Lệnh /ask thuộc về bot Quickchat AI dùng chung một nhấp.

Làm cách nào để ngăn bot mở quá nhiều ticket?

Trước tiên hãy cải thiện độ bao phủ của knowledge base, vì mỗi khoảng trống đều trở thành ticket. Đọc các ticket đầu tiên của bạn như một backlog tài liệu, và dùng Insights để xem chủ đề nào xuất hiện nhiều nhất để biết nên viết gì tiếp theo. Chỉ sau đó mới siết chặt mô tả Action.

Tôi có thể sửa các Actions mà gallery cài đặt không?

Mọi trường. Chúng là các HTTP Request Actions thông thường, không có gì đánh dấu là đặc biệt: không khóa, không badge, không lớp policy riêng. Thay đổi URL, body, mô tả hoặc run conditions, hoặc cài bản sao thứ hai và sửa bản đó.

Tôi có thể chạy hệ thống ticket Discord mà không cần helpdesk không?

Có. Ticket là một thread Discord riêng tư và hàng đợi là Quickchat AI Inbox của bạn, nên không có Zendesk, Intercom hoặc Jira trong luồng và không có gì cần migrate. Nếu bạn đã dùng helpdesk, bạn có thể giữ nó: cùng Agent cũng có thể tạo ticket ở đó bằng một AI Action khác, và HubSpot gallery làm đúng việc đó.

Bot có thể trả lời từ nội dung help center của chúng tôi không?

Đó là nền tảng của bot. Dán URL help center của bạn và Quickchat AI scrape các trang vào knowledge base, hoặc upload file và dán bài viết trực tiếp. Agent tìm kiếm các bài viết đó cho mọi câu hỏi và trả lời trong kênh khi tìm thấy câu trả lời, nên tài liệu hiện có của bạn trở thành bot mà không cần viết lại. Tạo AI support agent từ tài liệu của bạn trình bày riêng phần đó.

Bot có thể chào member khi kênh ticket mở không?

Có, bằng một tính năng riêng. Bot ticket như Ticket Tool tạo kênh, và automated message New channel của Quickchat AI đăng một lời chào cố định trong đó vài giây sau, để member thấy ngay rằng có thứ để trò chuyện. Tính năng này không tốn credits vì không gọi model. Chào members, threads và ticket channels thiết lập tính năng này.

Làm cách nào để đo ticket deflection?

Deflection là tỷ lệ câu hỏi được trả lời mà không cần ticket, nên trong cấu hình này đó là số cuộc trò chuyện không có ticket thread chia cho toàn bộ cuộc trò chuyện. Mỗi Action giữ call log, nên đếm các lần gọi open_support_ticket cho bạn trực tiếp phần được chuyển tiếp, và Insights nhóm phần còn lại theo chủ đề. Theo dõi theo từng chủ đề thay vì một con số tổng: tỷ lệ giảm ở một chủ đề là khoảng trống tài liệu bạn có thể đóng. Chatbot analytics trình bày bộ chỉ số rộng hơn.

Tóm tắt

Với một knowledge base và một nhấp, Quickchat AI Agent trở thành bot hỗ trợ tuyến đầu cho Discord server của bạn: bot trả lời các câu hỏi tài liệu bao phủ, thừa nhận khi tài liệu không bao phủ, mở thread ticket riêng tư cho phần còn lại, đưa member vào, gọi role hỗ trợ bằng bản tóm tắt do chính bot viết, và chuyển cuộc trò chuyện cho một người trả lời từ Inbox của bạn mà member không bao giờ phải rời Discord. Gallery viết ba Actions, các menu thả xuống nghĩa là bạn không bao giờ nhập Discord ID, và run conditions nghĩa là chuỗi vẫn giữ đúng ngay cả khi cuộc trò chuyện không diễn ra theo kế hoạch. Phần còn lại là công việc chỉ bạn có thể làm: một knowledge base đáng để trả lời từ đó.