AI Discord ticket bot: najprv odpoveď, potom eskalácia

Quickchat AI odpovedá na support otázky na vašom Discord serveri z vašej vlastnej dokumentácie a otvorí súkromné ticket vlákno iba vtedy, keď odpovedať nevie. Tento návod vytvorí takého bota od začiatku do konca, bez kódu, približne za pol hodiny.

Výsledok sa správa ako dobrý agent prvej línie. Člen sa opýta, ako resetovať API kľúč, a dostane skutočné kroky v kanáli. Člen sa opýta niečo, čo dokumentácia nepokrýva, a namiesto hádania bot povie, že to nevie, otvorí súkromné vlákno, pridá doň člena, pingne vašu support rolu jednoriadkovým súhrnom a odovzdá konverzáciu človeku, ktorý môže odpovedať z vášho Inboxu.

Vyberte úlohu pre svojho Discord bota

Táto konfigurácia odpovedá na support otázky a eskaluje medzery vo vašej dokumentácii. Pre pevné pozdravy vyberte návod na welcome bota, pre administrátorské príkazy návod na moderovanie.

Potrebujete dve veci:

• Quickchat AI Agenta (vytvorte si účet)
• Discord server, kde ste admin

Od registrácie po prvý support test

1. Ak sa registrujete e-mailom a heslom, otvorte overovací odkaz v e-maile. V nastavení opíšte Discord support Agenta, kliknite na Create my AI Agent a dokončite kroky nastavenia vrátane výberu plánu pre zamýšľané použitie.
2. Pridajte dokumentáciu v Knowledge Base. V External Apps otvorte Discord, potom Use your own Discord app a vyberte Advanced setup. Zdieľaný one-click bot vie odpovedať na otázky, ale nevie spúšťať ticket Actions v tomto návode.
3. V testovacom serveri vytvorte ticket kanál a mentionable support rolu. V Actions and MCPs kliknite na Add Action, vyberte Discord Action a nainštalujte Open Support Ticket s týmto serverom, kanálom a rolou.
4. Po použití inštrukcií pre Agenta nižšie @mentionnite svojho bota otázkou, na ktorú dokumenty odpovedajú, a potom otázkou, na ktorú neodpovedajú. Prvá by mala dostať odpoveď bez ticketu; druhá by mala otvoriť jedno súkromné vlákno a upozorniť support rolu. Pridajte následnú otázku do druhej konverzácie a skontrolujte, že sa neotvorí duplicitný ticket.

Free plán je určený na osobné, nekomerčné použitie. Pred použitím bota pre firmu vyberte platený plán. Dokončite dvojcestný test pred pozvaním zákazníkov.

Snímky obrazovky nižšie pochádzajú z testovacieho Agenta s názvom Lumen, support bota pre fiktívnu produktovo-analytickú spoločnosť Beacon. Spoločnosť je vymyslená, aby príklad zostal neutrálny, ale každá konverzácia, každé API volanie a každé ticket vlákno zobrazené tu bolo vytvorené skutočným Agentom, ktorý bežal v skutočnom reply pipeline proti skutočnému Discord serveru.

Čo vytvoríte

Jedno rozhodnutie na otázku. Pri úspešnej ceste sa do Discordu nezapíše vôbec nič.

Tri AI Actions vykonávajú eskaláciu a Quickchat AI nainštaluje všetky tri z jednej karty galérie:

Čo je znalostná báza a prečo určuje objem ticketov?

Ak ste ešte nevytvárali AI Agenta, toto je koncept, ktorému sa oplatí venovať dve minúty.

Znalostná báza je vaša vlastná dokumentácia načítaná do Agenta a indexovaná tak, aby sa dala prehľadávať počas konverzácie. Môžete nasmerovať Quickchat AI na URL svojej help dokumentácie a nechať ho zoškrabať stránky, vložiť články ručne alebo nahrať súbory. Pri odpovedi ju Agent prehľadá a odpovedá z toho, čo nájde, nie z toho, čo si základný model náhodou pamätá o svete. Ak začínate od nuly, ako vytvoriť znalostnú bázu chatbota vysvetľuje, čo písať a v akom poradí.

Všetko, čo vaše dokumenty pokrývajú, dostane odpoveď. Všetko, čo nepokrývajú, sa stane ticketom.

Toto je celý ovládací prvok tejto konfigurácie. Deflection nie je prompt trik a nie je to schopnosť modelu: je to vaše pokrytie. Ak bot eskaluje viac, než ste čakali, tickety vám hovoria, ktoré stránky ste ešte nenapísali.

Ilustrácia, nie meranie. Dôležitý je smer: písanie dokumentácie je tu najúčinnejšia vec, ktorú môžete urobiť.

Môže AI skutočne odpovedať na support otázky v Discorde?

Pri otázkach, ktoré vaše dokumenty pokrývajú, áno, a so skutočnými krokmi, nie parafrázou. Tu je prípad deflection z testovacieho servera, bez úprav:

Odpovedané v kanáli, z článku znalostnej bázy. Nebol vytvorený žiadny ticket, pretože nebol potrebný.

Zaujímavejšia polovica je to, čo sa stane, keď odpoveď nie je dostupná. Bot to povie:

Poctivé zlyhanie. Znalostná báza Beacon zámerne vynecháva enterprise SSO, takže toto je cesta, ktorá otvorí ticket.

Agent, ktorý si vymyslí vierohodný postup SSO, je horší než agent, ktorý otvorí ticket, takže toto správanie sa oplatí zámerne testovať, nie vň dúfať. Vrátime sa k tomu v časti testovanie.

Dva spôsoby pripojenia Discordu a prečo tickety potrebujú druhý

