Discord

Es gibt zwei Wege, deinen AI Agent mit Discord zu verbinden:

1. Zu deinem Discord-Server hinzufügen: der empfohlene Ein-Klick-Weg. Kein Developer Portal und kein Bot-Token, in unter einer Minute live.
2. Eigene Discord-App verwenden: der erweiterte Weg, bei dem du selbst eine Discord-Anwendung erstellst und einen Bot-Token angibst.

Wir empfehlen den Ein-Klick-Weg. Du kannst später zu deiner eigenen App wechseln, wenn du die erweiterten Funktionen brauchst.

Neu bei Quickchat AI? Erstelle zuerst ein kostenloses Konto und komm dann hierher zurück. Mehr über Quickchat AI für Discord erfährst du hier.

Mit Discord verbinden (empfohlen)

Gehe im Quickchat AI Dashboard in der linken Seitenleiste zu Externe Apps, wähle Discord und öffne es. Prüfe unter Connect den Bot-Name auf dem neuen Server, der mit dem Namen deines AI Agents vorausgefüllt ist. Du kannst ihn ändern oder leer lassen, um Quickchat AI zu verwenden. Klicke dann auf Zu deinem Discord-Server hinzufügen. Du benötigst die Berechtigung Manage Server auf dem Zielserver.

Du wirst zu Discord weitergeleitet, um die geteilte Quickchat AI-App zu autorisieren. Wähle den gewünschten Server aus und bestätige die Autorisierung. Quickchat übernimmt den gewählten Namen, bevor der Bot seine einmalige Einführung sendet: “Ready! @mention me or use /ask to chat. Powered by Quickchat AI.” Danach gelangst du zurück zu Quickchat AI.

Was als Nächstes passiert, hängt vom Stand deines Setups ab. Wenn du die Einrichtung eines neuen Kontos noch nicht abgeschlossen hast, bestätigt Quickchat den verbundenen Server und bittet dich, deine Website zur Wissensdatenbank hinzuzufügen. Füge die Website hinzu, um mit dem normalen Setup fortzufahren, oder klicke auf Vorerst überspringen, um direkt zum Schritt Wähle deinen Plan zu gelangen. Nach dem Plan-Schritt endet das Setup in AI Preview. Wenn dein Setup bereits abgeschlossen ist, kehrst du zum Dashboard zurück, wo der Server als verbunden angezeigt wird.

Die Autorisierung ist jetzt abgeschlossen. 🎉 Dein AI Agent ist live auf Discord. Mitglieder starten eine Unterhaltung, indem sie ihn in einem Kanal @erwähnen, und er antwortet in Kanälen oder Threads.

Jede Discord-Unterhaltung erscheint im Quickchat AI Posteingang. Wenn dein AI Agent eine Unterhaltung an ein Teammitglied übergibt, kann das Teammitglied sie im Posteingang übernehmen und direkt im selben Discord-Kanal, im selben Thread oder in derselben DM antworten.

Neu registrierte Quickchat-AI-Nutzer erhalten ein Setup im Discord-Branding, das sie direkt in diesen Ablauf führt, sodass du deinen ersten Server möglicherweise schon während des Onboardings verbunden hast.

Wie Mitglieder mit dem Bot sprechen

Der Bot antwortet nicht auf jede Nachricht in einem Kanal. Er antwortet, wenn er mit @ erwähnt wird, wenn jemand den Befehl /ask nutzt, wenn jemand auf eine seiner Nachrichten antwortet, und in Threads, die er erstellt hat. Alles andere ignoriert er bewusst, damit er auf einem aktiven Server nicht stört.

Das ist es wert, den Mitgliedern zu sagen: Eine normale Nachricht ohne Antwort wirkt wie ein kaputter Bot und nicht wie einer, der darauf wartet, angesprochen zu werden.

/ask ist oft leichter zu entdecken: Wenn du / in einem Kanal tippst, erscheint “Ask the Quickchat AI agent a question” in der Liste, und der Befehl funktioniert auch dort, wo Nachrichteninhalte eingeschränkt sind. Es gibt ihn nur beim Ein-Klick-Bot; wenn du deine eigene Discord-App nutzt, verwende @Erwähnungen.

