AI Discord ticket bot: nejdřív odpověď, potom eskalace

Quickchat AI odpovídá na support otázky na tvém Discord serveru z tvojí vlastní dokumentace a otevře soukromé ticket vlákno jen tehdy, když odpovědět neumí. Tento návod tě provede vytvořením takového bota od začátku do konce, bez kódu, přibližně za půl hodiny.

Výsledek se chová jako dobrý agent první linie. Člen se zeptá, jak resetovat API klíč, a dostane skutečné kroky v kanálu. Člen se zeptá na něco, co dokumentace nepokrývá, a bot místo hádání řekne, že informaci nemá, otevře soukromé vlákno, přidá do něj člena, pingne support roli jednořádkovým shrnutím a předá konverzaci člověku, který může odpovědět z tvého Inboxu.

Vyber úlohu pro svého Discord bota

Toto řešení odpovídá na support otázky a eskaluje mezery v dokumentaci. Pro pevné pozdravy zvol návod pro welcome bota, pro administrátorské příkazy zvol návod pro moderaci.

Potřebuješ dvě věci:

• Quickchat AI Agenta (vytvoř si účet)
• Discord server, kde jsi admin

Od registrace k prvnímu support testu

1. Pokud se registruješ e-mailem a heslem, otevři ověřovací odkaz v e-mailu. V nastavení popiš Discord support Agenta, klikni na Create my AI Agent a dokonči kroky nastavení, včetně výběru plánu pro zamýšlené použití.
2. Přidej dokumentaci pod Knowledge Base. V External Apps otevři Discord, potom Use your own Discord app a zvol Advanced setup. Sdílený one-click bot umí odpovídat na otázky, ale neumí spouštět ticket Actions v tomto návodu.
3. V testovacím serveru vytvoř ticket kanál a mentionable support roli. V Actions and MCPs klikni na Add Action, zvol Discord Action a nainstaluj Open Support Ticket s daným serverem, kanálem a rolí.
4. Po použití instrukcí pro Agenta níže @zmiň bota s otázkou, na kterou dokumentace odpovídá, a potom s otázkou, na kterou ne. První by měla dostat odpověď bez ticketu; druhá by měla otevřít jedno soukromé vlákno a upozornit support roli. Přidej follow-up do druhé konverzace a ověř, že se neotevře duplicitní ticket.

Free plán je pro osobní, nekomerční použití. Před použitím bota pro firmu zvol placený plán. Než pozveš zákazníky, dokonči test obou cest.

Snímky níže pocházejí z testovacího Agenta s názvem Lumen, support bota pro fiktivní firmu na produktovou analytiku s názvem Beacon. Firma je vymyšlená, aby příklad zůstal neutrální, ale každá konverzace, každé API volání a každé ticket vlákno zobrazené zde bylo vytvořené skutečným Agentem, který běžel ve skutečné reply pipeline proti skutečnému Discord serveru.

Co vytvoříš

Jedno rozhodnutí na otázku. Na úspěšné cestě se do Discordu nezapíše vůbec nic.

Eskalaci provádějí tři AI Actions a Quickchat AI nainstaluje všechny tři z jedné karty galerie:

Co je knowledge base a proč určuje objem ticketů?

Pokud jsi AI Agenta ještě nevytvářel, toto je koncept, kterému se vyplatí věnovat dvě minuty.

Knowledge base je tvoje vlastní dokumentace nahraná do Agenta a zaindexovaná tak, aby se v ní dalo hledat během konverzace. Můžeš Quickchat AI nasměrovat na URL nápovědy a nechat ho stránky nascrapovat, vložit články ručně nebo nahrát soubory. Při odpovědi ji Agent prohledá a odpoví z toho, co najde, ne z toho, co si základní model náhodou pamatuje o světě. Pokud začínáš od nuly, jak vytvořit chatbot knowledge base popisuje, co psát a v jakém pořadí.

Všechno, co dokumentace pokrývá, dostane odpověď. Všechno ostatní se stane ticketem.

To je hlavní páka tohoto řešení. Deflection není trik v promptu a není to schopnost modelu: je to tvoje pokrytí. Pokud bot eskaluje víc, než jsi čekal, tickety ti říkají, které stránky ještě nemáš napsané.

Ilustrační, ne měřené. Důležitý je směr: psaní dokumentace má zde největší dopad.

Může AI opravdu odpovídat na support otázky na Discordu?

U otázek, které dokumentace pokrývá, ano, a skutečnými kroky, ne parafrází. Tady je případ deflection z testovacího serveru, bez úprav:

Odpovězeno v kanálu, z článku v knowledge base. Ticket nebyl vytvořen, protože nebyl potřeba.

Zajímavější je druhá polovina, co se stane, když odpověď chybí. Bot to řekne:

Poctivé selhání. Knowledge base Beaconu záměrně vynechává enterprise SSO, takže toto je cesta, která otevře ticket.

Agent, který si vymyslí věrohodný postup SSO, je horší než Agent, který otevře ticket, takže se vyplatí toto chování záměrně otestovat, ne v něj jen doufat. Vrátíme se k tomu v části testování.

Dva způsoby připojení Discordu a proč tickety potřebují druhý

Quickchat AI má dvě Discord připojení a rozdíl je důležitý ještě před začátkem.