Quickchat AI má dve Discord pripojenia a rozdiel je dôležitý skôr, než začnete.

Pre verejný feedback queue, ktorý funguje so zdieľaným botom, pozrite workflow pre feedback a medzery v dokumentácii. Private-ticket Actions nižšie potrebujú credential vášho vlastného Discord bota.

One-click je rýchla cesta. V External Apps otvoríte Discord, kliknete na Add to your Discord server, autorizujete ho a zdieľaný Quickchat AI bot je na vašom serveri približne za minútu. Odpovedá, keď ho členovia @mentionnú alebo použijú /ask, a pre mnohé servery je to celá úloha.

Môžete ho pomenovať. Pred autorizáciou je tu pole Bot name in the new server, predvyplnené menom vášho Agenta, a každý pripojený server má vlastné pole Bot name in this server, ktoré môžete neskôr zmeniť. Je to Discord prezývka, takže je špecifická pre server a obmedzená na 32 znakov, a jej vymazanie vráti bota späť na Quickchat AI. Zdieľaný zostáva avatar a základné @username, pretože jedna Discord aplikácia obsluhuje každý server, ktorý si ju nainštaluje.

One-click neznamená generický. Bot prinesie meno vášho Agenta na server a neskôr ho môžete meniť po serveroch.

Advanced setup zaregistruje vašu vlastnú Discord aplikáciu. Vytvoríte bota v Discord developer portal a raz vložíte jeho token do Quickchat AI. Trvá to približne desať minút a získate vlastný avatar a @username, priame správy, viacero botov na jednom serveri a vec, ktorú tento návod potrebuje: Discord API Actions.

Dôvod treba povedať priamo, nie ho brať ako zvláštnosť. Ticket Actions v tomto návode volajú Discord API ako váš bot, pomocou credential, ktorý Quickchat AI vloží do požiadavky pri odoslaní. Token zdieľaného one-click bota patrí zdieľanému botovi, nie vám, takže nie je dostupný pre vaše Actions. Ak otvoríte Discord galériu bez pripojenej vlastnej app, povie vám to a karty vypne, namiesto toho, aby vás nechala postaviť niečo, čo sa nedá spustiť.

External Apps je miesto, kde začínajú obe cesty. Advanced setup je v calloute v spodnej časti Discord panelu.

Čo potrebujete pred začiatkom

Pripojte vlastnú Discord app. V External Apps otvorte Discord, nájdite Use your own Discord app a vyberte Advanced setup. V Discord developer portal vytvorte aplikáciu a bota, zapnite Message Content Intent, nechajte Require OAuth2 Code Grant vypnuté a vložte bot token. Quickchat AI ho validuje počas písania. Návod Create an AI Discord bot podrobne pokrýva portál, ak ste to ešte nerobili.

Dajte botovi iba to, čo support bot potrebuje. V ticket kanáli: View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads a Manage Threads. Nepotrebuje oprávnenie Kick, Ban ani Timeout a v testovacom serveri ich zámerne nemá. Support bot nemá dôvod moderovať a oprávnenie, ktoré nemá, je oprávnenie, o ktorom nikdy nemusíte uvažovať.

V Discorde vytvorte dve veci, na ktoré budú Actions odkazovať. Táto časť sa deje v Discord klientovi, nie v Quickchat AI, a je to jediné nastavenie, ktoré tam robíte:

1. Kanál, kde sa budú otvárať tickety. Stačí akýkoľvek textový kanál. Použite + vedľa zoznamu kanálov alebo použite existujúci. V testovacom serveri je to #support.
2. Rolu, ktorú upozorníte pri otvorení ticketu. Server Settings, potom Roles, potom Create Role. V testovacom serveri je to @support.

Tri miesta a iba jedno z nich je verejné.

Obe tieto položky sa vrátia v Step 3. Keď nainštalujete ticket šablónu, Quickchat AI načíta váš server naživo z Discordu a zobrazí tri rozbaľovacie zoznamy, z ktorých jeden je Role picker so zoznamom nájdených rolí. Tam si vyberiete support rolu namiesto toho, aby ste niekam písali ID.

Role picker v Step 3. Číta zoznam z Discordu, takže rola, ktorú teraz vytvoríte, sa tu o chvíľu objaví.

Jeden detail vás dobehne, ak ho preskočíte: tento picker uvádza iba roly, ktoré Discord hlási ako mentionable, a vynecháva @everyone. Ak vaša support rola nie je nastavená ako mentionable, v rozbaľovacom zozname sa jednoducho nezobrazí a nič nevysvetlí prečo. Filter je zámerný, pretože celou úlohou šablóny je túto rolu pingnúť. Nastavte to pri vytváraní roly a problém nikdy neuvidíte:

Server Settings, Roles, vyberte support rolu a zapnite toto pod Display. Bez toho sa rola nikdy nedostane do pickeru.

Ako sa bot rozhodne odpovedať alebo otvoriť ticket?

Väčšina Discord ticket botov sa nerozhoduje. Ticket Tool, TicketsBot a ostatné zverejnia pripnutý panel s tlačidlom Create Ticket alebo zaregistrujú slash command. Člen naň klikne, otvorí sa ticket a váš tím ho číta. Je to dobrý dizajn a je úplne predvídateľný, ale znamená to, že desať ľudí, ktorí sa tento týždeň pýtali, ako resetovať API kľúč, vytvorilo desať ticketov.

Rovnakých desať otázok. Rozdiel je v tom, čo váš tím nakoniec číta.

Answer-first bot číta vaše dokumenty predtým, než sa rozhodne. A keď eskaluje, otvorenie jedného ticketu potrebuje presne štyri fakty:

• v ktorom kanáli sa vlákno otvorí
• z ktorého servera prišla otázka
• kto sa pýta, aby mohol byť pridaný do vlákna
• ako sa ticket volá a jednoriadkový súhrn problému

Zaujímavé je, že tieto štyri fakty prichádzajú tromi úplne odlišnými spôsobmi a iba posledný píše AI:

Nikdy nepíšete Discord ID a model nikdy nevidí váš kanál ani vašu rolu.

Tie, ktoré vyberiete raz. Váš ticket kanál a support rola. Vyberiete ich z rozbaľovacích zoznamov pri inštalácii šablóny a Quickchat AI ich zapečie do Action. Model ich nikdy nevidí a nemôže ich zmeniť.

Tie, ktoré dodáva Discord. Pri každej preposlanej správe Discord integrácia povie Quickchat AI, z ktorého servera prišla a kto hovorí, ako {{metadata_discord_guild_id}} a {{metadata_discord_author_id}}. Token vášho bota príde rovnakým spôsobom ako System Token vložený pri odoslaní a redigovaný všade, kde sa loguje volanie. Nič z toho nepíše model a nič z toho nemôže dodať verejný chat ani API správa.

Tie, ktoré píše Agent. Predmet ticketu a jednoriadkový súhrn problému. Toto sú jediné úsudkové rozhodnutia v celej konfigurácii, preto je neskoršie ladenie krátke.

Step 1: Vytvorte Agenta a dajte mu znalostnú bázu

Vytvorte Agenta, potom otvorte Knowledge Base a pridajte dokumentáciu. Vložte URL svojej help dokumentácie a nechajte Quickchat AI, aby ju zoškrabal, alebo píšte články priamo. Create an AI support agent from your documentation podrobne pokrýva cestu so scrapingom.

Znalostná báza Beacon: resetovanie API kľúča, prázdny dashboard, inštalácia tracking snippet, plány a fakturácia a export dát.

Dokumenty Beacon zámerne nepokrývajú jednu vec: nastavenie enterprise SSO. Táto medzera nie je opomenutie v tomto návode, je to podstata. Každá support znalostná báza má otázky, na ktoré neodpovedá, a celá hodnota tohto bota je v tom, čo urobí, keď na takú narazí. SSO je tou otázkou v celom tomto návode.

Členovia oslovia vášho vlastného bota tým, že ho @mentionnú v kanáli, ktorý vidí. Nie je čo registrovať. Príkaz /ask je dostupný na zdieľanom one-click Quickchat AI botovi.

Step 2: Povedzte Agentovi, kedy má odpovedať a kedy eskalovať

Inštrukcie Agenta patria do AI Main Prompt na Identity. Vložte toto, prispôsobené vašej firme:

Si Lumen, support asistent pre Beacon, hostovaný nástroj na produktovú analytiku pre softvérové tímy. Odpovedáš na otázky zákazníkov v komunitnom Discorde Beacon.
Odpovedaj zo svojej Knowledge Base vždy, keď môžeš. Odpovede drž krátke a praktické, dve alebo tri vety, a uveď konkrétne kroky.
Ak otázka nie je pokrytá tvojou Knowledge Base, nehádaj a nevymýšľaj si kroky. Jasne povedz, že túto informáciu nemáš, potom otvor support ticket:
1. Zavolaj open_support_ticket raz, s krátkym 2 až 4-slovným ticket_subject opisujúcim problém.
2. Potom zavolaj add_ticket_requester, aby si priviedol zákazníka do vlákna.
3. Potom zavolaj post_in_ticket s jednoriadkovým issue_summary toho, na čo sa zákazník pýtal.
Potom povedz zákazníkovi, že jeho ticket je otvorený a tím sa ozve v novom vlákne.
Nikdy sa zákazníka nepýtaj na jeho Discord ID, ID kanála ani ID vlákna. Tie sú vyplnené za teba.

AI Main Prompt na Identity. Toto je vždy dostupné pole, nie samostatný zoznam pokynov.

Dva riadky v tomto bloku nesú záťaž. „Nehádaj a nevymýšľaj si kroky“ mení medzeru v znalostiach na poctivú odpoveď namiesto vierohodnej. A pomenovanie troch Actions v poradí spôsobí, že ich Agent zavolá ako sekvenciu, nie že si vyberie jednu.

Poradie je opísané v prompte, ale nie je vynútené iba tam, a o tom sú ďalšie dve časti.

Step 3: Nainštalujte ticket Actions jedným kliknutím

Otvorte Actions & MCPs, kliknite na Add Action a vyberte Discord Action.

Discord Action je medzi ostatnými one-click galériami.

Galéria sa otvorí s Discord šablónami zoskupenými podľa úlohy: Support & Tickets obsahuje tú, ktorú používa tento návod, a Moderation obsahuje ďalších sedem.

Osem kariet. Open Support Ticket je jediná, ktorá sa vás na niečo pýta.

Vyberte Open Support Ticket a otvorí sa krátky konfiguračný krok. Toto je jediný formulár v celej konfigurácii:

Tri rozbaľovacie zoznamy a dialóg vopred hovorí, čo sa chystá nainštalovať.

Zoznamy prichádzajú naživo z Discordu a sú filtrované na to, čo môže skutočne fungovať. Kanály sú iba textové kanály:

Vyberte kanál, pod ktorým sa majú otvárať tickety. Vlákna sa vytvárajú v ňom.

A roly sú iba mentionable roly, s vylúčeným @everyone:

Toto je filter, ktorý skryje support rolu, ktorú ste ešte nenastavili ako mentionable.

Tri voľby a formulár je hotový:

Celá konfigurácia. Server, kanál, rola a jediné tlačidlo, na ktorom záleží.

Kliknite na Install and enable. Quickchat AI zapíše tri Actions na backende, v jednej transakcii, už aktívne.

Tri karty, zapnuté, s ikonou Discord. Nič ďalšie netreba vyplniť.

O siedmich moderovacích šablónach sa tu oplatí vedieť dve veci. Nepotrebujú žiadnu konfiguráciu, pretože berú server, člena, rolu alebo kanál zo samotnej Discord požiadavky, takže kliknutie na kartu ich okamžite nainštaluje. A inštalácia šablóny dvakrát vám dá druhú upraviteľnú kópiu namiesto chyby, čo je rozumný spôsob, ako vytvoriť variant.

Čo to jedno kliknutie skutočne vytvorilo?

Oplatí sa tomu rozumieť, aj keď ste to nemuseli písať, pretože všetko, čo možno budete chcieť neskôr zmeniť, je tu.

Tri obyčajné HTTP Request Actions. Nič ich neoznačuje ako špeciálne.

Sú navzájom prepojené cez dve funkcie, ktoré už máte v editore, a obe sa oplatí poznať podľa názvu.

Save to memory zachytí hodnotu z odpovede a uloží ju do konverzácie. open_support_ticket ju používa na uchovanie ID nového vlákna: Discord vráti objekt vlákna, $.id je ID a zapíše sa do pamäte ako discord_ticket_thread_id. Dve následné Actions si ho potom načítajú vo svojej URL, takže pôsobia na vlákno, ktoré sa práve vytvorilo, nie na niečo, čo ste museli vopred pomenovať. (Save to memory v dokumentácii.)

Run only when podmieňuje Action stavom konverzácie a kontroluje sa na strane Quickchat AI pred odoslaním akejkoľvek požiadavky. (Run only when v dokumentácii.)

Brána, ktorá mení tri nezávislé Actions na spoľahlivú sekvenciu.

Čítajte tento diagram oboma smermi, pretože robí dve úlohy:

• Následné kroky vyžadujú, aby ID vlákna existovalo, takže Agent nemôže upozorniť váš tím na vlákno, ktoré nikdy nebolo vytvorené.
• open_support_ticket vyžaduje, aby neexistovalo, takže Agent nemôže otvoriť druhý ticket v tej istej konverzácii, nech konverzácia hovorí čokoľvek. Je to garancia, nie inštrukcia: ak člen pošle ďalších desať správ s detailmi, stále má jeden ticket. V režime odpovedí v kanáli je každá výmena v kanáli vlastnou konverzáciou, takže ďalšia skutočná otázka môže stále otvoriť vlastný ticket.

Každá Action má aj Response filter a tento sa ľahko zle pochopí. Response filter je allowlist: pomenuje cesty, ktoré Agent smie vidieť, a všetko ostatné v odpovedi sa zahodí skôr, než to model vôbec prečíta. (Response filter v dokumentácii.)

Discord vracia tucet polí o vašom serveri. Agent vidí dve.

ID vlákna, ktoré sekvencia potrebuje, zachytí Quickchat AI na svojej strane cez Save to memory, takže Agent ho nikdy nemusí niesť a nič ďalšie o vašom serveri sa nedostane k modelu. Zúžte allowlist ešte viac a uvidí menej. Nikdy nevidí viac, než uvediete.

Môže človek prevziať konverzáciu od AI?

Áno, a toto je polovica, ktorú väčšina ticket botov vynecháva. Ticket, ktorý nikto nečíta, je len vlákno.

Human Handoff je samostatná, vstavaná Action. Zapnite ju a pod Handoff Rules opíšte, kedy sa má konverzácia dostať k človeku, napríklad „keď zákazník požiada o človeka alebo keď Agent nevedel odpovedať zo znalostnej bázy“. Quickchat AI potom označí konverzáciu vo vašom Inbox súhrnom napísaným AI, takže ten, kto si ju vezme, číta odsek namiesto celého vlákna. Každé nastavenie handoffu má vlastný postup v návode Human Handoff.

Operátor pracuje v Inboxe. Člen nikdy neopustí Discord.

Priraďte si konverzáciu a odpovedzte v composer v Inboxe. Táto odpoveď sa doručí priamo späť do Discord kanála, v ktorom už člen hovorí. Nepotrebuje u vás účet, e-mailové vlákno ani prihlásenie do portálu. AI zostane ticho od momentu, keď konverzáciu vlastní človek, takže nesúťažíte s vlastným botom.

Rovnaký kanál, s odstupom troch dní. Agent odmietol a eskaloval; správu pod oddeľovačom napísal človek v Quickchat AI Inbox. Všimnite si, že prichádza pod menom vášho bota, pretože váš bot je jediná identita, cez ktorú nám Discord dovolí publikovať.

Rovnaká konverzácia z vašej strany. Odmietnutie Agenta, dve Action volania za ním, odpoveď operátora nižšie a panel detailov, ktorý už vie, že kanál je Discord a téma je single sign-on.

Medzitým súkromné ticket vlákno zostáva tam, kde hovorí váš tím: je to pracovný priestor s členom vo vnútri a pingnutou support rolou. Odpoveď sa vracia tam, kde bola položená otázka.

Šesť krokov. Tri z nich sú Discord zápisy a všetky tri nastanú iba preto, že odpoveď chýbala.

Otestujte to oboma spôsobmi

Predtým, než sa na to spoľahnete, spustite obe cesty a najdôkladnejšie testujte poctivé zlyhanie.

