AI Discord Ticket Botu: Önce Yanıtla, Sonra Yükselt

Quickchat AI, Discord sunucunuzdaki destek sorularını kendi dokümantasyonunuzdan yanıtlar ve yalnızca yanıtlayamadığında özel bir ticket thread’i açar. Bu kılavuz, bu botu uçtan uca, kod yazmadan, yaklaşık yarım saatte oluşturur.

Sonuç, iyi bir birinci seviye agent gibi davranır. Bir üye API anahtarını nasıl sıfırlayacağını sorar ve kanalda gerçek adımları alır. Bir üye dokümanların kapsamadığı bir şey sorar ve bot tahmin etmek yerine bunu söyler, özel bir thread açar, üyeyi içine alır, destek rolünüze tek satırlık bir özetle bildirim gönderir ve konuşmayı Inbox’ınızdan yanıt verebilecek bir insana devreder.

Discord botunuzun görevini seçin

Bu kurulum destek sorularını yanıtlar ve dokümantasyonunuzdaki boşlukları yükseltir. Sabit karşılama mesajları için welcome guide’ı, yönetici komutları için moderation guide’ı seçin.

İki şeye ihtiyacınız var:

• bir Quickchat AI Agent (hesabınızı oluşturun)
• admin olduğunuz bir Discord sunucusu

Kaydolmadan ilk destek testinize

1. E-posta ve parola ile kaydolursanız, e-postanızdaki doğrulama bağlantısını açın. Kurulumda bir Discord destek Agent’ı tanımlayın, Create my AI Agent’a tıklayın ve kullanım amacınıza uygun bir plan seçmek dahil kurulum adımlarını tamamlayın.
2. Dokümantasyonunuzu Knowledge Base altına ekleyin. External Apps içinde Discord’u açın, ardından Use your own Discord app’i ve Advanced setup’ı seçin. Paylaşılan tek tıklamalı bot soruları yanıtlayabilir, ancak bu kılavuzdaki ticket Actions’ı çalıştıramaz.
3. Test sunucunuzda bir ticket kanalı ve mentionable bir destek rolü oluşturun. Actions and MCPs içinde Add Action’a tıklayın, Discord Action’ı seçin ve Open Support Ticket’ı bu sunucu, kanal ve rolle kurun.
4. Aşağıdaki Agent talimatlarını uyguladıktan sonra, botunuzu dokümanların yanıtladığı bir soruyla, ardından yanıtlamadığı bir soruyla @mention edin. İlki ticket olmadan bir yanıt almalıdır; ikincisi bir özel thread açmalı ve destek rolüne bildirim göndermelidir. İkinci konuşmaya bir takip mesajı ekleyin ve yinelenen ticket açılmadığını kontrol edin.

Free plan kişisel, ticari olmayan kullanım içindir. Botu bir işletme için kullanmadan önce ücretli bir plan seçin. Müşterileri davet etmeden önce iki yollu testi tamamlayın.

Aşağıdaki ekran görüntüleri, Beacon adlı kurgusal bir ürün analitiği şirketinin destek botu olan Lumen adlı bir test Agent’ından gelir. Şirket örneğin tarafsız kalması için uydurulmuştur, ancak burada gösterilen her konuşma, her API çağrısı ve her ticket thread’i, gerçek bir Discord sunucusunda gerçek yanıt pipeline’ını çalıştıran gerçek bir Agent tarafından üretilmiştir.

Ne oluşturacaksınız

Her soru için bir karar. Mutlu yolda Discord’a hiçbir şey yazılmaz.

Yükseltme işini üç AI Actions yapar ve Quickchat AI üçünü de tek bir galeri kartından kurar:

Bilgi tabanı nedir ve neden ticket hacminizi belirler?

Daha önce bir AI Agent oluşturmadıysanız, iki dakikaya değecek kavram budur.

Bir bilgi tabanı, Agent’ınıza yüklenen ve konuşma sırasında aranabilmesi için indekslenen kendi dokümantasyonunuzdur. Quickchat AI’a help-docs URL’nizi verebilir ve sayfaları scrape etmesine izin verebilir, makaleleri elle yapıştırabilir veya dosya yükleyebilirsiniz. Yanıt zamanında Agent onu arar ve temel modelin dünya hakkında hatırladığı şeye değil, bulduğu içeriğe göre yanıtlar. Sıfırdan başlıyorsanız, chatbot bilgi tabanı nasıl oluşturulur ne yazılacağını ve hangi sırayla yazılacağını anlatır.

Dokümanlarınızın kapsadığı her şey yanıtlanır. Kapsamadıkları her şey ticket olur.

Bu kurulumun tüm kaldıracı budur. Deflection bir prompt hilesi değildir ve bir model yeteneği değildir: kapsamınızdır. Bot beklediğinizden fazla yükseltirse, ticket’lar size henüz hangi sayfaları yazmadığınızı söylüyordur.

Ölçülmüş değil, açıklayıcı. Önemli olan yöndür: doküman yazmak burada yapabileceğiniz en yüksek etkili iştir.

Bir AI gerçekten Discord’da destek sorularını yanıtlayabilir mi?

Dokümanlarınızın kapsadığı sorular için evet, üstelik bir yeniden anlatım yerine gerçek adımlarla. Test sunucusundan deflection örneği burada, düzenlenmemiş:

Bilgi tabanı makalesinden, kanalda yanıtlandı. Gerekmediği için ticket oluşturulmadı.

Daha ilginç yarı, yanıt orada olmadığında ne olduğudur. Bot bunu söyler:

Dürüst başarısızlık. Beacon’ın bilgi tabanı kasıtlı olarak enterprise SSO’yu dışarıda bırakıyor, bu yüzden ticket açan yol budur.

Makul görünen bir SSO prosedürü uyduran bir Agent, ticket açandan daha kötüdür, bu yüzden bu davranışı ummak yerine bilinçli olarak test etmeye değer. Buna test bölümünde geri dönüyoruz.

Discord’u bağlamanın iki yolu ve ticket’lar neden ikincisine ihtiyaç duyar?

Quickchat AI’ın iki Discord bağlantısı vardır ve başlamadan önce fark önemlidir.