Pro veřejnou frontu zpětné vazby, která funguje se sdíleným botem, viz workflow pro zpětnou vazbu a mezery v dokumentaci. Níže uvedené private-ticket Actions potřebují credential tvého vlastního Discord bota.

One-click je rychlá cesta. V External Apps otevřeš Discord, klikneš na Add to your Discord server, autorizuješ ho a sdílený Quickchat AI bot je asi za minutu aktivní na tvém serveru. Odpovídá, když ho členové @zmíní nebo použijí /ask, a pro mnoho serverů je to celé zadání.

Můžeš ho pojmenovat. Před autorizací je tam pole Bot name in the new server, předvyplněné jménem tvého Agenta, a každý připojený server má vlastní pole Bot name in this server, které můžeš později změnit. Je to Discord přezdívka, takže platí pro konkrétní server a má limit 32 znaků. Když ji vymažeš, bot se vrátí na Quickchat AI. Sdílený zůstává avatar a základní @username, protože jedna Discord aplikace obsluhuje každý server, který ji nainstaluje.

One-click neznamená generický. Bot přenese jméno tvého Agenta na server a později ho můžeš pro každý server změnit.

Advanced setup registruje tvoji vlastní Discord aplikaci. V developer portálu Discordu vytvoříš bota a jednou vložíš jeho token do Quickchat AI. Zabere to asi deset minut a získáš vlastní avatar a @username, direct messages, několik botů na jednom serveru a věc, kterou tento návod potřebuje: Discord API Actions.

Důvod je lepší říct přímo, ne ho brát jako zvláštnost. Ticket Actions v tomto návodu volají Discord API jako tvůj bot, pomocí credential, který Quickchat AI vloží do požadavku při odeslání. Token sdíleného one-click bota patří sdílenému botovi, ne tobě, takže není dostupný pro odesílání tvých Actions. Pokud otevřeš Discord galerii bez připojené vlastní aplikace, řekne ti to a karty vypne, místo aby tě nechala vytvořit něco, co nemůže běžet.

External Apps je místo, kde začínají obě cesty. Advanced setup je ve zvýrazněném bloku dole v Discord panelu.

Co potřebuješ před začátkem

Připoj vlastní Discord aplikaci. V External Apps otevři Discord, najdi Use your own Discord app a zvol Advanced setup. V developer portálu Discordu vytvoř aplikaci a bota, zapni Message Content Intent, nech Require OAuth2 Code Grant vypnuté a vlož token bota. Quickchat AI ho validuje během psaní. Návod Create an AI Discord bot podrobně popisuje část v portálu, pokud jsi ji ještě nedělal.

Dej botovi jen to, co support bot potřebuje. V ticket kanálu: View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads a Manage Threads. Nepotřebuje oprávnění Kick, Ban ani Timeout a v testovacím serveru je záměrně nemá. Support bot nemá důvod moderovat a oprávnění, které nemá, nikdy nemusíš řešit.

V Discordu vytvoř dvě věci, na které budou Actions ukazovat. Tato část se děje v Discord klientu, ne v Quickchat AI, a je to jediné nastavení, které tam děláš:

1. Kanál, kde se budou otevírat tickety. Stačí libovolný textový kanál. Použij + vedle seznamu kanálů nebo znovu použij existující. V testovacím serveru je to #support.
2. Roli, kterou chceš upozornit při otevření ticketu. Server Settings, potom Roles, potom Create Role. V testovacím serveru je to @support.

Tři místa a jen jedno z nich je veřejné.

Obě věci se vrátí v Step 3. Když instaluješ ticket šablonu, Quickchat AI načte tvůj server živě z Discordu a zobrazí tři rozbalovací seznamy, jedním z nich je Role picker se seznamem nalezených rolí. Support roli vybereš tam, místo abys kdekoli psal ID.

Role picker v Step 3. Čte seznam z Discordu, takže role, kterou vytvoříš teď, se tu za chvíli objeví.

Detail, který tě zastaví, pokud ho přeskočíš: tento picker zobrazuje jen role, které Discord hlásí jako mentionable, a vynechává @everyone. Pokud tvoje support role není nastavená jako mentionable, v rozbalovacím seznamu se prostě neobjeví a nic nevysvětlí proč. Filtr je záměrný, protože celým úkolem šablony je tuto roli pingnout. Nastav to při vytváření role a na problém nenarazíš:

Server Settings, Roles, vyber support roli a zapni toto pod Display. Bez toho se role nikdy nedostane do pickeru.

Jak se bot rozhodne odpovědět nebo otevřít ticket?

Většina Discord ticket botů se o ničem nerozhoduje. Ticket Tool, TicketsBot a další zveřejní připnutý panel s tlačítkem Create Ticket nebo zaregistrují slash command. Člen na něj klikne, otevře se ticket a tým ho čte. Je to dobrý a zcela předvídatelný návrh, ale znamená to, že deset lidí, kteří se tento týden ptali, jak resetovat API klíč, vytvořilo deset ticketů.

Stejných deset otázek. Rozdíl je v tom, co tvůj tým nakonec čte.

Answer-first bot si před rozhodnutím přečte dokumentaci. A když eskaluje, otevření jednoho ticketu vyžaduje přesně čtyři údaje:

• ve kterém kanálu se vlákno otevře
• ze kterého serveru otázka přišla
• kdo se ptá, aby mohl být přidán do vlákna
• jak se ticket jmenuje a jednořádkové shrnutí problému

Zajímavé je, že tyto čtyři údaje přicházejí třemi úplně různými způsoby a jen poslední píše AI:

Nikdy nepíšeš Discord ID a model nikdy nevidí tvůj kanál ani tvoji roli.

Ty, které vybereš jednou. Tvůj ticket kanál a support role. Vybereš je z rozbalovacích seznamů při instalaci šablony a Quickchat AI je zapíše do Action. Model je nikdy nevidí a nemůže je změnit.

Ty, které dodává Discord. S každou přeposlanou zprávou Discord integrace říká Quickchat AI, ze kterého serveru přišla a kdo mluví, jako {{metadata_discord_guild_id}} a {{metadata_discord_author_id}}. Token tvého bota dorazí stejným způsobem jako System Token vložený při odeslání a redigovaný všude, kde se volání loguje. Nic z toho nepíše model a nic z toho nemůže dodat veřejný chat ani API zpráva.

Ty, které píše Agent. Předmět ticketu a jednořádkové shrnutí problému. To jsou jediné úsudkové kroky v celém řešení, proto je pozdější ladění krátké.

Step 1: Vytvoř Agenta a dej mu knowledge base

Vytvoř Agenta, potom otevři Knowledge Base a přidej dokumentaci. Vlož URL nápovědy a nech Quickchat AI ji nascrapovat, nebo piš články přímo. Create an AI support agent from your documentation podrobně popisuje cestu se scrapingem.

Knowledge base Beaconu: reset API klíče, prázdný dashboard, instalace tracking snippet, plány a fakturace a export dat.

Dokumentace Beaconu záměrně nepokrývá jednu věc: nastavení enterprise SSO. Tato mezera není přehlédnutí v tutoriálu, je to pointa. Každá support knowledge base má otázky, na které neodpovídá, a celá hodnota tohoto bota je v tom, co udělá, když na takovou otázku narazí. SSO je touto otázkou v celém návodu.

Členové se k tvému vlastnímu botovi dostanou tím, že ho @zmíní v kanálu, který vidí. Není potřeba nic registrovat. Příkaz /ask je dostupný u sdíleného one-click Quickchat AI bota.

Step 2: Řekni Agentovi, kdy má odpovědět a kdy eskalovat

Instrukce Agenta patří do AI Main Prompt na Identity. Vlož toto, upravené pro svoji firmu:

Jsi Lumen, support asistent pro Beacon, hostovaný nástroj produktové analytiky pro softwarové týmy. Odpovídáš na otázky zákazníků v komunitním Discordu Beaconu.
Kdykoli můžeš, odpovídej ze své Knowledge Base. Odpovědi drž krátké a praktické, dvě nebo tři věty, a uveď konkrétní kroky.
Pokud otázka není pokrytá ve tvé Knowledge Base, nehádej a nevymýšlej kroky. Jasně řekni, že tuto informaci nemáš, potom otevři support ticket:
1. Zavolej open_support_ticket jednou, s krátkým 2 až 4slovným ticket_subject popisujícím problém.
2. Potom zavolej add_ticket_requester, aby se zákazník dostal do vlákna.
3. Potom zavolej post_in_ticket s jednořádkovým issue_summary toho, na co se zákazník ptal.
Potom zákazníkovi řekni, že ticket je otevřený a tým se ozve v novém vlákně.
Nikdy se zákazníka neptej na jeho Discord ID, ID kanálu ani ID vlákna. Ty se vyplní za tebe.

AI Main Prompt na Identity. Je to stále dostupné pole, ne samostatný seznam pravidel.

Dvě řádky v tomto bloku nesou zátěž. “Nehádej a nevymýšlej kroky” mění mezeru ve znalostech v poctivou odpověď místo věrohodné smyšlenky. A pojmenování tří Actions v pořadí vede Agenta k tomu, aby je volal jako sekvenci, ne aby si jednu vybral.

Pořadí je popsané v promptu, ale není vynucené jen tam, o tom jsou další dvě části.

Step 3: Nainstaluj ticket Actions jedním kliknutím

Otevři Actions & MCPs, klikni na Add Action a zvol Discord Action.

Discord Action je mezi ostatními one-click galeriemi.

Galerie se otevře s Discord šablonami seskupenými podle úlohy: Support & Tickets obsahuje tu, kterou používá tento návod, a Moderation obsahuje dalších sedm.

Osm karet. Open Support Ticket je jediná, která se tě na něco ptá.

Vyber Open Support Ticket a otevře se krátký konfigurační krok. Je to jediný formulář v celém řešení:

Tři rozbalovací seznamy a dialog předem říká, co nainstaluje.

Seznamy přicházejí živě z Discordu a jsou filtrované na to, co může skutečně fungovat. Kanály jsou jen textové kanály:

Vyber kanál, pod kterým se mají otevírat tickety. Vlákna se vytvářejí uvnitř něj.

A role jsou jen mentionable role, s vyloučeným @everyone:

Toto je filtr, který skryje support roli, kterou jsi ještě nenastavil jako mentionable.

Tři volby a formulář je hotový:

Celá konfigurace. Server, kanál, role a jediné tlačítko, na kterém záleží.

Klikni na Install and enable. Quickchat AI vytvoří tři Actions na backendu, v jedné transakci, už aktivní.

Tři karty, zapnuté, s ikonou Discordu. Nic dalšího nevyplňuješ.

Když už tu jsi, stojí za to vědět dvě věci o sedmi moderačních šablonách. Nepotřebují žádnou konfiguraci, protože server, člena, roli nebo kanál berou ze samotného Discord požadavku, takže kliknutí na kartu je nainstaluje okamžitě. A když šablonu nainstaluješ dvakrát, dostaneš druhou upravitelnou kopii, ne chybu, což je rozumný způsob, jak vytvořit variantu.

Co to jedno kliknutí skutečně vytvořilo?

Vyplatí se tomu rozumět, i když jsi to nemusel psát, protože tady žije všechno, co budeš později chtít změnit.

Tři běžné HTTP Request Actions. Nic je neoznačuje jako speciální.

Jsou propojené dvěma funkcemi, které už v editoru máš, a obě stojí za to znát jménem.

Save to memory zachytí hodnotu z odpovědi a uloží ji do konverzace. open_support_ticket ji používá k uložení ID nového vlákna: Discord vrátí objekt vlákna, $.id je ID a zapíše se do paměti jako discord_ticket_thread_id. Dvě následné Actions si ho potom načtou zpět ve své URL, takže pracují s vláknem, které právě vzniklo, ne s něčím, co bys musel dopředu pojmenovat. (Save to memory v dokumentaci.)

Run only when omezuje Action podle stavu konverzace a kontroluje se na straně Quickchat AI před odesláním jakéhokoli požadavku. (Run only when v dokumentaci.)

Brána, která mění tři nezávislé Actions ve spolehlivou sekvenci.

Čti tento diagram oběma směry, protože dělá dvě věci:

• Následné kroky vyžadují, aby ID vlákna existovalo, takže Agent nemůže upozornit tým na vlákno, které nikdy nevzniklo.
• open_support_ticket vyžaduje, aby neexistovalo, takže Agent nemůže ve stejné konverzaci otevřít druhý ticket, ať konverzace říká cokoli. Je to záruka, ne instrukce: pokud člen přidává detaily dalších deset zpráv, pořád má jeden ticket. V režimu odpovědí v kanálu je každá výměna v kanálu samostatná konverzace, takže další skutečná otázka může pořád otevřít vlastní ticket.

Každá Action má také Response filter a ten se snadno špatně pochopí. Response filter je allowlist: pojmenovává cesty, které Agent smí vidět, a všechno ostatní v odpovědi se zahodí dřív, než to model přečte. (Response filter v dokumentaci.)

Discord vrací desítku polí o tvém serveru. Agentovi se ukážou dvě.

ID vlákna, které sekvence potřebuje, zachytí Quickchat AI na své straně přes Save to memory, takže ho Agent nikdy nemusí přenášet, a nic dalšího o tvém serveru se k modelu nedostane. Zkrať allowlist a uvidí méně. Nikdy neuvidí víc, než uvedeš.

Může člověk převzít konverzaci od AI?

Ano, a toto je polovina, kterou většina ticket botů vynechává. Ticket, který nikdo nečte, je jen vlákno.

Human Handoff je samostatná vestavěná Action. Zapni ji a pod Handoff Rules popiš, kdy se má konverzace dostat k člověku, například “když zákazník požádá o člověka nebo když Agent nedokázal odpovědět z knowledge base”. Quickchat AI potom označí konverzaci ve tvém Inboxu AI shrnutím, takže ten, kdo ji převezme, čte odstavec místo celého vlákna. Každé nastavení handoffu má vlastní průvodce v tutoriálu Human Handoff.

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

Přiřaď konverzaci sobě a odpověz v composeru Inboxu. Odpověď se doručí přímo zpět do Discord kanálu, ve kterém už člen mluví. Nepotřebuje u tebe účet, e-mailové vlákno ani přihlášení do portálu. AI mlčí od okamžiku, kdy konverzaci vlastní člověk, takže nesoupeříš s vlastním botem.

Stejný kanál, tři dny od sebe. Agent odmítl a eskaloval; zprávu pod oddělovačem napsal člověk v Quickchat AI Inboxu. Všimni si, že dorazí pod jménem tvého bota, protože tvůj bot je jediná identita, jako kterou nám Discord dovoluje posílat.

Stejná konverzace z tvojí strany. Odmítnutí Agenta, dvě Action volání za ním, odpověď operátora níže a panel detailů, který už ví, že kanál je Discord a téma je single sign-on.

Soukromé ticket vlákno mezitím zůstává tam, kde tým pracuje: je to pracovní prostor, se členem uvnitř a s pingnutou support rolí. Odpověď se vrátí tam, kde otázka padla.

Šest kroků. Tři z nich jsou zápisy do Discordu a všechny tři nastanou jen proto, že odpověď chyběla.

Otestuj to oběma způsoby

Než se na to spolehneš, spusť obě cesty a poctivé selhání otestuj nejdůkladněji.