Pokrytá otázka. @mentionnite bota v kanáli, ktorý vidí, a opýtajte sa niečo, čo vaša znalostná báza pokrýva. Mali by ste dostať skutočné kroky v kanáli a žiadne vlákno nikde. Toto je prípad, ktorý šetrí čas vášmu tímu, a po zlepšení dokumentov bude tvoriť väčšinu prevádzky.

Nepokrytá otázka. Opýtajte sa na vec, ktorú vaše dokumenty nepokrývajú. Agent by to mal povedať a potom eskalovať. V tom istom momente sa objaví ticket:

Vlákno, ktoré Agent otvoril. Pomenoval ho podľa problému, pridal člena, pingol rolu a sám napísal súhrn.

A vlákno je skutočne súkromné, čo dokazuje jeho vlastný zoznam členov:

Ticket je súkromné vlákno. Support konverzácie neprebiehajú verejne.

Testujte naprieč celou konverzáciou, nie jednou správou. Ochrana pred duplicitami ukáže hodnotu až v druhom turne, keď člen pridá detail a naivný bot otvorí druhý ticket.

Jedna vec, ktorú run conditions nepokrývajú. Zastavia volanie mimo poradia, ale nededuplikujú retry: ak ručne znova spustíte notify Action, uverejní druhú správu. Oplatí sa to vedieť pred experimentovaním na živom tickete.

Ak chcete skontrolovať veľa formulácií naraz bez ich písania do Discordu, použite Simulations pod Testing: vytvorte dataset zákazníckych správ, spustite ho proti skutočnému Agentovi a prečítajte vyhodnotené výsledky spolu. Miešajte pokryté a nepokryté otázky v jednom datasete, pretože tieto dve cesty zlyhávajú rôzne.

Šesť otázok, štyri pokryté a dve nie, hodnotené v jednom behu. Riadky 5 a 6 sú poctivé zlyhania a skórujú rovnako vysoko ako odpovede.

Napíšte hodnotiace kritériá pre grader, ktorý vidí iba transcript, pretože to je všetko, čo dostane. Inak vás budú stáť dve veci, ktoré nevidí. Nevidí Discord side effect, takže ak mu to nepoviete, bude čítať „otvoril som vám ticket“ ako vymýšľanie schopnosti Agentom. A nevidí vašu znalostnú bázu, takže správnu, konkrétnu odpoveď označí za vymyslenú jednoducho preto, že nevie overiť číslo. Obe stoja za jednu vetu v kritériách a obe znižujú hodnotenie vášho najlepšieho správania, ak ich vynecháte.

Ako zastavíte, aby bot otváral príliš veľa ticketov?

Toto je jediné ladenie, ktoré väčšina serverov potrebuje, a väčšinou to nie je problém promptu.

Objem ticketov je problém znalostnej bázy. Každá medzera vo vašich dokumentoch sa stane ticketom. Ak bot eskaluje viac, než ste čakali, čítajte tickety: sú zoznamom otázok, na ktoré vaša dokumentácia neodpovedá. Uzavretie týchto medzier priamo znižuje objem.

Insights vám povie, čo dokumentovať ďalej. Quickchat AI zoskupuje konverzácie podľa témy, takže vidíte, ktoré otázky sa objavujú najčastejšie, namiesto hádania. Opravte tri najčastejšie témy vo svojej znalostnej báze a sledujte, ako miera eskalácie klesá.

Nikto ich nekonfiguroval. Pod Insights, Advanced ich AI-Detected Topics pomenovali zo samotných konverzácií a počty sú backlog dokumentácie v poradí priorít.

Tento zoznam je celá slučka ladenia. Pricing a API kľúče sa objavovali najviac, takže tieto články sa napíšu ako prvé, a graf budúci týždeň ukáže, či to fungovalo. Témy vyššie sú objavené za vás; môžete si definovať aj vlastné pod Manage Topics, ak chcete zámerne sledovať konkrétnu produktovú oblasť. Pozrite AI-Detected Topics, Conversation Topics a managing topics v dokumentácii.

Ak eskaluje príliš ochotne, sprísnite popis Action tak, aby sa spustila iba po tom, čo Agent členovi povedal, že informáciu nemá. Ak eskaluje príliš zriedka a začne hádať, posilnite riadok „nehádaj a nevymýšľaj si kroky“ v hlavnom prompte.

Je bezpečné spustiť to na verejnom serveri?

Bot, s ktorým môže hovoriť ktokoľvek vo verejnom kanáli, si zaslúži dôkladnú kontrolu. Tohto bota chráni konfigurácia, ktorú môžete čítať v editore, nie formulácia promptu, preto platí bez ohľadu na to, ako je správa formulovaná.

Člen môže hovoriť s modelom. Nemôže obísť stredný stĺpec.

Každá ticket Action vyžaduje skutočný Discord turn z vášho servera. Dve z troch run conditions na každej Action kontrolujú, že správa skutočne prišla cez Discord integráciu a že prišla zo servera, ktorý ste vybrali pri inštalácii. Tieto hodnoty vytvára integrácia, nie správa, a verejný chat ani API správa ich nemôže dodať ani zdediť staršiu uloženú kópiu. Nasmerujte verejné API svojho Agenta na tieto Actions a odmietnu sa.

Action, ktorá pridáva niekoho do súkromného vlákna, nemá žiadne parametre upraviteľné modelom. Jej URL končí ID člena, ktoré integrácia dodala pre aktuálnu správu. Agent nemôže odovzdať iné, takže nemôže pritiahnuť ľubovoľného člena vášho servera do ticketu niekoho iného.