Paylaşılan botla çalışan herkese açık bir geri bildirim kuyruğu için geri bildirim ve dokümantasyon boşluğu workflow’u bölümüne bakın. Aşağıdaki özel ticket Actions, kendi Discord bot kimlik bilgilerinize ihtiyaç duyar.

One-click hızlı yoldur. External Apps içinde Discord’u açar, Add to your Discord server’a tıklar, yetkilendirirsiniz ve paylaşılan Quickchat AI botu yaklaşık bir dakika içinde sunucunuzda canlı olur. Üyeler onu @mention ettiğinde veya /ask kullandığında yanıtlar ve birçok sunucu için tüm görev budur.

Ona ad verebilirsiniz. Yetkilendirmeden önce, Agent’ınızın adıyla önceden doldurulmuş bir Bot name in the new server alanı vardır ve bağlı her sunucu daha sonra değiştirebileceğiniz kendi Bot name in this server kutusunu tutar. Bu bir Discord nickname’dir, yani sunucu başınadır ve 32 karakterle sınırlıdır, temizlemek botu Quickchat AI’a geri döndürür. Paylaşılan kalan şey avatar ve temel @username’dir, çünkü tek bir Discord uygulaması onu kuran her sunucuya hizmet verir.

One-click genel demek değildir. Bot, Agent’ınızın adını sunucuya taşır ve daha sonra sunucu başına değiştirebilirsiniz.

Advanced setup kendi Discord uygulamanızı kaydeder. Discord’un developer portal’ında bir bot oluşturur ve token’ını Quickchat AI’a bir kez yapıştırırsınız. Yaklaşık on dakika sürer ve size kendi avatarınızı ve @username’inizi, direct messages’ı, tek sunucuda birkaç botu ve bu kılavuzun ihtiyaç duyduğu şeyi verir: Discord API Actions.

Nedeni bir gariplik gibi ele almak yerine açıkça söylemeye değer. Bu kılavuzdaki ticket Actions, Discord API’yi sizin botunuz olarak çağırır ve Quickchat AI’ın gönderim zamanında isteğe enjekte ettiği bir kimlik bilgisi kullanır. Paylaşılan tek tıklamalı botun token’ı size değil paylaşılan bota aittir, bu yüzden Actions’ınızın göndermesi için kullanılamaz. Discord galerisini kendi uygulamanız bağlı olmadan açarsanız, çalışamayacak bir şey oluşturmanıza izin vermek yerine bunu söyler ve kartları devre dışı bırakır.

External Apps iki yolun da başladığı yerdir. Advanced setup, Discord panelinin altındaki bir callout içinde yer alır.

Başlamadan önce gerekenler

Kendi Discord uygulamanızı bağlayın. External Apps içinde Discord’u açın, Use your own Discord app’i bulun ve Advanced setup’ı seçin. Discord’un developer portal’ında uygulamayı ve botu oluşturun, Message Content Intent’i açın, Require OAuth2 Code Grant’i kapalı bırakın ve bot token’ını yapıştırın. Quickchat AI yazdıkça doğrular. Bunu daha önce yapmadıysanız AI Discord botu oluşturma kılavuzu portal tarafını ayrıntılı olarak anlatır.

Bota yalnızca bir destek botunun ihtiyaç duyduğu izinleri verin. Ticket kanalında: View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads ve Manage Threads. Kick, Ban veya Timeout iznine ihtiyacı yoktur ve test sunucusunda bilinçli olarak hiçbirine sahip değildir. Bir destek botunun moderasyon yapması için hiçbir nedeni yoktur ve sahip olmadığı bir izin, hakkında hiç düşünmeniz gerekmeyen bir izindir.

Discord’da Actions’ın işaret edeceği iki şeyi oluşturun. Bu bölüm Discord client içinde olur, Quickchat AI içinde değil ve orada yaptığınız tek kurulumdur:

1. Ticket’ların açılacağı bir kanal. Herhangi bir text channel olur. Kanal listenizin yanındaki + işaretini kullanın veya mevcut bir kanalı yeniden kullanın. Test sunucusunda bu #support’tur.
2. Ticket açıldığında bildirim gönderilecek bir rol. Server Settings, ardından Roles, ardından Create Role. Test sunucusunda bu @support’tur.

Üç yer ve yalnızca biri herkese açıktır.

Bunların ikisi de Step 3’te geri gelir. Ticket template’ini kurduğunuzda Quickchat AI sunucunuzu Discord’dan canlı okur ve size üç açılır liste gösterir, bunlardan biri bulduğu rolleri listeleyen bir Role seçicisidir. Herhangi bir yere ID yazmak yerine destek rolünüzü orada seçersiniz.

Step 3’teki Role seçici. Listeyi Discord’dan okur, bu yüzden şimdi oluşturduğunuz bir rol birazdan burada görünür.

Atlarsanız sizi yakalayacak bir ayrıntı: bu seçici yalnızca Discord’un mentionable olarak bildirdiği rolleri listeler ve @everyone’ı dışarıda bırakır. Destek rolünüz mentionable olarak ayarlanmamışsa, nedenini açıklayan hiçbir şey olmadan açılır listede görünmez. Filtre bilinçlidir, çünkü template’in tüm işi o role bildirim göndermektir. Rolü oluştururken bunu ayarlayın ve sorunla hiç karşılaşmazsınız:

Server Settings, Roles, destek rolünüzü seçin ve Display altında bunu açın. Bu olmadan rol seçiciye hiç ulaşmaz.

Bot yanıtlamaya mı yoksa ticket açmaya mı nasıl karar verir?

Çoğu Discord ticket botu hiçbir şeye karar vermez. Ticket Tool, TicketsBot ve diğerleri Create Ticket düğmesi olan sabitlenmiş bir panel gönderir veya bir slash command kaydeder. Bir üye tıklar, bir ticket açılır ve ekibiniz onu okur. Bu iyi bir tasarımdır ve tamamen öngörülebilirdir, ancak bu hafta API anahtarını nasıl sıfırlayacağını soran on kişinin on ticket ürettiği anlamına gelir.

Aynı on soru. Fark, ekibinizin sonunda ne okuduğudur.