Nachrichtenkontingent

Jede Antwort wird von einem Sprachmodell erzeugt und zählt auf das AI-Nachrichtenkontingent deines Tarifs. Ein aktiver Server verbraucht ein kostenloses Kontingent schnell, und wenn es aufgebraucht ist, sagt der Bot das im Kanal, statt zu antworten. Das Kontingent wird monatlich zurückgesetzt.

Deine Server verwalten

Die Discord-Seite listet unter Verbundene Server jeden Server auf, in dem der geteilte Bot aktiv ist. Von dort aus kannst du:

• Den Namen des Bots später ändern. Gib unter Bot-Name auf diesem Server bis zu 32 Zeichen ein und klicke dann auf Übernehmen. Leere das Feld und klicke auf Übernehmen, um den geteilten Namen Quickchat AI wiederherzustellen.
• Den Bot mit demselben Ein-Klick-Ablauf zu einem weiteren Server hinzufügen. Prüfe vor der Autorisierung den Bot-Name auf dem neuen Server, damit ein AI Agent auf jedem Server einen anderen Namen verwenden kann.
• Den Bot von einem Server entfernen. Er verlässt diesen Server und antwortet nicht mehr, und du kannst ihn jederzeit wieder hinzufügen.

Jeder verbundene Server hat außerdem Automatische Nachrichten, beschrieben im Abschnitt Automatische Nachrichten weiter unten.

Ein Discord-Server kann jeweils mit einem AI Agent verbunden sein. Wenn du “Dieser Discord-Server ist bereits mit einem anderen AI Agent verbunden” siehst, entferne ihn zuerst von diesem Agent oder wähle einen anderen Server.

Wenn Discord den Server verbindet, aber den Bot-Namen nicht übernimmt, klicke beim verbundenen Server auf Übernehmen, um es erneut zu versuchen. Wenn Discord ein Berechtigungsproblem meldet, klicke auf Zu einem weiteren Server hinzufügen, wähle denselben Server und autorisiere ihn erneut. Dadurch werden die Berechtigungen des Bots aktualisiert, ohne dass du ihn zuerst entfernen musst.

Wann du deine eigene Discord-App verwenden solltest

Der Ein-Klick-Bot nutzt die geteilte Quickchat AI-Anwendung und den Avatar, aber du kannst ihm auf jedem verbundenen Server einen anderen Namen geben. Richte deine eigene Discord-App ein (siehe unten), wenn du Folgendes möchtest:

• Einen eigenen Bot-Avatar
• Direktnachrichten
• Discord AI Actions. Der geteilte Bot stellt seinen Token nicht als den {{discord_bot_token}} System Token bereit, den diese Actions benötigen, daher ist dafür deine eigene App erforderlich.
• Mehrere Bots auf einem Server

Der geteilte Bot und dein eigener Bot können nebeneinander laufen. Deine eigene App übernimmt einen Server erst, wenn du den geteilten Bot von diesem Server entfernst.

Eigene Discord-App verwenden (Erweitertes Setup)

Dies ist der erweiterte Weg und dauert etwa 10 Minuten. Öffne im Dashboard Externe Apps → Discord und öffne Eigene Discord-App verwenden über den Link Erweitertes Setup. Du erstellst deine eigene Discord-Anwendung, fügst sie zu deinem Server hinzu und verbindest sie über einen Bot-Token mit Quickchat AI.

Play

Einen Discord-Server erstellen

Für die Integration benötigst du einen Discord-Server. Falls du noch kein Discord-Konto hast, besuche discord.com und erstelle eines. Nach dem Login folge dieser Anleitung zum Erstellen deines Discord-Servers.

Eine Discord-Anwendung erstellen

Gehe zu discord.com/developers/applications, während du in deinem Discord-Konto angemeldet bist, und erstelle eine neue Anwendung.

Deine Discord-Anwendung konfigurieren

Bevor du den Bot zum Server hinzufügst, aktiviere die Message Content Intent für deine Anwendung. Dadurch kann dein Bot Nachrichten lesen, die von Nutzern auf deinem Server gesendet werden.