Mentions sú uzamknuté pri inštalácii. Notify Action odosiela explicitný zoznam mentions obsahujúci člena, ktorý sa pýtal, a rolu, ktorú ste vybrali, s vypnutým parsingom. Mention, ktorý Agent náhodou napíše do issue summary, sa nerozlíši a @everyone sa nikdy nemôže spustiť. Toto sa oplatí overiť, nie len veriť, a platí to: role ping aj user mention prídu a doslovné @everyone v tej istej správe neurobí nič.

Vlákna sú súkromné a nie sú invitable. Vytvárajú sa ako type: 12 s invitable: false, takže člen pridaný do ticketu doň nemôže priviesť nikoho ďalšieho.

Bot nemôže moderovať. Nemá oprávnenie Kick, Ban ani Timeout. Najhorší výsledok toho, že člen presvedčí Agenta urobiť niečo, čo by nemal, je ticket vlákno, ktoré by mohol otvoriť normálnou otázkou.

Token sa nikdy neodhalí. Žije ako System Token, vkladá sa pri odoslaní a rediguje sa všade, kde sa volanie zaznamenáva.

Jednu vec rozhodnite vedome: ticket vlákna sú súkromné, ale ktokoľvek s vašou support rolou ich môže čítať, čo je to, čo pre support chcete, a oplatí sa to vedieť, ak členovia môžu vkladať citlivé údaje. Pri skutočne dôverných veciach ich nasmerujte na e-mail.

Koľko stojí Discord AI support bot?

Plán Free zahŕňa AI Actions, Human Handoff, znalostnú bázu, Topics a Insights, s 50 AI credits mesačne na osobné, nekomerčné použitie. Firemné použitie vyžaduje platený plán; platené plány poskytujú aj viac AI credits. Ak to porovnávate s vlastnou prevádzkou, free AI Discord bots úprimne porovnáva self-hosted cestu vrátane hodín, ktoré stojí.

Keď obe cesty prejdú, pustite Agenta do prevádzky:

1. Nasmerujte členov na bota. Povedzte v topic kanála, že ho môžu @mentionnúť. Bot, o ktorom nikto nevie, nič neodkloní.
2. Sledujte prvý deň. Každá Action uchováva call log s presnou požiadavkou a odpoveďou a Inbox obsahuje každú konverzáciu, takže vidíte, na čo odpovedal a čo eskaloval.
3. Čítajte prvé tickety ako backlog dokumentácie. Sú to otázky, na ktoré vaše dokumenty ešte neodpovedajú.

Ten istý Agent funguje aj všade inde. Znalostná báza, prompt a Human Handoff patria Agentovi, nie Discordu, takže ten istý support bot odpovedá vo vašom website widget, v Slack, na WhatsApp a cez e-mail, a každá konverzácia pristane v tom istom Inboxe. Tri ticket Actions sú jediná časť tejto konfigurácie špecifická pre Discord. Ak váš tím žije v Slacku namiesto Discordu, pošlite handoff notifikáciu tam namiesto pingnutia Discord roly.

Čo ďalšie môže váš Discord AI Agent robiť?

Tá istá galéria obsahuje kategóriu Moderation: timeout, kick, ban, unban, assign role, slowmode a announcements. Každá z nich sa inštaluje s run condition author_is_admin is true, takže ich môže spustiť iba administrátor servera, a tento flag pochádza z Discordu, nie z konverzácie. Je to iný bot s iným rizikovým profilom a má vlastný návod: Build an AI Discord moderation bot.

Akýkoľvek iný Discord endpoint používa rovnaký recept: HTTP Request Action s hlavičkou Authorization: Bot {{discord_bot_token}}, parameter alebo dva a plain-language popis, ktorý rozhoduje, kedy ju Agent spustí. Build an AI Agent that takes actions je začiatočnícka verzia tejto myšlienky a Connect your AI Agent to any API pokrýva všeobecný prípad.

Nie každý Discord bot je support bot. Ten istý Agent môže namiesto toho prevádzkovať postavu: Discord AI roleplay bot používa tú istú znalostnú bázu a pamäť pre persony namiesto ticketov a kompletné vytvorenie postavy prechádza prompt persony, kánon a nastavenia, ktoré ju držia v charaktere.

Appendix: presné požiadavky

Tieto nikdy nepíšete, ale oplatí sa ich raz prečítať a sú tým, čo by ste ručne vytvorili voči akejkoľvek inej platforme. Hodnoty {{...}} vypĺňa Quickchat AI pri odoslaní.

1. Otvoriť súkromné vlákno

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 je to, čo robí vlákno súkromným. auto_archive_duration je v minútach, takže 1440 archivuje tichý ticket po jednom dni. Save to memory zachytí $.id ako discord_ticket_thread_id.

2. Pridať člena, ktorý sa pýtal

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

Žiadne body a žiadne parametre. Obe ID prichádzajú z pamäte a z integrácie.

3. Upozorniť support tím

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}}> your ticket is open. <@&YOUR_SUPPORT_ROLE_ID> new ticket: {{issue_summary}}",
  "allowed_mentions": { "parse": [], "users": ["{{metadata_discord_author_id}}"], "roles": ["YOUR_SUPPORT_ROLE_ID"] }
}

Dva detaily stoja skutočný čas debugovania, ak to staviate sami. Auth schéma je Bot, nie Bearer, čo je najčastejšia chyba pri ručnom volaní Discordu. A v allowed_mentions je to, čo chcete, prázdne parse spolu s explicitnými zoznamami users a roles: blokuje @everyone, ale prepustí vaše dve zamýšľané mentions. Neprázdne parse vedľa explicitného zoznamu rovnakého typu je priamo odmietnuté s 400 MESSAGE_ALLOWED_MENTIONS_PARSE_EXCLUSIVE.

Súvisiace návody