Önce yanıt veren bir bot karar vermeden önce dokümanlarınızı okur. Ve yükselttiğinde, bir ticket açmak tam olarak dört bilgi gerektirir:

• thread’in hangi kanalda açılacağı
• sorunun hangi sunucudan geldiği
• kimin sorduğu, böylece thread’e alınabilir
• ticket’ın adı ve sorunun tek satırlık özeti

İlginç olan, bu dördünün üç tamamen farklı yolla gelmesi ve yalnızca sonuncusunun AI tarafından yazılmasıdır:

Asla Discord ID yazmazsınız ve model kanalınızı veya rolünüzü asla görmez.

Bir kez seçtikleriniz. Ticket kanalınız ve destek rolünüz. Template’i kurarken açılır listelerden seçersiniz ve Quickchat AI bunları Action’a işler. Model onları asla görmez ve değiştiremez.

Discord’un sağladıkları. İlettiği her mesajda Discord entegrasyonu Quickchat AI’a hangi sunucudan geldiğini ve kimin konuştuğunu {{metadata_discord_guild_id}} ve {{metadata_discord_author_id}} olarak söyler. Bot token’ınız da aynı şekilde, gönderim zamanında enjekte edilen ve bir çağrının kaydedildiği her yerde redakte edilen bir System Token olarak gelir. Bunların hiçbiri model tarafından yazılmaz ve hiçbiri herkese açık chat veya API mesajı tarafından sağlanamaz.

Agent’ın yazdıkları. Ticket konusu ve tek satırlık sorun özeti. Tüm kurulumdaki tek yargı kararları bunlardır, bu yüzden daha sonra ayar yapmak kısadır.

Step 1: Agent’ı oluşturun ve ona bir bilgi tabanı verin

Agent’ınızı oluşturun, ardından Knowledge Base’i açın ve dokümantasyonunuzu ekleyin. Help-docs URL’nizi yapıştırıp Quickchat AI’ın scrape etmesine izin verin veya makaleleri doğrudan yazın. Dokümantasyonunuzdan bir AI support agent oluşturma scraping yolunu ayrıntılı olarak anlatır.

Beacon’ın bilgi tabanı: API anahtarını sıfırlama, boş dashboard, tracking snippet kurma, planlar ve faturalandırma, veri dışa aktarma.

Beacon’ın dokümanları kasıtlı olarak bir şeyi kapsamaz: enterprise SSO kurulumu. Bu boşluk bu tutorial’da bir gözden kaçma değildir, asıl noktadır. Her destek bilgi tabanında yanıtlamadığı sorular vardır ve bu botun tüm değeri birine çarptığında ne yaptığıdır. SSO, bu kılavuz boyunca o sorudur.

Üyeler, kendi botunuza onu görebildiği bir kanalda @mention ederek ulaşır. Kaydedilecek hiçbir şey yoktur. /ask komutu, paylaşılan tek tıklamalı Quickchat AI botunda kullanılabilir.

Step 2: Agent’a ne zaman yanıtlayacağını ve ne zaman yükselteceğini söyleyin

Agent’ın talimatları Identity üzerindeki AI Main Prompt içine girer. Bunu şirketinize uyarlayarak yapıştırın:

Sen Lumen'sin, Beacon için destek asistanısın. Beacon, yazılım ekipleri için barındırılan bir ürün analitiği aracıdır. Beacon topluluk Discord'undaki müşterilerden gelen soruları yanıtlarsın.
Mümkün olduğunda Knowledge Base'inden yanıtla. Yanıtları kısa ve pratik tut, iki veya üç cümle yaz ve somut adımları ver.
Bir soru Knowledge Base'in tarafından kapsanmıyorsa tahmin etme ve adım uydurma. Bu bilgiye sahip olmadığını açıkça söyle, ardından bir support ticket aç:
1. Sorunu açıklayan kısa, 2 ila 4 kelimelik bir ticket_subject ile open_support_ticket'ı bir kez çağır.
2. Sonra müşteriyi thread'e almak için add_ticket_requester'ı çağır.
3. Sonra müşterinin ne sorduğuna dair tek satırlık bir issue_summary ile post_in_ticket'ı çağır.
Ardından müşteriye ticket'ının açık olduğunu ve ekibin yeni thread'de takip edeceğini söyle.
Müşteriden asla Discord ID'sini, channel ID'sini veya thread ID'sini isteme. Bunlar senin için doldurulur.

Identity üzerindeki AI Main Prompt. Bu, ayrı bir yönergeler listesi değil, her zaman kullanılabilir alandır.

Bu bloktaki iki satır yük taşır. “Tahmin etme ve adım uydurma”, bir bilgi boşluğunu makul görünen bir yanıt yerine dürüst bir yanıta dönüştürür. Üç Actions’ı sırayla adlandırmak ise Agent’ın birini seçmek yerine onları bir dizi olarak çağırmasını sağlar.

Sıralama prompt’ta açıklanır, ancak yalnızca orada zorlanmaz. Sonraki iki bölüm bunun hakkındadır.

Step 3: Ticket Actions’ı tek tıklamayla kurun

Actions & MCPs’i açın, Add Action’a tıklayın ve Discord Action’ı seçin.

Discord Action diğer tek tıklamalı galerilerle birlikte durur.

Galeri, Discord template’lerini göreve göre gruplanmış olarak açar: Support & Tickets bu kılavuzun kullandığını içerir, Moderation ise yedi tane daha içerir.

Sekiz kart. Open Support Ticket sizden bir şey isteyen tek karttır.

Open Support Ticket’ı seçin ve kısa bir yapılandırma adımı açılır. Bu, tüm kurulumdaki tek formdur:

Üç açılır liste ve iletişim kutusu ne kurmak üzere olduğunu baştan söyler.

Listeler Discord’dan canlı gelir ve gerçekten çalışabilecek şeylere filtrelenir. Kanallar yalnızca text channel’lardır:

Ticket’ların altında açılacağı kanalı seçin. Thread’ler onun içinde oluşturulur.

Roller ise yalnızca mentionable rollerdir, @everyone hariç tutulur:

Bu, henüz mentionable yapmadığınız bir destek rolünü gizleyen filtredir.