Den Bot zu deinem Discord-Server hinzufügen

Nun musst du deinen Bot zu deinem Server hinzufügen. Erstelle dazu die folgende Discord-URL und füge sie in deinen Browser ein:

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

Woher stammt die Berechtigungszahl?

Die Berechtigungszahl (309237713920) ergibt sich aus folgenden Rechten:

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

Das ist das minimale Set an Berechtigungen, damit dein Bot korrekt funktioniert. Du kannst dies selbst nachsehen unter discord.com/developers/applications: Wähle deine Anwendung, klicke links auf Bot und scrolle nach unten:

Wo finde ich MEINE CLIENT ID?

Am einfachsten schaust du in die Adresszeile deines Browsers und kopierst die lange Zahl, die Teil der Adresse ist:

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

In diesem Beispiel ist die Client-ID 1234567890123456789. Die vollständige URL zum Hinzufügen des Bots lautet dann:

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

Deinen Discord-Bot mit Quickchat AI verbinden

Um deinen Bot mit Quickchat AI zu verbinden, hole dir deinen Discord Bot Token aus dem Developer Portal.

1. Gehe zu Bot Settings → Reset Token → Copy Token

2. Gehe im Quickchat AI Dashboard zu Externe Apps → Discord, wähle über Erweitertes Setup die Option Eigene Discord-App verwenden und füge deinen Token ein. Quickchat AI schaltet den Bot ein und meldet seinen Status, während er hochfährt.

Eine Discord-App kann jeweils nur mit einem AI Agent verbunden sein. Wenn du “Diese Discord-App ist bereits mit einem anderen AI Agent verbunden.” siehst, trenne sie dort, bevor du sie hier verbindest.

Dein AI-Bot ist live!

Wechsle zurück zu Discord, dein Bot sollte online sein und bereit zum Chatten! @erwähne ihn, um eine Unterhaltung zu starten. 🤖💬

Standardmäßig antwortet der Bot bei einer @Erwähnung im selben Kanal. Du kannst dies mit der Einstellung Antwortmodus in der Integration ändern: Im Kanal antworten (Standard) oder In Threads antworten. Bei In Threads antworten antwortet der Bot in einem Thread, und Nutzer können das Gespräch dort fortsetzen, ohne den Bot erneut zu erwähnen.

Automatische Nachrichten

Automatische Nachrichten posten nach einem Discord-Ereignis eine feste, bearbeitbare Nachricht. Sie rufen den AI Agent nicht auf und verbrauchen keine Conversation Credits, und jede Regel ist deaktiviert, bis du sie einschaltest. Sie funktionieren mit beiden Setups:

• Ein-Klick: Wähle unter Verbundene Server bei dem gewünschten Server Automatische Nachrichten.
• Eigene Discord-App: Öffne Erweitertes Setup, suche Automatische Nachrichten und wähle beim gewünschten Server Konfigurieren. Dein Bot muss sich bereits auf dem Server befinden, damit er angezeigt wird.

Es stehen drei Regeln zur Verfügung, jede mit einem eigenen Schalter:

• Neues Mitglied tritt bei: Wähle einen Willkommenskanal, in dem der Bot jedes neue Mitglied begrüßt. Andere Bots, die dem Server beitreten, werden ignoriert.
• Neuer Thread oder Forum-Post: Wähle einen Übergeordneten Kanal (Text, Ankündigungen, Forum oder Medien). Der Bot postet in jedem neuen öffentlichen Thread darunter und ignoriert private Threads.
• Neuer Kanal: Der Bot postet in jedem neuen Textkanal. Um das einzugrenzen, ändere Beliebige Kategorie in Nur in dieser Kategorie. Die Kombination mit der Kategorie Aktive Tickets eines Ticket-Bots ist die übliche Einrichtung.

Wähle eine Regel aus, um sie zu öffnen. Wenn du eine Regel einschaltest, die noch kein Ziel hat, wird sie ebenfalls geöffnet, damit du eines auswählen kannst.