Pokrytá otázka. @zmiň bota v kanálu, který vidí, a zeptej se na něco, co knowledge base pokrývá. Měl bys dostat skutečné kroky v kanálu a nikde žádné vlákno. To je případ, který šetří čas týmu, a jakmile bude dokumentace dobrá, bude tvořit většinu provozu.

Nepokrytá otázka. Zeptej se na věc, kterou dokumentace nepokrývá. Agent by to měl říct a potom eskalovat. Ve stejný okamžik se objeví ticket:

Vlákno, které Agent otevřel. Pojmenoval ho podle problému, přidal člena, pingnul roli a sám napsal shrnutí.

A vlákno je skutečně soukromé, což dokazuje jeho vlastní seznam členů:

Ticket je soukromé vlákno. Support konverzace se neodehrávají veřejně.

Testuj celou konverzaci, ne jednu zprávu. Ochrana proti duplicitám ukáže hodnotu až ve druhém turnu, když člen přidá detail a naivní bot otevře druhý ticket.

Jedna věc, kterou run conditions nepokrývají. Zastaví volání mimo pořadí, ale nededuplikují retry: pokud ručně znovu spustíš notify Action, pošle druhou zprávu. Hodí se to vědět, než začneš zkoumat živý ticket.

Abys zkontroloval mnoho formulací najednou bez psaní všech do Discordu, použij Simulations pod Testing: vytvoř dataset zákaznických zpráv, spusť ho proti skutečnému Agentovi a společně si přečti ohodnocené výsledky. Smíchej pokryté i nepokryté otázky v jednom datasetu, protože obě cesty selhávají jinak.

Šest otázek, čtyři pokryté a dvě ne, ohodnocené v jednom běhu. Řádky 5 a 6 jsou poctivá selhání a mají stejně vysoké skóre jako odpovědi.

Napiš hodnoticí kritéria pro hodnotitele, který vidí jen transcript, protože nic jiného nedostane. Jinak tě budou stát body dvě věci, které nevidí. Nevidí vedlejší efekt v Discordu, takže pokud to neřekneš, čte “Otevřel jsem ti ticket” jako vymyšlenou schopnost Agenta. A nevidí tvoji knowledge base, takže správnou konkrétní odpověď označí níž jako smyšlenou jen proto, že nemůže ověřit číslo. Obojí si zaslouží jednu větu v kritériích a obojí ti sníží nejlepší chování, pokud to vynecháš.

Jak zabráníš tomu, aby bot otevíral příliš mnoho ticketů?

Toto je jediné ladění, které většina serverů potřebuje, a většinou to není problém promptu.

Objem ticketů je problém knowledge base. Každá mezera v dokumentaci se stane ticketem. Pokud bot eskaluje víc, než jsi čekal, čti tickety: jsou seznamem otázek, na které dokumentace neodpovídá. Zavírání těchto mezer snižuje objem přímo.

Insights ti řekne, co dokumentovat dál. Quickchat AI seskupuje konverzace podle tématu, takže vidíš, které otázky se objevují nejčastěji, místo abys hádal. Oprav tři nejčastější témata v knowledge base a sleduj, jak klesá míra eskalací.

Nikdo je nekonfiguroval. Pod Insights, Advanced, AI-Detected Topics je pojmenovaly ze samotných konverzací a počty jsou backlog dokumentace v prioritním pořadí.

Tento seznam je celá ladicí smyčka. Pricing a API klíče se objevily nejčastěji, takže tyto články se napíšou jako první, a graf příští týden ukáže, jestli to fungovalo. Témata výše se objevují automaticky; můžeš si také definovat vlastní pod Manage Topics, pokud chceš záměrně sledovat konkrétní oblast produktu. Viz AI-Detected Topics, Conversation Topics a správa témat v dokumentaci.

Pokud eskaluje příliš ochotně, zpřísni popis Action tak, aby se spustila až poté, co Agent členovi řekl, že informaci nemá. Pokud eskaluje příliš zřídka a začne hádat, posil řádek “nehádej a nevymýšlej kroky” v hlavním promptu.

Je bezpečné to provozovat na veřejném serveru?

Bot, se kterým může mluvit kdokoli ve veřejném kanálu, si zaslouží přísnou kontrolu. Tohoto chrání konfigurace, kterou můžeš číst v editoru, ne formulace promptu, proto platí bez ohledu na to, jak je zpráva napsaná.

Člen může mluvit s modelem. Nemůže obejít prostřední sloupec.

Každá ticket Action vyžaduje skutečný Discord turn z tvého serveru. Dvě ze tří run conditions u každé Action kontrolují, že zpráva opravdu přišla přes Discord integraci a ze serveru, který jsi vybral při instalaci. Tyto hodnoty vytváří integrace, ne zpráva, a veřejný chat ani API zpráva je nemůže dodat ani zdědit starší uloženou kopii. Nasměruj veřejné API Agenta na tyto Actions a odmítnou.

Action, která přidává někoho do soukromého vlákna, nemá žádné parametry upravitelné modelem. Její URL končí ID člena, které integrace dodala pro aktuální zprávu. Agent nemůže předat jiné, takže nemůže přidat libovolného člena serveru do ticketu někoho jiného.