Üç seçimle form tamamlanır:

Tüm yapılandırma. Sunucu, kanal, rol ve önemli olan tek düğme.

Install and enable’a tıklayın. Quickchat AI backend’de tek transaction içinde, zaten aktif üç Actions yazar.

Üç kart, etkin, Discord simgesiyle. Doldurulacak başka bir şey yok.

Buradayken yedi moderation template’i hakkında bilmeye değer iki şey var. Hiç konfigürasyon gerektirmezler, çünkü sunucuyu, üyeyi, rolü veya kanalı Discord isteğinin kendisinden alırlar, bu yüzden karta tıklamak onları hemen kurar. Ayrıca bir template’i iki kez kurmak hata yerine ikinci bir düzenlenebilir kopya verir, bu da varyant oluşturmak için makul bir yoldur.

O tek tıklama aslında ne oluşturdu?

Bunu yazmanız gerekmemiş olsa da anlamaya değer, çünkü daha sonra değiştirmek isteyebileceğiniz her şey burada yaşar.

Üç sıradan HTTP Request Actions. Onları özel olarak işaretleyen hiçbir şey yoktur.

Editörde zaten sahip olduğunuz iki özellik üzerinden birbirlerine bağlanırlar ve ikisini de adıyla bilmeye değer.

Save to memory, bir yanıttan bir değer yakalar ve konuşmada saklar. open_support_ticket, yeni thread’in ID’sini tutmak için bunu kullanır: Discord thread nesnesini döndürür, $.id ID’dir ve memory’ye discord_ticket_thread_id olarak yazılır. İki takip Action’ı daha sonra URL’lerinde bunu geri okur, böylece önceden adlandırmanız gereken bir şey yerine az önce oluşturulan thread üzerinde işlem yaparlar. (Dokümanlarda Save to memory.)

Run only when, bir Action’ı konuşma durumuna göre sınırlar ve herhangi bir istek gönderilmeden önce Quickchat AI tarafında kontrol edilir. (Dokümanlarda Run only when.)

Üç bağımsız Actions’ı güvenilir bir diziye çeviren kapı.

Bu diyagramı iki yönde de okuyun, çünkü iki iş yapıyor:

• Takip işlemleri thread ID’sinin var olmasını gerektirir, böylece Agent hiç oluşturulmamış bir thread hakkında ekibinize bildirim gönderemez.
• open_support_ticket bunun var olmamasını gerektirir, yani Agent aynı konuşmada ikinci bir ticket açamaz, konuşma ne derse desin. Bu bir talimat değil, bir garantidir: bir üye on mesaj daha ayrıntı eklese bile tek ticket’ı olur. Kanal yanıt modunda kanaldaki her alışveriş kendi konuşmasıdır, bu yüzden bir sonraki gerçek soru yine kendi ticket’ını açabilir.

Her Action’ın ayrıca bir Response filter’ı vardır ve bunu yanlış okumak kolaydır. Response filter bir allowlist’tir: Agent’ın görmesine izin verilen yolları adlandırır ve yanıttaki diğer her şey model onu okumadan önce atılır. (Dokümanlarda Response filter.)

Discord sunucunuz hakkında bir düzine alan döndürür. Agent’a iki tanesi gösterilir.

Dizinin ihtiyaç duyduğu thread ID’si Quickchat AI tarafında Save to memory tarafından yakalanır, bu yüzden Agent’ın onu taşıması gerekmez ve sunucunuzla ilgili başka hiçbir şey modele ulaşmaz. Allowlist’i daha da daraltın, daha az görür. Listelediğinizden fazlasını asla görmez.

Bir insan AI’dan devralabilir mi?

Evet ve çoğu ticket botunun dışarıda bıraktığı yarı budur. Kimsenin okumadığı bir ticket sadece bir thread’dir.

Human Handoff ayrı, yerleşik bir Action’dır. Açın ve Handoff Rules altında bir konuşmanın ne zaman bir kişiye ulaşması gerektiğini açıklayın, örneğin “müşteri bir insan istediğinde veya Agent bilgi tabanından yanıtlayamadığında”. Quickchat AI daha sonra konuşmayı Inbox içinde AI tarafından yazılmış bir özetle işaretler, böylece onu alan kişi tüm thread yerine bir paragraf okur. Her handoff ayarının kendi walkthrough’u Human Handoff tutorial içindedir.

Operatör Inbox’ta çalışır. Üye Discord’dan hiç ayrılmaz.

Konuşmayı kendinize atayın ve Inbox composer içinde yanıtlayın. Bu yanıt doğrudan üyenin zaten konuştuğu Discord kanalına iletilir. Sizin tarafınızda bir hesaba, e-posta thread’ine veya portal girişine ihtiyaç duymaz. Bir kişi konuşmanın sahibi olduğu andan itibaren AI sessiz kalır, böylece kendi botunuzla yarışmazsınız.

Aynı kanal, üç gün arayla. Agent reddetti ve yükseltti; ayırıcının altındaki mesaj Quickchat AI Inbox içinde bir kişi tarafından yazıldı. Botunuzun adı altında geldiğine dikkat edin, çünkü Discord’un gönderi yapmamıza izin verdiği tek kimlik botunuzdur.

Aynı konuşma sizin tarafınızdan. Agent’ın reddi, arkasındaki iki Action çağrısı, aşağıda operatörün yanıtı ve kanalın Discord olduğunu, konunun single sign-on olduğunu zaten bilen bir details pane.

Bu sırada özel ticket thread’i ekibinizin konuştuğu yerde kalır: üye içinde ve destek rolünüz bildirilmiş halde çalışma alanıdır. Yanıt, sorunun sorulduğu yere geri gider.

Altı adım. Üçü Discord yazımıdır ve üçü de yalnızca yanıt eksik olduğu için gerçekleşir.

İki şekilde de test edin

Buna güvenmeden önce iki yolu da çalıştırın ve dürüst başarısızlığı en sıkı test edin.

Kapsanan soru. Botu görebildiği bir kanalda @mention edin ve bilgi tabanınızın kapsadığı bir şey sorun. Gerçek adımları kanalda almalısınız ve hiçbir yerde thread olmamalıdır. Ekibinize zaman kazandıran durum budur ve dokümanlarınız iyi olduğunda trafiğinizin çoğu bu olacaktır.