Bearbeite innerhalb einer Regel die Nachrichtenvorlage und wähle eine Verzögerung: Keine Verzögerung oder 2, 5, 10 oder 30 Sekunden. Die standardmäßige Verzögerung von 2 Sekunden gibt einem Ticket- oder Onboarding-Bot Zeit, zuerst zu posten. Vorlagen können {username}, {bot_name}, {server_name} und {channel_name} verwenden. Wähle einen Platzhalter aus, um ihn an der Cursorposition einzufügen. In einem Kanal, den ein anderer Bot geöffnet hat, wird {username} nach Möglichkeit aus genau einer mitgliedsspezifischen Berechtigung View Channel abgeleitet und fällt auf there zurück, wenn der Anfragende nicht eindeutig ist.

Jede Regel wird einzeln gespeichert. Speichern sichert diese Regel und bringt dich zurück zur Liste, und die Schalter in der Liste werden sofort gespeichert, sobald du einen umlegst. Wenn du eine Regel auf andere Weise verlässt, gehen die dort vorgenommenen Änderungen verloren.

Beim Ein-Klick-Bot wird eine gespeicherte Änderung sofort angewendet. Ein über Erweitertes Setup verbundener Bot aktualisiert diese Regeln innerhalb von etwa einer Minute. Eine Änderung an Neues Mitglied tritt bei kann den Bot außerdem neu starten, um den Server Members Intent zu aktualisieren.

Der Bot muss jedes ausgewählte Ziel sehen und darin Nachrichten senden können. Wenn eine Kategorie oder ein Kanal später in Discord gelöscht wird, zeigt dir das Speichern der Regel, die darauf verweist, welche Auswahl fehlt. Deine anderen Regeln lassen sich weiterhin normal speichern.

Server Members Intent

Neues Mitglied tritt bei ist die einzige Regel, die etwas aus dem Discord Developer Portal benötigt, und das nur, wenn du deine eigene Discord-App verwendest. Discord behandelt “wer diesem Server beigetreten ist” als privilegierten Intent, der standardmäßig deaktiviert ist. Ohne ihn bemerkt dein Bot ein neues Mitglied nie.

Quickchat AI prüft das für dich. Wenn du die Regel öffnest, wird dir angezeigt, ob der Intent deaktiviert ist, und nichts mehr, sobald er aktiv ist. Zum Aktivieren öffnest du deine Anwendung im Developer Portal, gehst zu Bot → Privileged Gateway Intents, schaltest Server Members Intent ein, speicherst und speicherst dann die Regel in Quickchat AI erneut. Dein Bot antwortet währenddessen ganz normal weiter; nur diese eine Regel wartet.

Wenn dein eigener Bot auf mehr als 100 Servern ist, verlangt Discord eine Verifizierung deiner Anwendung, bevor der Intent gewährt wird.

Die beiden anderen Regeln benötigen nichts zusätzlich, und der Ein-Klick-Bot benötigt gar nichts: In der geteilten Anwendung Quickchat AI ist der Intent bereits aktiviert.

Discord-Aktionen

Wenn deine eigene Discord-App verbunden ist, öffne Aktionen & MCPs, klicke auf + Add Action und wähle Discord-Aktion. Die Galerie installiert vollständige Support- und Moderationsaktionen:

• Support & Tickets: Wähle einen Server und einen Text-Channel aus. Optional kannst du eine mentionable Support-Rolle auswählen. Eine Installation erstellt drei bearbeitbare Actions, die einen privaten Thread öffnen, den Anfragenden hinzufügen und den Support optional benachrichtigen.
• Moderation: Timeout, Kick, Bann, Bann aufheben, Rolle zuweisen, Slowmode festlegen und Ankündigung senden. Jedes Template erstellt eine bearbeitbare Action.

Quickchat füllt Methode, URL, Header, Body, Parameter, Beschreibung, Response-Verarbeitung und Bedingungen unter Nur ausführen, wenn im Backend aus. Die resultierenden Actions verwenden den normalen Editor und bleiben vollständig bearbeitbar.