Zmínky jsou uzamčené při instalaci. Notify Action posílá explicitní seznam zmínek obsahující člena, který se ptal, a roli, kterou jsi zvolil, s vypnutým parsingem. Zmínka, kterou Agent náhodou napíše do shrnutí problému, se nevyhodnotí a @everyone se nikdy nespustí. Vyplatí se to ověřit, ne tomu jen věřit, a platí to: ping role a zmínka uživatele dorazí, zatímco doslovné @everyone ve stejné zprávě neudělá nic.

Vlákna jsou soukromá a nelze do nich zvát. Vytvářejí se jako type: 12 s invitable: false, takže člen přidaný do ticketu do něj nemůže přivést nikoho dalšího.

Bot nemůže moderovat. Nemá oprávnění Kick, Ban ani Timeout. Nejhorší výsledek toho, že člen Agenta přemluví k něčemu, co dělat nemá, je ticket vlákno, které by mohl otevřít normálním dotazem.

Token se nikdy neodhalí. Žije jako System Token, vkládá se při odeslání a rediguje se všude, kde se volání zaznamenává.

Jednu věc se rozhodni záměrně: ticket vlákna jsou soukromá, ale každý se support rolí je může číst, což je pro support žádoucí a je dobré to vědět, pokud by členové mohli vkládat citlivé údaje. Pro cokoli opravdu důvěrného je nasměruj na e-mail.

Kolik stojí Discord AI support bot?

Free plán zahrnuje AI Actions, Human Handoff, knowledge base, Topics a Insights, s 50 AI kredity měsíčně pro osobní, nekomerční použití. Firemní použití vyžaduje placený plán; placené plány také poskytují více AI kreditů. Pokud to porovnáváš se samostatným provozem, free AI Discord bots poctivě srovnává self-hosted cestu, včetně hodin, které stojí.

Když projdou obě cesty, pusť Agenta do provozu:

1. Nasměruj členy na bota. Napiš do tématu kanálu, že ho mohou @zmínit. Bot, o kterém nikdo neví, nic neodkloní.
2. Sleduj první den. Každá Action má call log s přesným požadavkem a odpovědí a Inbox drží každou konverzaci, takže uvidíš, na co odpověděl a co eskaloval.
3. Čti první tickety jako backlog dokumentace. Jsou to otázky, na které dokumentace zatím neodpovídá.

Stejný Agent funguje i všude jinde. Knowledge base, prompt a Human Handoff patří Agentovi, ne Discordu, takže stejný support bot odpovídá ve website widget, ve Slacku, na WhatsAppu a přes e-mail a každá konverzace skončí ve stejném Inboxu. Tři ticket Actions jsou jediná část tohoto řešení specifická pro Discord. Pokud tvůj tým žije spíš ve Slacku než v Discordu, pošli handoff notifikaci tam místo pingování Discord role.

Co dalšího může tvůj Discord AI Agent dělat?

Stejná galerie obsahuje kategorii Moderation: timeout, kick, ban, unban, assign role, slowmode a announcements. Každá z nich se instaluje s run condition author_is_admin is true, takže je může spustit jen administrátor serveru, a tento flag přichází z Discordu, ne z konverzace. To je jiný bot s jiným rizikovým profilem a má vlastní návod: Build an AI Discord moderation bot.

Jakýkoli jiný Discord endpoint používá stejný recept: HTTP Request Action s hlavičkou Authorization: Bot {{discord_bot_token}}, jedním nebo dvěma parametry a popisem v běžném jazyce, který rozhoduje, kdy ji Agent spustí. Build an AI Agent that takes actions je začátečnická verze této myšlenky a Connect your AI Agent to any API pokrývá obecný případ.

Ne každý Discord bot je support bot. Stejný Agent může místo toho provozovat postavu: Discord AI roleplay bot používá stejnou knowledge base a paměť pro persony místo ticketů a kompletní tvorba postavy prochází persona prompt, kánon a nastavení, která ho drží v roli.

Appendix: přesné požadavky

Tyto požadavky nikdy nepíšeš, ale vyplatí se je jednou přečíst, a přesně toto bys ručně stavěl proti jakékoli jiné platformě. Hodnoty {{...}} vyplní Quickchat AI při odeslání.

1. Otevřít soukromé 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 dělá vlákno soukromým. auto_archive_duration je v minutách, takže 1440 archivuje tichý ticket po jednom dni. Save to memory zachytí $.id jako discord_ticket_thread_id.

2. Přidat člena, který se ptal

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

Bez těla a bez parametrů. Obě ID přicházejí z paměti a z integrace.

3. Upozornit 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 stojí skutečný čas při ladění, pokud to stavíš sám. Schéma autorizace je Bot, ne Bearer, což je nejčastější chyba při ručním volání Discordu. A v allowed_mentions chceš prázdné parse vedle explicitních seznamů users a roles: blokuje @everyone, ale propustí dvě zamýšlené zmínky. Neprázdné parse vedle explicitního seznamu stejného typu se rovnou odmítne s 400 MESSAGE_ALLOWED_MENTIONS_PARSE_EXCLUSIVE.

Související návody