Kapsanmayan soru. Dokümanlarınızın kapsamadığı şeyi sorun. Agent bunu söylemeli ve ardından yükseltmelidir. Aynı anda ticket görünür:

Agent’ın açtığı thread. Sorundan adlandırdı, üyeyi içeri aldı, role bildirim gönderdi ve özeti kendisi yazdı.

Ve thread gerçekten özeldir, bunu kendi üye listesi kanıtlar:

Ticket özel bir thread’dir. Destek konuşmaları herkese açık yürümez.

Tek bir mesajı değil, tüm bir konuşmayı test edin. Yinelenen korumanın değeri ikinci turda, üye ayrıntı eklediğinde ve saf bir bot ikinci bir ticket açtığında görünür.

Run conditions’ın kapsamadığı bir şey. Sıra dışı çağrıyı durdururlar, ancak retry’ı tekilleştirmezler: notify Action’ı elle yeniden çalıştırırsanız ikinci bir mesaj gönderir. Canlı bir ticket’ı kurcalamadan önce bilmeye değer.

Birçok ifadeyi hepsini Discord’a yazmadan aynı anda kontrol etmek için Testing altındaki Simulations’ı kullanın: müşteri mesajlarından bir dataset oluşturun, bunu gerçek Agent’ınıza karşı çalıştırın ve puanlanmış sonuçları birlikte okuyun. Kapsanan ve kapsanmayan soruları tek dataset içinde karıştırın, çünkü iki yol farklı şekillerde başarısız olur.

Altı soru, dördü kapsanan ve ikisi kapsanmayan, tek çalışmada puanlandı. 5. ve 6. satırlar dürüst başarısızlıklardır ve yanıtlar kadar yüksek puan alırlar.

Değerlendirme kriterlerini yalnızca transcript’i görebilen bir grader için yazın, çünkü aldığı tek şey budur. Aksi halde göremediği iki şey size maliyet çıkarır. Discord taraf etkisini göremez, bu yüzden siz söylemezseniz “sizin için bir ticket açtım” ifadesini Agent’ın bir yetenek uydurması olarak okur. Bilgi tabanınızı da göremez, bu yüzden doğru ve spesifik bir yanıtı yalnızca sayıyı kontrol edemediği için uydurma olarak düşük puanlar. İkisi de kriterlerde birer cümleye değer ve dışarıda bırakırsanız en iyi davranışınızı düşük puanlar.

Botun çok fazla ticket açmasını nasıl durdurursunuz?

Çoğu sunucunun ihtiyaç duyduğu tek tuning budur ve çoğunlukla prompt sorunu değildir.

Ticket hacmi bir bilgi tabanı sorunudur. Dokümanlarınızdaki her boşluk ticket olur. Bot beklediğinizden fazla yükseltiyorsa, ticket’ları okuyun: dokümantasyonunuzun yanıtlamadığı soruların listesidir. Bu boşlukları kapatmak hacmi doğrudan azaltır.

Insights, sırada neyi dokümante edeceğinizi söyler. Quickchat AI konuşmaları konuya göre gruplar, böylece tahmin etmek yerine hangi soruların en sık geldiğini görebilirsiniz. Bilgi tabanınızda ilk üç konuyu düzeltin ve yükseltme oranının düştüğünü izleyin.

Bunları kimse yapılandırmadı. Insights, Advanced altında AI-Detected Topics onları konuşmalardan adlandırdı ve sayılar öncelik sırasındaki dokümantasyon backlog’udur.

Bu liste tüm tuning döngüsüdür. Pricing ve API keys en çok geldi, bu yüzden önce o makaleler yazılır ve gelecek haftanın grafiği işe yarayıp yaramadığını söyler. Yukarıdaki konular sizin için keşfedilir; belirli bir ürün alanını özellikle izlemek istiyorsanız Manage Topics altında kendiniz de tanımlayabilirsiniz. Dokümanlarda AI-Detected Topics, Conversation Topics ve konuları yönetme bölümlerine bakın.

Çok istekli yükseltiyorsa, Action açıklamasını yalnızca Agent üyeye bilgiye sahip olmadığını söyledikten sonra tetiklenecek şekilde sıkılaştırın. Çok nadir yükseltiyor ve tahmin etmeye başlıyorsa, main prompt’taki “tahmin etme ve adım uydurma” satırını güçlendirin.

Bunu herkese açık bir sunucuda çalıştırmak güvenli mi?

Herkese açık bir kanalda herkesin konuşabildiği bir bot ciddi biçimde incelenmelidir. Bunu koruyan şey prompt ifadeleri değil, editörde okuyabileceğiniz yapılandırmadır, bu yüzden mesaj nasıl ifade edilirse edilsin geçerlidir.

Bir üye modelle konuşabilir. Orta sütunun ötesine konuşamaz.

Her ticket Action, gerçek bir Discord turn’ü ve sizin sunucunuzu gerektirir. Her Action üzerindeki üç run condition’dan ikisi mesajın gerçekten Discord entegrasyonu üzerinden geldiğini ve kurulumda seçtiğiniz sunucudan geldiğini kontrol eder. Bu değerler mesaj tarafından değil entegrasyon tarafından oluşturulur ve herkese açık chat veya API mesajı bunları sağlayamaz ya da daha eski saklanmış bir kopyayı devralamaz. Agent’ınızın public API’sini bu Actions’a yönlendirin, reddederler.

Birini özel thread’e ekleyen Action’ın model tarafından düzenlenebilir hiçbir parametresi yoktur. URL’si mevcut mesaj için entegrasyonun sağladığı member ID ile biter. Agent farklı bir tane geçemez, bu yüzden sunucunuzdaki rastgele bir üyeyi başka birinin ticket’ına çekemez.

Mention’lar kurulumda kilitlenir. Notify Action, soruyu soran üyeyi ve seçtiğiniz rolü içeren açık bir mention listesi gönderir, parsing devre dışıdır. Agent’ın issue summary içine yazdığı bir mention çözülmez ve @everyone asla tetiklenemez. Buna güvenmek yerine doğrulamaya değer ve geçerlidir: bir role ping ve user mention ulaşır, aynı mesajdaki literal @everyone hiçbir şey yapmaz.