Jedes Moderationstemplate beginnt mit author_is_admin is true. Discord liefert diesen Wert für den Autor der aktuellen Nachricht und Quickchat prüft ihn vor dem Aufruf der Action. Metadaten aus dem öffentlichen Chat oder der API können ihn nicht setzen. Behalte diese Bedingung bei, sofern du keine andere vertrauenswürdige Autorisierungsgrenze entwickelt hast. Die Templates fügen keine Bestätigungsnachrichten, keinen Replay-Schutz, keine Retry-Behandlung und keine separate Policy für Berechtigungen oder Rollenhierarchie hinzu. Discord prüft weiterhin die Berechtigungen und Rollenposition des Bots.

Achtung

Discord-Aktionen benötigen den Bot-Token aus dem Erweiterten Setup mit deiner eigenen Discord-App. Der gemeinsame One-Click-Bot allein kann ihn nicht bereitstellen. Teste Moderationsaktionen im Discord-Server sowohl mit einem Administrator- als auch mit einem Nicht-Administrator-Konto. AI Preview stellt keinen autorisierten Discord-Absender bereit.

Support-Tickets verwenden Im Memory speichern und Nur ausführen, wenn statt einer speziellen Workflow-Runtime. Die erste Action speichert die von Discord zurückgegebene Thread-ID als discord_ticket_thread_id. Die nächsten beiden Actions lesen diesen Wert, um den Anfragenden hinzuzufügen und die Benachrichtigung zu posten. Beschreibe dieselbe Reihenfolge im Haupt-Prompt des Agents. Wenn ein Ergebnis unklar ist, prüfe Discord und das Action-Log vor einem erneuten Versuch. Die gespeicherte Thread-ID wird nicht automatisch gelöscht, daher unterstützt die Vorlage ein Ticket pro Quickchat-Konversation. Starte für ein weiteres Ticket eine neue Discord-Konversation oder einen neuen Thread, oder bearbeite die Actions und ergänze den benötigten Memory-Lebenszyklus.

Gewähre dem Bot für Support-Tickets im ausgewählten Ticket-Channel View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads und Manage Threads. Die Benachrichtigung einer Rolle ist optional. Wenn du eine Support-Rolle auswählst, muss sie mentionable sein und ihre Mitglieder benötigen Zugriff auf private Threads. Wenn du keine Rolle auswählst oder keine mentionable Rollen verfügbar sind, werden Tickets dennoch normal geöffnet, ohne eine Rolle zu benachrichtigen. Der Picker listet Text-Channels und mentionable Rollen auf, prüft aber nicht alle Berechtigungsüberschreibungen des Channels.

Die generierte Konfiguration und die Einschränkungen des MVP findest du unter Aktionen.

Fehlerbehebung

Wenn Quickchat AI auf der Discord-Integrationsseite einen Fehler meldet, verlinkt es direkt auf den passenden Abschnitt unten.

Ein-Klick-Verbindung

Der Ein-Klick-Ablauf schlägt nur selten fehl. Falls die Verbindung nicht abgeschlossen wird:

• “Dieser Discord-Server ist bereits mit einem anderen AI Agent verbunden”: Der Server ist einem anderen Agent zugeordnet. Entferne ihn zuerst von diesem Agent oder wähle einen anderen Server.
• “Du hast keine Berechtigung, Discord für diesen AI Agent zu verbinden”: Das Verbinden eines Kanals ist eine Editor-Aktion. Bitte einen Admin oder Editor im Account, ihn zu verbinden, und stelle sicher, dass du die Berechtigung Manage Server auf dem gewählten Discord-Server hast.
• “Die Discord-Autorisierung wurde abgebrochen”: Du hast Discords Autorisierungsbildschirm geschlossen, bevor er abgeschlossen war. Es wurde nichts verbunden, klicke also auf Zu deinem Discord-Server hinzufügen und versuche es erneut.

Die folgenden Abschnitte gelten für den Weg Eigene Discord-App verwenden.

Der Bot ist auf meinem Server, antwortet aber nie