• Create an AI Discord bot, nastavení, které tento návod předpokládá
• Build an AI Discord moderation bot, stejná galerie zaměřená na moderaci
• The best AI Discord bots, porovnání možností
• Free AI Discord bots, co tě self-hosting skutečně stojí
• Discord AI roleplay bot, stejný Agent místo toho provozuje postavu
• Connect your AI Agent to HubSpot, stejná one-click galerie pro CRM
• Make your AI Agent’s actions reliable, run conditions a paměť do hloubky
• Connect your AI Agent to any API, obecný recept
• How to build a chatbot knowledge base, polovina, která rozhoduje o objemu ticketů
• Product tutorial: Human Handoff, vysvětlení každého nastavení handoffu

Často kladené otázky

Jak nastavím ticket bota na Discordu?

Připoj vlastní Discord aplikaci v External Apps, dej Agentovi knowledge base, potom otevři Actions and MCPs, klikni na Add Action, zvol Discord Action a vyber Open Support Ticket. Z rozbalovacích seznamů vyber server, ticket kanál a support roli a klikni na Install and enable. Nemusíš nic hostovat a v Discordu nemusíš kromě vytvoření kanálu a role nic nastavovat.

Jak vytvořím Discord ticket bota?

Vytvoř Quickchat AI Agenta, připoj vlastní Discord aplikaci, potom otevři Actions and MCPs, klikni na Add Action, zvol Discord Action a vyber Open Support Ticket. Z rozbalovacích seznamů vybereš server, ticket kanál a support roli, klikneš na Install and enable a Quickchat AI za tebe vytvoří tři kompletní AI Actions. Nejdřív dej Agentovi knowledge base, protože ta rozhoduje o tom, kolik ticketů otevře.

Může AI odpovídat na support otázky na Discordu?

Ano. Agent prohledá tvoji knowledge base a odpoví v kanálu, když odpověď najde. Deflection sleduje pokrytí: otázky pokryté dokumentací dostanou odpověď a otázky, které dokumentace nepokrývá, se změní v tickety. To je nejdůležitější vztah, který musíš při provozu tohoto bota chápat.

Potřebuji k vytvoření tohoto Discord ticket bota kód?

Ne. Vybereš šablonu z Discord galerie, z rozbalovacích seznamů zvolíš server, kanál a roli a Quickchat AI na backendu vytvoří metodu, URL, hlavičky, tělo, parametry, nastavení odpovědi a run conditions. Nikdy nepíšeš Discord ID a nikdy neupravuješ JSON.

Kolik Actions šablona nainstaluje?

Tři. Jedna otevře soukromé vlákno v ticket kanálu a uloží jeho ID do paměti, jedna přidá člena, který se ptal, a jedna pošle shrnutí se zmínkou o support roli. Přijdou už zapnuté a vzájemně propojené.

Jak bot pozná, kdy má otevřít ticket?

Rozhodují o tom dvě věci. Popis Action říká Agentovi, aby ji zavolal jen tehdy, když odpověď není v knowledge base, a run condition dělá sekvenci deterministickou: vlákno před otevřením ještě nesmí existovat a před následnými kroky už existovat musí.

Může bot otevírat duplicitní tickety?

Ne ve stejné konverzaci. Open Support Ticket má run condition, která vyžaduje, aby v paměti ještě nebylo žádné ID ticket vlákna, takže jakmile jeden ticket existuje, Agent nemůže pro danou konverzaci otevřít druhý, bez ohledu na prompt.

Může člověk převzít konverzaci?

Ano. Human Handoff označí konverzaci ve tvém Quickchat AI Inboxu AI shrnutím. Přiřaď ji sobě, napiš odpověď v Inboxu a ta dorazí do stejného Discord kanálu, ve kterém už člen je. Nikdy neopustí Discord a nepotřebuje u tebe účet.

Proč ticket bot potřebuje moji vlastní Discord aplikaci?

Ticket Actions volají Discord API jako tvůj bot, takže potřebují token tvého bota. Sdílený one-click Quickchat AI bot umí odpovídat na otázky a používat Google Sheets Actions. Jeho Discord token není dostupný pro tvoje private-ticket Actions. V External Apps otevři Discord a zvol Advanced setup, zabere to asi deset minut.

Jaká Discord oprávnění bot potřebuje?

View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads a Manage Threads v ticket kanálu. Support bot nepotřebuje oprávnění Kick, Ban ani Timeout, a oprávnění, které nemá, nikdy nemusíš řešit.

Proč v rozbalovacím seznamu chybí moje support role?

Role picker zobrazuje jen role, které Discord hlásí jako mentionable, a vylučuje @everyone. Pokud tvoje support role není v Server Settings, Roles nastavená jako mentionable, nezobrazí se, protože šablona by ji nemohla pingnout.

Je bezpečné provozovat Discord ticket bota na veřejném serveru?

Kontroly jsou v konfiguraci, ne ve formulaci promptu, takže platí bez ohledu na to, jak je zpráva napsaná. Každá ticket Action vyžaduje, aby turn opravdu přišel z Discordu a ze serveru, který jsi vybral, Action pro přidání někoho do soukromého vlákna nemá žádné parametry upravitelné modelem, zmínky jsou uzamčené na člena, který se ptal, a roli, kterou jsi zvolil, a vlákna jsou soukromá a nelze do nich zvát. Run conditions se kontrolují předtím, než jakýkoli požadavek opustí Quickchat AI.