Thread’ler özeldir ve davet edilebilir değildir. type: 12 ve invitable: false olarak oluşturulurlar, bu yüzden ticket’a eklenen bir üye başka kimseyi içine alamaz.

Bot moderasyon yapamaz. Kick, Ban veya Timeout izni yoktur. Bir üyenin Agent’ı yapmaması gereken bir şeye ikna etmesinin en kötü sonucu, normalde sorarak açabileceği bir ticket thread’idir.

Token asla açığa çıkmaz. System Token olarak yaşar, gönderim zamanında enjekte edilir ve bir çağrının kaydedildiği her yerde redakte edilir.

Bilinçli olarak karar verilecek bir şey: ticket thread’leri özeldir, ancak destek rolünüze sahip herkes onları okuyabilir. Destek için istediğiniz budur ve üyeler hassas ayrıntılar yapıştırabilecekse bilmeye değerdir. Gerçekten gizli her şey için onları e-postaya yönlendirin.

Bir Discord AI destek botunun maliyeti nedir?

Free plan, kişisel, ticari olmayan kullanım için ayda 50 AI kredisiyle AI Actions, Human Handoff, bilgi tabanı, Topics ve Insights içerir. İş amaçlı kullanım ücretli plan gerektirir; ücretli planlar ayrıca daha fazla AI kredisi sağlar. Bunu kendiniz çalıştırmaya karşı değerlendiriyorsanız, ücretsiz AI Discord botları self-hosted yolu, maliyet olan saatler dahil dürüstçe karşılaştırır.

İki yol da geçtiğinde Agent’ı serbest bırakın:

1. Üyeleri bota yönlendirin. Kanal konunuzda onu @mention edebileceklerini söyleyin. Kimsenin bilmediği bir bot hiçbir şeyi deflect etmez.
2. İlk günü izleyin. Her Action tam istek ve yanıtla bir çağrı günlüğü tutar ve Inbox her konuşmayı barındırır, böylece neyi yanıtladığını ve neyi yükselttiğini görebilirsiniz.
3. İlk ticket’larınızı bir dokümantasyon backlog’u olarak okuyun. Bunlar dokümanlarınızın henüz yanıtlamadığı sorulardır.

Aynı Agent başka her yerde de çalışır. Bilgi tabanı, prompt ve Human Handoff Discord’a değil Agent’a aittir, bu yüzden aynı destek botu website widget’ınızda, Slack’te, WhatsApp’ta ve e-posta üzerinden yanıt verir, her konuşma aynı Inbox’a düşer. Üç ticket Actions bu kurulumun yalnızca Discord’a özgü bölümüdür. Ekibiniz Discord yerine Slack’te yaşıyorsa, bir Discord rolüne bildirim göndermek yerine handoff bildirimini oraya gönderin.

Discord AI Agent’ınız başka ne yapabilir?

Aynı galeride bir Moderation kategorisi vardır: timeout, kick, ban, unban, assign role, slowmode ve announcements. Bunların her biri author_is_admin is true run condition ile kurulur, bu yüzden yalnızca bir sunucu yöneticisi tetikleyebilir ve bu flag konuşmadan değil Discord’dan gelir. Bu farklı risk profiline sahip farklı bir bottur ve kendi kılavuzunu alır: AI Discord moderation bot oluşturun.

Diğer tüm Discord endpoint’leri aynı tarifi izler: Authorization: Bot {{discord_bot_token}} header’ı olan bir HTTP Request Action, bir veya iki parameter ve Agent’ın ne zaman tetikleyeceğine karar veren sade dilde bir açıklama. Eylem gerçekleştiren bir AI Agent oluşturma bu fikrin başlangıç sürümüdür ve AI Agent’ınızı herhangi bir API’ye bağlama genel durumu kapsar.

Her Discord botu destek botu da değildir. Aynı Agent bunun yerine bir karakter çalıştırabilir: Discord AI roleplay bot, ticket yerine persona’lar için aynı bilgi tabanını ve memory’yi kullanır ve tam karakter kurulumu persona prompt’unu, canon’u ve onu karakterde tutan ayarları adım adım anlatır.

Ek: tam istekler

Bunları hiç yazmazsınız, ancak bir kez okumaya değer ve başka herhangi bir platforma karşı elle oluşturacağınız şeylerdir. {{...}} değerleri gönderim zamanında Quickchat AI tarafından doldurulur.

1. Özel thread’i açın

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, thread’i özel yapan şeydir. auto_archive_duration dakika cinsindendir, bu yüzden 1440 sessiz bir ticket’ı bir gün sonra arşivler. Save to memory, $.id değerini discord_ticket_thread_id olarak yakalar.

2. Soruyu soran üyeyi ekleyin

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

Body yok ve parameters yok. Her iki ID de memory’den ve entegrasyondan gelir.

3. Destek ekibini bilgilendirin

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'ınız açık. <@&YOUR_SUPPORT_ROLE_ID> yeni ticket: {{issue_summary}}",
  "allowed_mentions": { "parse": [], "users": ["{{metadata_discord_author_id}}"], "roles": ["YOUR_SUPPORT_ROLE_ID"] }
}

Bunu kendiniz oluşturursanız iki ayrıntı gerçek debugging zamanına mal olur. Auth scheme Bot, Bearer değil olmalıdır, Discord’u elle çağırırken en yaygın hata budur. Ayrıca allowed_mentions içinde açık users ve roles listeleriyle birlikte boş parse istediğiniz şeydir: @everyone’ı engellerken amaçlanan iki mention’ın geçmesine izin verir. Aynı türden açık bir listenin yanındaki boş olmayan parse, 400 MESSAGE_ALLOWED_MENTIONS_PARSE_EXCLUSIVE ile doğrudan reddedilir.

İlgili kılavuzlar