• Create an AI Discord bot, nastavenie, ktoré tento návod predpokladá
• Build an AI Discord moderation bot, tá istá galéria zameraná na moderovanie
• The best AI Discord bots, porovnanie možností
• Free AI Discord bots, čo vás self-hosting skutočne stojí
• Discord AI roleplay bot, ten istý Agent namiesto toho prevádzkuje postavu
• Connect your AI Agent to HubSpot, tá istá one-click galéria pre CRM
• Make your AI Agent’s actions reliable, run conditions a pamäť do hĺbky
• Connect your AI Agent to any API, všeobecný recept
• How to build a chatbot knowledge base, polovica, ktorá rozhoduje o objeme ticketov
• Product tutorial: Human Handoff, vysvetlenie každého nastavenia handoffu

Často kladené otázky

Ako nastavím ticket bota v Discorde?

Pripojte vlastnú Discord app v External Apps, dajte Agentovi znalostnú bázu, potom otvorte Actions and MCPs, kliknite na Add Action, vyberte Discord Action a zvoľte Open Support Ticket. Z rozbaľovacích zoznamov vyberte server, ticket kanál a support rolu a kliknite na Install and enable. Nie je čo hostovať a v Discorde nie je čo konfigurovať okrem vytvorenia kanála a roly.

Ako vytvorím Discord ticket bota?

Vytvorte Quickchat AI Agenta, pripojte vlastnú Discord app, potom otvorte Actions and MCPs, kliknite na Add Action, vyberte Discord Action a zvoľte Open Support Ticket. Z rozbaľovacích zoznamov vyberiete server, ticket kanál a support rolu, kliknete na Install and enable a Quickchat AI za vás napíše tri kompletné AI Actions. Najprv dajte Agentovi znalostnú bázu, pretože tá rozhoduje, koľko ticketov otvorí.

Môže AI odpovedať na support otázky v Discorde?

Áno. Agent prehľadá vašu znalostnú bázu a odpovie v kanáli, keď nájde odpoveď. Deflection sleduje pokrytie: otázky, ktoré vaše dokumenty pokrývajú, dostanú odpoveď, a otázky, ktoré nepokrývajú, sa stanú ticketmi. Tento vzťah je najdôležitejšia vec pri prevádzke tohto bota.

Potrebujem kód na vytvorenie tohto Discord ticket bota?

Nie. Vyberiete šablónu z Discord galérie, z rozbaľovacích zoznamov vyberiete server, kanál a rolu a Quickchat AI na backende napíše metódu, URL, hlavičky, body, parametre, nastavenia odpovede a run conditions. Nikdy nepíšete Discord ID a nikdy neupravujete JSON.

Koľko Actions šablóna nainštaluje?

Tri. Jedna otvorí súkromné vlákno vo vašom ticket kanáli a uloží jeho ID do pamäte, jedna pridá člena, ktorý sa pýtal, a jedna uverejní súhrn, ktorý spomenie vašu support rolu. Prídu už zapnuté a navzájom prepojené.

Ako bot vie, kedy má otvoriť ticket?

Rozhodujú o tom dve veci. Popis Action hovorí Agentovi, aby ju zavolal iba vtedy, keď odpoveď nie je v znalostnej báze, a run condition robí sekvenciu deterministickou: vlákno ešte nesmie existovať, aby sa mohlo otvoriť, a musí existovať, aby mohli bežať následné kroky.

Môže bot otvoriť duplicitné tickety?

Nie v tej istej konverzácii. Open Support Ticket má run condition, ktorá vyžaduje, aby v pamäti ešte nebolo ID ticket vlákna, takže keď už jeden ticket existuje, Agent nemôže v tejto konverzácii otvoriť druhý bez ohľadu na prompt.

Môže človek prevziať konverzáciu?

Áno. Human Handoff označí konverzáciu vo vašom Quickchat AI Inbox súhrnom napísaným AI. Priraďte si ju, napíšte odpoveď v Inboxe a tá príde do toho istého Discord kanála, v ktorom už člen je. Člen nikdy neopustí Discord a nikdy u vás nepotrebuje účet.

Prečo ticket bot potrebuje moju vlastnú Discord app?

Ticket Actions volajú Discord API ako váš bot, takže potrebujú token vášho bota. Zdieľaný one-click Quickchat AI bot vie odpovedať na otázky a používať Google Sheets Actions. Jeho Discord token nie je dostupný pre vaše private-ticket Actions. V External Apps otvorte Discord a vyberte Advanced setup, čo trvá približne desať minút.

Aké Discord oprávnenia bot potrebuje?

View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads a Manage Threads v ticket kanáli. Support bot nepotrebuje oprávnenie Kick, Ban ani Timeout, a oprávnenie, ktoré nemá, je oprávnenie, o ktorom nikdy nemusíte uvažovať.

Prečo moja support rola chýba v rozbaľovacom zozname?

Role picker uvádza iba roly, ktoré Discord hlási ako mentionable, a vylučuje @everyone. Ak vaša support rola nie je nastavená ako mentionable v Server Settings, Roles, nezobrazí sa, pretože šablóna by ju nevedela pingnúť.

Je bezpečné spustiť Discord ticket bota na verejnom serveri?

Kontroly sú konfigurácia, nie formulácia promptu, takže platia bez ohľadu na to, ako je správa napísaná. Každá ticket Action vyžaduje, aby turn skutočne prišiel z Discordu a zo servera, ktorý ste vybrali, Action, ktorá pridáva niekoho do súkromného vlákna, nemá žiadne parametre upraviteľné modelom, mentions sú uzamknuté na člena, ktorý sa pýtal, a rolu, ktorú ste vybrali, a vlákna sú súkromné a nie sú invitable. Run conditions sa kontrolujú predtým, než akákoľvek požiadavka opustí Quickchat AI.