Kolik stojí Discord AI support bot?

Free plán zahrnuje 50 AI kreditů měsíčně pro osobní, nekomerční použití. AI Actions, Human Handoff, knowledge base, Topics a Insights jsou zahrnuté. Firemní použití vyžaduje placený plán; placené plány také poskytují více AI kreditů.

Jaký je rozdíl mezi tímto řešením a Ticket Tool nebo TicketsBot?

Ty jsou založené na pravidlech. Člen klikne na tlačítko Create Ticket v připnutém panelu a ticket se otevře pokaždé, včetně otázky, na kterou už dokumentace odpovídá. Tento bot nejdřív odpovídá a eskaluje jen to, co opravdu neumí vyřešit, takže tým čte otázky, které skutečně potřebují člověka.

Může ChatGPT, Claude nebo Gemini provozovat Discord ticket bota?

Ano, přes Quickchat AI. Tvůj Agent běží na nejnovějších modelech a pomocí těchto AI Actions volá Discord API, takže odpovídá z tvé knowledge base a otevírá skutečná soukromá vlákna. Ty rozhoduješ, které Actions existují a co bot smí dělat.

Může stejný Agent fungovat i na jiných kanálech než Discord?

Ano. Knowledge base, prompt a Human Handoff patří Agentovi, ne Discordu, takže stejný support bot odpovídá ve widgetu na webu, ve Slacku, na WhatsAppu a přes e-mail. Tři ticket Actions jsou jediná část tohoto řešení specifická pro Discord.

Jak členové začnou konverzaci s botem?

Ticket bot v tomto návodu používá tvoji vlastní Discord aplikaci, takže členové začnou tím, že ho @zmíní v kanálu, který vidí. Agent odpoví ve stejném kanálu a otevře ticket vlákno jen tehdy, když neumí odpovědět. Příkaz /ask patří sdílenému one-click Quickchat AI botovi.

Jak zabráním tomu, aby bot otevíral příliš mnoho ticketů?

Nejdřív zlepši pokrytí knowledge base, protože každá mezera se změní v ticket. Čti první tickety jako backlog dokumentace a pomocí Insights zjisti, která témata se objevují nejčastěji, abys věděl, co napsat dál. Teprve potom zpřísni popis Action.

Můžu upravit Actions, které galerie nainstaluje?

Každé pole. Jsou to běžné HTTP Request Actions a nic je neoznačuje jako speciální: žádný zámek, žádný badge, žádná samostatná vrstva pravidel. Změň URL, tělo, popis nebo run conditions, případně nainstaluj druhou kopii a uprav tu.

Můžu provozovat Discord ticket systém bez helpdesku?

Ano. Ticket je soukromé Discord vlákno a fronta je tvůj Quickchat AI Inbox, takže v procesu není Zendesk, Intercom ani Jira a není co migrovat. Pokud helpdesk už používáš, můžeš si ho nechat: stejný Agent tam může také vytvořit ticket pomocí jiné AI Action a HubSpot galerie dělá přesně to.

Může bot odpovídat z obsahu našeho centra nápovědy?

Na tom je postavený. Vlož URL centra nápovědy a Quickchat AI stránky nascrapuje do knowledge base, případně nahraj soubory a vlož články přímo. Agent tyto články prohledává u každé otázky a odpovídá v kanálu, když odpověď najde, takže tvoje existující dokumentace se stane botem bez přepisování. Create an AI support agent from your documentation prochází tuto polovinu samostatně.

Může bot pozdravit člena, když se otevře ticket kanál?

Ano, samostatnou funkcí. Ticket bot jako Ticket Tool vytvoří kanál a automated message Quickchat AI New channel do něj o pár sekund později pošle pevný pozdrav, takže člen hned vidí, že má s čím mluvit. Nestojí to žádné kredity, protože se nevolá žádný model. Greet members, threads and ticket channels to nastaví.

Jak měřím ticket deflection?

Deflection je podíl otázek zodpovězených bez ticketu, takže v tomto řešení jsou to konverzace bez ticket vlákna dělené všemi konverzacemi. Každá Action má call log, takže počítání volání open_support_ticket ti dá eskalovanou polovinu přímo a Insights seskupí zbytek podle tématu. Sleduj ji po tématech, ne jako jedno číslo: klesající míra u jednoho tématu je mezera v dokumentaci, kterou můžeš zavřít. Chatbot analytics pokrývá širší sadu metrik.

Shrnutí

S knowledge base a jedním kliknutím se Quickchat AI Agent stane support botem první linie pro tvůj Discord server: odpovídá na otázky, které pokrývá dokumentace, přizná, když je nepokrývá, pro zbytek otevře soukromé ticket vlákno, přidá člena, upozorní support roli shrnutím, které sám napsal, a předá konverzaci člověku, který odpoví z Inboxu, aniž by člen kdy opustil Discord. Galerie vytvoří tři Actions, rozbalovací seznamy znamenají, že nikdy nepíšeš Discord ID, a run conditions znamenají, že sekvence drží i tehdy, když konverzace nejde podle plánu. Zbývá práce, kterou můžeš udělat jen ty: knowledge base, ze které stojí za to odpovídat.