• AI Discord botu oluşturun, bu kılavuzun varsaydığı kurulum
• AI Discord moderation botu oluşturun, aynı galerinin moderation’a yöneltilmiş hali
• En iyi AI Discord botları, seçeneklerin karşılaştırması
• Ücretsiz AI Discord botları, self-hosting’in size gerçekte neye mal olduğu
• Discord AI roleplay bot, aynı Agent’ın bunun yerine bir karakter çalıştırması
• AI Agent’ınızı HubSpot’a bağlayın, bir CRM için aynı tek tıklamalı galeri
• AI Agent’ınızın actions’ını güvenilir hale getirin, run conditions ve memory ayrıntılı
• AI Agent’ınızı herhangi bir API’ye bağlayın, genel tarif
• Chatbot bilgi tabanı nasıl oluşturulur, ticket hacminizi belirleyen yarı
• Product tutorial: Human Handoff, her handoff ayarı açıklanır

Sık sorulan sorular

Discord’da ticket botu nasıl kurarım?

External Apps içinde kendi Discord uygulamanızı bağlayın, Agent’ınıza bir bilgi tabanı verin, ardından Actions and MCPs’i açın, Add Action’a tıklayın, Discord Action’ı seçin ve Open Support Ticket’ı seçin. Sunucunuzu, ticket kanalınızı ve destek rolünüzü açılır listelerden seçin ve Install and enable’a tıklayın. Kanalı ve rolü oluşturmak dışında barındırılacak hiçbir şey ve Discord içinde yapılandırılacak hiçbir şey yoktur.

Discord ticket botu nasıl yaparım?

Bir Quickchat AI Agent oluşturun, kendi Discord uygulamanızı bağlayın, ardından Actions and MCPs’i açın, Add Action’a tıklayın, Discord Action’ı seçin ve Open Support Ticket’ı seçin. Sunucunuzu, ticket kanalınızı ve destek rolünüzü açılır listelerden seçer, Install and enable’a tıklarsınız ve Quickchat AI sizin için üç eksiksiz AI Actions yazar. Önce Agent’a bir bilgi tabanı verin, çünkü kaç ticket açacağını belirleyen şey budur.

Bir AI, Discord’da destek sorularını yanıtlayabilir mi?

Evet. Agent bilgi tabanınızda arama yapar ve yanıtı bulduğunda kanalda yanıtlar. Deflection kapsamı izler: dokümanlarınızın kapsadığı sorular yanıtlanır, kapsamadığı sorular ticket olur. Bu ilişki, bu botu çalıştırırken anlamanız gereken en yararlı tek şeydir.

Bu Discord ticket botunu oluşturmak için koda ihtiyacım var mı?

Hayır. Discord galerisinden bir template seçer, açılır listelerden bir sunucu, kanal ve rol seçersiniz ve Quickchat AI backend’de method, URL, headers, body, parameters, response settings ve run conditions yazar. Hiçbir zaman Discord ID yazmazsınız ve JSON düzenlemezsiniz.

Template kaç Actions kurar?

Üç. Biri ticket kanalınızda özel bir thread açar ve ID’sini memory’ye kaydeder, biri soruyu soran üyeyi ekler, biri de destek rolünüzden bahseden bir özet gönderir. Hepsi etkin ve birbirine bağlı olarak gelir.

Bot ne zaman ticket açacağını nasıl bilir?

Buna iki şey karar verir. Action açıklaması, Agent’a yalnızca yanıt bilgi tabanında olmadığında çağırmasını söyler ve bir run condition diziyi deterministik hale getirir: bir thread açılmadan önce thread henüz var olmamalıdır, takip işlemlerinin çalışabilmesi için ise var olmalıdır.

Bot yinelenen ticket açabilir mi?

Aynı konuşmada açamaz. Open Support Ticket, memory’de henüz ticket thread ID’si olmamasını gerektiren bir run condition taşır, bu yüzden bir ticket oluştuğunda Agent, prompt ne derse desin o konuşma için ikinci bir ticket açamaz.

Bir insan konuşmayı devralabilir mi?

Evet. Human Handoff, Quickchat AI Inbox’ınızda konuşmayı AI tarafından yazılmış bir özetle işaretler. Kendinize atayın, Inbox içinde bir yanıt yazın ve bu yanıt üyenin zaten bulunduğu aynı Discord kanalına ulaşır. Discord’dan hiç ayrılmazlar ve sizin tarafınızda bir hesaba ihtiyaç duymazlar.

Ticket botu neden kendi Discord uygulamama ihtiyaç duyar?

Ticket Actions, Discord API’yi sizin botunuz olarak çağırır, bu yüzden botunuzun token’ına ihtiyaç duyar. Paylaşılan tek tıklamalı Quickchat AI botu soruları yanıtlayabilir ve Google Sheets Actions kullanabilir. Onun Discord token’ı özel ticket Actions’ınız için kullanılamaz. External Apps içinde Discord’u açın ve yaklaşık on dakika süren Advanced setup’ı seçin.

Bot hangi Discord izinlerine ihtiyaç duyar?

Ticket kanalında View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads ve Manage Threads. Bir destek botunun Kick, Ban veya Timeout iznine ihtiyacı yoktur ve sahip olmadığı bir izin, hakkında hiç düşünmeniz gerekmeyen bir izindir.

Destek rolüm açılır listede neden eksik?

Rol seçici yalnızca Discord’un mentionable olarak bildirdiği rolleri listeler ve @everyone’ı hariç tutar. Destek rolünüz Server Settings, Roles içinde mentionable olarak ayarlanmamışsa görünmez, çünkü template ona bildirim gönderemez.

Discord ticket botunu herkese açık bir sunucuda çalıştırmak güvenli mi?

Kontroller prompt ifadeleri yerine yapılandırmadır, bu yüzden mesaj nasıl ifade edilirse edilsin geçerlidir. Her ticket Action, sıranın gerçekten Discord’dan ve seçtiğiniz sunucudan gelmesini gerektirir, özel thread’e birini ekleyen Action’ın model tarafından düzenlenebilir hiçbir parametresi yoktur, mention’lar soruyu soran üyeye ve seçtiğiniz role kilitlidir, thread’ler özeldir ve davet edilebilir değildir. Run conditions, Quickchat AI’dan herhangi bir istek çıkmadan önce kontrol edilir.