Koľko stojí Discord AI support bot?

Free plán zahŕňa 50 AI credits mesačne na osobné, nekomerčné použitie. AI Actions, Human Handoff, znalostná báza, Topics a Insights sú zahrnuté. Firemné použitie vyžaduje platený plán; platené plány poskytujú aj viac AI credits.

Aký je rozdiel medzi týmto a Ticket Tool alebo TicketsBot?

Tie sú založené na pravidlách. Člen klikne na tlačidlo Create Ticket na pripnutom paneli a ticket sa otvorí vždy, aj pri otázke, na ktorú vaše dokumenty už odpovedajú. Tento bot najprv odpovie a eskaluje iba to, čo skutočne nevie vyriešiť, takže váš tím číta otázky, ktoré naozaj potrebujú človeka.

Môžu ChatGPT, Claude alebo Gemini prevádzkovať Discord ticket bota?

Áno, cez Quickchat AI. Váš Agent beží na najnovších modeloch a volá Discord API pomocou týchto AI Actions, takže odpovedá z vašej znalostnej bázy a otvára skutočné súkromné vlákna. Vy rozhodujete, ktoré Actions existujú a čo bot môže robiť.

Môže ten istý Agent fungovať aj na iných kanáloch než Discord?

Áno. Znalostná báza, prompt a Human Handoff patria Agentovi, nie Discordu, takže ten istý support bot odpovedá vo vašom webovom widgete, v Slacku, na WhatsApp a cez e-mail. Tri ticket Actions sú jediná časť tejto konfigurácie špecifická pre Discord.

Ako členovia začnú konverzáciu s botom?

Ticket bot v tomto návode používa vašu vlastnú Discord app, takže členovia začnú tým, že ho @mentionnú v kanáli, ktorý vidí. Agent odpovie v tom istom kanáli a otvorí ticket vlákno iba vtedy, keď nevie odpovedať. Príkaz /ask patrí zdieľanému one-click Quickchat AI botovi.

Ako zastavím, aby bot otváral príliš veľa ticketov?

Najprv zlepšite pokrytie znalostnej bázy, pretože každá medzera sa stane ticketom. Čítajte prvé tickety ako backlog dokumentácie a použite Insights, aby ste videli, ktoré témy sa objavujú najčastejšie, takže budete vedieť, čo napísať ďalej. Až potom sprísnite popis Action.

Môžem upraviť Actions, ktoré galéria nainštaluje?

Každé pole. Sú to obyčajné HTTP Request Actions bez ničoho, čo by ich označovalo ako špeciálne: žiadny zámok, žiadny odznak, žiadna samostatná policy vrstva. Zmeňte URL, body, popis alebo run conditions, alebo nainštalujte druhú kópiu a upravte tú.

Môžem prevádzkovať Discord ticket systém bez helpdesku?

Áno. Ticket je súkromné Discord vlákno a front je váš Quickchat AI Inbox, takže v procese nie je Zendesk, Intercom ani Jira a nie je čo migrovať. Ak už helpdesk používate, môžete si ho nechať: ten istý Agent tam môže vytvoriť ticket ďalšou AI Action a HubSpot gallery robí presne to.

Môže bot odpovedať z obsahu nášho help centra?

Na tom je postavený. Vložte URL svojho help centra a Quickchat AI zoškrabe stránky do znalostnej bázy, alebo nahrajte súbory a vložte články priamo. Agent tieto články prehľadá pri každej otázke a odpovie v kanáli, keď nájde odpoveď, takže vaša existujúca dokumentácia sa stane botom bez prepisovania. Create an AI support agent from your documentation samostatne prechádza túto polovicu.

Môže bot pozdraviť člena, keď sa otvorí ticket kanál?

Áno, samostatnou funkciou. Ticket bot, napríklad Ticket Tool, vytvorí kanál a automated message New channel v Quickchat AI doň o pár sekúnd neskôr uverejní pevný pozdrav, takže člen hneď vidí, že má s čím hovoriť. Nestojí to žiadne credits, pretože sa nevolá žiadny model. Pozdravte členov, vlákna a ticket kanály to nastaví.

Ako meriam ticket deflection?

Deflection je podiel otázok zodpovedaných bez ticketu, takže v tejto konfigurácii sú to konverzácie bez ticket vlákna vydelené všetkými konverzáciami. Každá Action uchováva call log, takže spočítanie volaní open_support_ticket vám priamo dá eskalovanú polovicu a Insights zoskupí zvyšok podľa témy. Sledujte to po témach, nie ako jedno číslo: klesajúca miera pri jednej téme je medzera v dokumentácii, ktorú môžete uzavrieť. Chatbot analytics pokrýva širšiu sadu metrík.

Zhrnutie

So znalostnou bázou a jedným kliknutím sa Quickchat AI Agent stane support botom prvej línie pre váš Discord server: odpovedá na otázky, ktoré vaše dokumenty pokrývajú, prizná, keď ich nepokrývajú, otvorí súkromné ticket vlákno pre zvyšok, pridá člena, upozorní support rolu súhrnom, ktorý sám napísal, a odovzdá konverzáciu človeku, ktorý odpovie z vášho Inboxu bez toho, aby člen niekedy opustil Discord. Galéria napíše tri Actions, rozbaľovacie zoznamy znamenajú, že nikdy nepíšete Discord ID, a run conditions znamenajú, že sekvencia drží aj vtedy, keď konverzácia nejde podľa plánu. Zostáva práca, ktorú môžete urobiť iba vy: znalostná báza, z ktorej sa oplatí odpovedať.