⚠️ Måste läsas före användning
Att använda program för att automatisera personliga konton (self-bot) bryter mot Discords användarvillkor, och kontot riskerar att bli avstängt. Detta är en inneboende förutsättning för tjänsten: du tillhandahåller dina egna kontouppgifter och tar risken själv. Det rekommenderas starkt att använda ett särskilt extrakonto, inte ditt huvudkonto.Distribuera tjänsten
Gå till Konsol → Applikationer, hitta Discord Agent Proxy och skapa en applikation. Aktivera först en prenumeration efter skapandet, gå sedan till konfigurationssidan för att fylla i dina Discord-kontouppgifter och distribuera. Instansresurser konfigureras automatiskt av plattformen, så du behöver inte välja någon specifikation. Efter att distributionen har skickats in kommer du till applikationshanteringssidan, med samma layout för ”Översikt / Loggar / Dokumentation” som Telegram- och WeChat-distributioner. ”Översikt” visar instans- och prenumerationsstatus och bekräftar via kontoförfrågan om Discord är anslutet; att containern körs normalt betyder inte nödvändigtvis att kontot är anslutet. Discord-kontokortet i ”Översikt” tillhandahåller två typer av anslutningsinformation:Visa och testa gränssnitt i konsolen
Öppna fliken ”Dokumentation” för denna applikation för att se förfrågningsparametrar, svarsstrukturer samt exempel i Shell, Python, JavaScript och andra språk för samtliga 14 REST-operationer. Instansadressen och åtkomsttoken fylls i automatiskt; token är dold som standard. VäljGET /api/whoami och klicka på ”Testa” för att bekräfta kontot som proxyn är ansluten till. Åtgärder som att skicka, redigera eller radera meddelanden påverkar det verkliga Discord-kontot, så bekräfta förfrågningsinnehållet innan du testar.
”Ladda ner OpenAPI (JSON)” kan exportera den fullständiga gränssnittsdefinitionen. Filen innehåller instansadressen, men inte åtkomsttoken. Om du behöver byta Discord-kontouppgifter väljer du ”Distribuera igen” i ”Översikt”, fyller i de nya uppgifterna och skickar in.
Så här hämtar du Discord-kontouppgifter
- Logga in på Discord i en datorwebbläsare (discord.com/app)
- Tryck på
F12för att öppna utvecklarverktygen och växla till panelen Network (Nätverk) - Klicka valfritt på en kanal i Discord och observera förfrågningslistan
- Öppna valfri förfrågan till
discord.com/apioch hitta fältetauthorizationunder Request Headers (Förfrågningshuvuden) - Kopiera dess värde
Autentiseringsmetod
Förutom/health och /readyz kräver alla gränssnitt att åtkomsttoken skickas med i förfrågningshuvudet:
Observera: Denna tjänst accepterar endast autentisering via förfrågningshuvuden och stöder inte metoden att lägga till token efter URL:en, såsom?token=xxx. Att öppna gränssnittsadressen direkt i webbläsaren returnerar401 unauthorized, vilket är normalt och inte innebär att distributionen misslyckades. För att bekräfta att processen är aktiv, besök/health; för att bekräfta om Discord-anslutningen kan behandla förfrågningar, besök/readyz. Dessa två sonder kräver ingen autentisering. När proxyns åtkomsttoken inte är konfigurerad returnerar skyddade gränssnitt503och öppnas inte anonymt.
Kontrollera tjänstestatus
/health anger endast att HTTP-processen är aktiv:
/readyz anger om Discord Gateway är tillgänglig. När anslutningen fungerar normalt returneras HTTP 200:
Använd i AI-klienter (MCP)
Claude Code som exempel:claude_desktop_config.json; använd för närvarande Claude Code eller en klient som uttryckligen stöder denna funktion om statiska Bearer-förfrågningshuvuden behövs.
När konfigurationen är klar kan du direkt använda naturligt språk för att be AI:n hantera Discord, till exempel:
Kontrollera om jag har några nya meddelanden i kanalen ”projektdiskussion”. Om någon frågar om lanseringsdatumet, hjälp mig att svara att det är denna fredag.
Tillgängliga verktyg
Användning i program (REST API)
Alla REST-gränssnitt är monterade under/api, svarskroppen är enhetligt {"data": ...}, och vid fel är den {"error": "..."}.
Visa aktuellt konto
Skicka meddelande
Idempotency-Key; processen returnerar det första resultatet utan att skicka dubbelt. Omstart av instansen rensar minnesposterna för dubbletteliminering, som omfattar högst 5 000 poster, därför måste anroparen fortfarande själv spåra långsiktig leveransstatus.
Den valfria parametern reply_to används för att svara på ett angivet meddelande:
Läs meddelanden
Fullständig gränssnittslista
Så här hämtar du kanal-ID och användar-ID
I Discord-klienten öppnar du Användarinställningar → Avancerade inställningar i ordning och aktiverar Utvecklarläge. Högerklicka därefter på valfri kanal eller användare; alternativet ”Kopiera ID” visas i menyn. Du kan också direkt anropaGET /api/guilds och GET /api/guilds/{guild_id}/channels för att räkna upp dem.
Vanliga frågor
Returnerar401 unauthorized
Åtkomsttokenen är felaktig, eller så har den skickats med metoden ?token=. Bekräfta att tokenen skickas via begärandehuvudet Authorization: Bearer <token> och att den överensstämmer med den som visas i konsolen.
Returnerar 503
Anslutningen till Discord har ännu inte upprättats. Besök först /readyz för att kontrollera gateway_ready; om den är false under en längre tid är kontouppgifterna oftast ogiltiga. Hämta dem på nytt och distribuera igen.
Returnerar 403 eller 404
Kontot självt saknar motsvarande behörighet (till exempel är det inte på den servern eller saknar behörighet att tala i kanalen), eller så har fel ID angetts. Denna typ av fel kommer från Discord och är inte ett problem med proxytjänsten.
Returnerar 429
Discords frekvensgräns har utlösts. Fältet retry_after i svaret anger det rekommenderade antalet sekunder att vänta. Minska anropsfrekvensen.
Kontot stängs av efter att ett meddelande har skickats
Som tidigare nämnt bryter automatiserade åtgärder på personliga konton mot Discords användarvillkor. Använd ett dedikerat extrakonto och kontrollera åtgärdsfrekvensen samt undvik känsliga beteenden som massutskick.