Fast immer heißt das, dass ihn noch niemand angesprochen hat. Der Bot antwortet auf @Erwähnungen, auf Antworten zu seinen eigenen Nachrichten und auf Nachrichten in Threads, die er erstellt hat, und ignoriert alles andere. Der Ein-Klick-Bot antwortet außerdem auf /ask. Erwähne ihn mit @ und schau, ob er antwortet.

Wenn er dann immer noch nicht antwortet, prüfe, ob seine Rolle und die Kanal-Berechtigungsüberschreibungen ihm View Channel, Send Messages und Read Message History in genau diesem Kanal erlauben.

Wenn er vorher geantwortet hat und jetzt still ist, prüfe, ob das AI-Nachrichtenkontingent des Monats aufgebraucht ist.

/ask erscheint nicht, wenn ich / tippe

Discord kann bis zu einer Stunde brauchen, um Befehle nach dem Beitritt eines Bots an alle Clients zu verteilen. Ein Neustart deines Discord-Clients bringt ihn meist früher zum Vorschein. Erwähne den Bot in der Zwischenzeit mit @.

Message Content Intent

PrivilegedIntentsRequired: Dein Bot hat sich verbunden, aber sein Message Content Intent ist ausgeschaltet, sodass er keine Nachrichten lesen kann. Öffne im Developer Portal deine Anwendung, gehe zu Bot → Privileged Gateway Intents, schalte Message Content Intent ein und speichere. Der Bot startet automatisch neu, das dauert etwa eine Minute.

Ungültiger Bot-Token

InvalidToken: Der Token, den Quickchat AI hat, ist falsch oder wurde neu generiert. Ein Bot-Token wird nur einmal angezeigt, und ein Zurücksetzen macht den alten ungültig. Öffne im Developer Portal deine Anwendung, gehe zu Bot, klicke auf Reset Token, kopiere den neuen Token, klicke dann in Quickchat AI auf Reconnect und füge ihn ein.

Require OAuth2 Code Grant

Wenn beim Hinzufügen des Bots “Integration requires code grant” erscheint, hat deine Anwendung Require OAuth2 Code Grant aktiviert, was den einfachen Bot-Invite-Flow blockiert. Öffne im Developer Portal deine Anwendung, gehe zu Bot, schalte Require OAuth2 Code Grant aus, speichere und öffne die Einladungs-URL erneut.

Die Autorisierungsseite zeigt einen Kuchen oder eine “baked”-Meldung

Dieser kuriose Bildschirm ist Discords Erfolgsseite: Der Bot wurde hinzugefügt. Zur Bestätigung öffne in deinem Server Servereinstellungen → Integrationen → Bots und Apps und suche deinen Bot in der Liste.

Bot antwortet nach der Einrichtung nicht

Der Bot startet neu, wenn du seinen Token oder seine Einstellungen änderst, warte also nach dem Speichern bis zu einer Minute. Wenn er weiterhin nicht online geht oder antwortet:

1. Öffne im Quickchat AI Dashboard Externe Apps → Discord und prüfe den Verbindungsstatus. Ein ungültiger Token oder ein fehlender Intent wird dort gemeldet, mit einem Link zur genauen Lösung.
2. Stelle sicher, dass Message Content Intent eingeschaltet ist (siehe oben) und der Token aktuell ist (im Zweifel Reset Token).
3. @erwähne den Bot in einem Channel, auf den er Zugriff hat, und prüfe, dass seine Rollen- und Channel-Berechtigungen Send Messages, Create Public Threads, Send Messages in Threads und Read Message History umfassen.
4. Wähle mit der Einstellung Antwortmodus unter Externe Apps → Discord, ob er im Channel oder in einem Thread antwortet.

Tipp

Die Discord-Integrationsseite im Quickchat AI Dashboard zeigt deine Verbundene Server für den Ein-Klick-Bot und, unter Erweitertes Setup, das Bot Token-Feld deiner eigenen App, einen Antwortmodus-Selektor (Im Kanal antworten oder In Threads antworten) sowie einen Link, um unserer Discord-Community beizutreten und Hilfe zu erhalten.

---

Tritt unserem Discord-Server bei, um mehr darüber zu erfahren, wie du das Beste aus Quickchat AI herausholst 👉 discord.gg/KqkHwvPRNH