Bir Discord AI destek botunun maliyeti nedir?

Free plan, kişisel ve ticari olmayan kullanım için ayda 50 AI kredisi içerir. AI Actions, Human Handoff, bilgi tabanı, Topics ve Insights dahildir. İş amaçlı kullanım ücretli plan gerektirir; ücretli planlar ayrıca daha fazla AI kredisi sağlar.

Bunun Ticket Tool veya TicketsBot’tan farkı nedir?

Onlar kural tabanlıdır. Bir üye sabitlenmiş paneldeki Create Ticket düğmesine tıklar ve dokümanlarınızın zaten yanıtladığı soru dahil her seferinde bir ticket açılır. Bu bot önce yanıtlar ve yalnızca gerçekten çözemediğini yükseltir, böylece ekibiniz gerçekten bir kişiye ihtiyaç duyan soruları okur.

ChatGPT, Claude veya Gemini bir Discord ticket botu çalıştırabilir mi?

Evet, Quickchat AI üzerinden. Agent’ınız en yeni modellerde çalışır ve bu AI Actions ile Discord API’yi çağırır, böylece bilgi tabanınızdan yanıt verir ve gerçek özel thread’ler açar. Hangi Actions’ın var olacağına ve botun ne yapmasına izin verileceğine siz karar verirsiniz.

Aynı Agent, Discord dışındaki kanallarda çalışabilir mi?

Evet. Bilgi tabanı, prompt ve Human Handoff Discord’a değil Agent’a aittir, bu yüzden aynı destek botu web sitesi widget’ınızda, Slack’te, WhatsApp’ta ve e-posta üzerinden yanıt verir. Üç ticket Actions, bu kurulumun yalnızca Discord’a özgü bölümüdür.

Üyeler botla konuşmayı nasıl başlatır?

Bu kılavuzdaki ticket botu kendi Discord uygulamanızı kullanır, bu yüzden üyeler onu görebildiği bir kanalda @mention ederek başlar. Agent aynı kanalda yanıt verir ve yalnızca yanıtlayamadığında bir ticket thread’i açar. /ask komutu, paylaşılan tek tıklamalı Quickchat AI botuna aittir.

Botun çok fazla ticket açmasını nasıl durdururum?

Önce bilgi tabanı kapsamını iyileştirin, çünkü her boşluk bir ticket olur. İlk ticket’larınızı bir dokümantasyon backlog’u olarak okuyun ve en çok hangi konuların geldiğini görmek için Insights’ı kullanın, böylece sırada ne yazacağınızı bilirsiniz. Ancak bundan sonra Action açıklamasını sıkılaştırın.

Galerinin kurduğu Actions’ı düzenleyebilir miyim?

Her alanı. Bunlar özel olduklarını gösteren hiçbir şey içermeyen sıradan HTTP Request Actions’tır: kilit yok, rozet yok, ayrı politika katmanı yok. URL’yi, body’yi, açıklamayı veya run conditions’ı değiştirin ya da ikinci bir kopya kurup onun yerine onu düzenleyin.

Helpdesk olmadan bir Discord ticket sistemi çalıştırabilir miyim?

Evet. Ticket özel bir Discord thread’idir ve kuyruk Quickchat AI Inbox’ınızdır, bu yüzden döngüde Zendesk, Intercom veya Jira yoktur ve taşınacak hiçbir şey yoktur. Zaten bir helpdesk kullanıyorsanız koruyabilirsiniz: aynı Agent başka bir AI Action ile orada da ticket oluşturabilir ve HubSpot gallery tam olarak bunu yapar.

Bot, help center içeriğimizden yanıt verebilir mi?

Bunun üzerine kuruludur. Help center URL’nizi yapıştırın ve Quickchat AI sayfaları bir bilgi tabanına scrape etsin, veya dosya yükleyip makaleleri doğrudan yapıştırın. Agent her soruda bu makaleleri arar ve yanıtı bulduğunda kanalda yanıtlar, böylece mevcut dokümantasyonunuz yeniden yazılmadan bot olur. Dokümantasyonunuzdan bir AI support agent oluşturma bu yarıyı tek başına adım adım anlatır.

Bot, ticket kanalı açıldığında üyeyi karşılayabilir mi?

Evet, ayrı bir özellik ile. Ticket Tool gibi bir ticket botu kanalı oluşturur ve Quickchat AI’ın New channel automated message’ı birkaç saniye sonra içine sabit bir karşılama mesajı gönderir, böylece üye hemen konuşacak bir şey olduğunu görür. Model çağrılmadığı için kredi maliyeti yoktur. Üyeleri, thread’leri ve ticket kanallarını karşılayın bunu kurar.

Ticket deflection’ı nasıl ölçerim?

Deflection, ticket olmadan yanıtlanan soruların payıdır, bu yüzden bu kurulumda ticket thread’i olmayan konuşmaların tüm konuşmalara bölümüdür. Her Action bir çağrı günlüğü tutar, bu nedenle open_support_ticket çağrılarını saymak yükseltilen yarıyı doğrudan verir ve Insights geri kalanı konuya göre gruplar. Bunu tek bir sayı yerine konu başına izleyin: bir konuda düşen oran, kapatabileceğiniz bir dokümantasyon boşluğudur. Chatbot analytics daha geniş metrik setini kapsar.

Özet

Bir bilgi tabanı ve tek tıklamayla Quickchat AI Agent, Discord sunucunuz için birinci seviye destek botuna dönüşür: dokümanlarınızın kapsadığı soruları yanıtlar, kapsamadığında bunu kabul eder, geri kalanı için özel bir ticket thread’i açar, üyeyi içeri alır, kendi yazdığı bir özetle destek rolünüze bildirim gönderir ve konuşmayı, üye Discord’dan hiç ayrılmadan Inbox’ınızdan yanıtlayan bir insana devreder. Galeri üç Actions’ı yazar, açılır listeler hiç Discord ID yazmamanız anlamına gelir ve run conditions, konuşma plana göre gitmediğinde bile dizinin korunmasını sağlar. Geriye yalnızca sizin yapabileceğiniz iş kalır: yanıt vermeye değer bir bilgi tabanı.