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 zum Dashboard, wo der Server als verbunden angezeigt wird.

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

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.

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=309237712896&scope=bot

Woher stammt die Berechtigungszahl?

Die Berechtigungszahl (309237712896) ergibt sich aus folgenden Rechten:

• 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=309237712896&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.

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.

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 /ask, auf Antworten zu seinen eigenen Nachrichten und auf Nachrichten in Threads, die er erstellt hat, und ignoriert alles andere. 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