Sim

Discord

Mit Discord interagieren

Discord ist eine leistungsstarke Kommunikationsplattform, die es dir ermöglicht, dich mit Freunden, Communities und Teams zu verbinden. Sie bietet eine Reihe von Funktionen für die Teamzusammenarbeit, darunter Textkanäle, Sprachkanäle und Videoanrufe.

Mit einem Discord-Account oder -Bot kannst du:

  • Nachrichten senden: Nachrichten an einen bestimmten Kanal senden
  • Nachrichten abrufen: Nachrichten aus einem bestimmten Kanal abrufen
  • Server abrufen: Informationen über einen bestimmten Server abrufen
  • Benutzer abrufen: Informationen über einen bestimmten Benutzer abrufen

In Sim ermöglicht die Discord-Integration deinen Agenten den Zugriff auf die Discord-Server deiner Organisation. Agenten können Informationen aus Discord-Kanälen abrufen, nach bestimmten Benutzern suchen, Serverinformationen erhalten und Nachrichten senden. Dies ermöglicht deinen Workflows, sich mit deinen Discord-Communities zu integrieren, Benachrichtigungen zu automatisieren und interaktive Erlebnisse zu schaffen.

Wichtig: Um Nachrichteninhalte lesen zu können, benötigt dein Discord-Bot die Berechtigung "Message Content Intent" im Discord Developer Portal. Ohne diese Berechtigung erhältst du zwar weiterhin Nachrichten-Metadaten, aber das Inhaltsfeld wird leer angezeigt.

Discord-Komponenten in Sim verwenden effizientes Lazy Loading und rufen Daten nur bei Bedarf ab, um API-Aufrufe zu minimieren und Rate-Limiting zu verhindern. Die Token-Aktualisierung erfolgt automatisch im Hintergrund, um deine Verbindung aufrechtzuerhalten.

Einrichtung deines Discord-Bots

  1. Gehe zum Discord Developer Portal
  2. Erstelle eine neue Anwendung und navigiere zum "Bot"-Tab
  3. Erstelle einen Bot und kopiere deinen Bot-Token
  4. Aktiviere unter "Privileged Gateway Intents" den Message Content Intent, um Nachrichteninhalte lesen zu können
  5. Lade deinen Bot mit den entsprechenden Berechtigungen auf deine Server ein

Nutzungsanleitung

Umfassende Discord-Integration: Nachrichten, Threads, Kanäle, Rollen, Mitglieder, Einladungen und Webhooks.

Tools

discord_send_message

Eine Nachricht an einen Discord-Kanal senden

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, an die die Nachricht gesendet werden soll
contentstringNeinDer Textinhalt der Nachricht
serverIdstringJaDie Discord-Server-ID (Guild-ID)
filesfile[]NeinDateien, die an die Nachricht angehängt werden sollen

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDiscord-Nachrichtendaten

discord_get_messages

Nachrichten aus einem Discord-Kanal abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, von der Nachrichten abgerufen werden sollen
limitnumberNeinMaximale Anzahl der abzurufenden Nachrichten (Standard: 10, max: 100)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectContainer für Nachrichtendaten

discord_get_server

Informationen über einen Discord-Server (Guild) abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDiscord-Server (Guild) Informationen

discord_get_user

Informationen über einen Discord-Benutzer abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDiscord-Bot-Token zur Authentifizierung
userIdstringJaDie Discord-Benutzer-ID

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDiscord-Benutzerinformationen

discord_edit_message

Eine bestehende Nachricht in einem Discord-Kanal bearbeiten

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der zu bearbeitenden Nachricht
contentstringNeinDer neue Textinhalt für die Nachricht
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectAktualisierte Discord-Nachrichtendaten

discord_delete_message

Eine Nachricht aus einem Discord-Kanal löschen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der zu löschenden Nachricht
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_add_reaction

Füge eine Reaktions-Emoji zu einer Discord-Nachricht hinzu

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der Nachricht, auf die reagiert werden soll
emojistringJaDas Emoji für die Reaktion (Unicode-Emoji oder benutzerdefiniertes Emoji im Format name:id)
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_remove_reaction

Entferne eine Reaktion von einer Discord-Nachricht

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der Nachricht mit der Reaktion
emojistringJaDas zu entfernende Emoji (Unicode-Emoji oder benutzerdefiniertes Emoji im Format name:id)
userIdstringNeinDie Benutzer-ID, deren Reaktion entfernt werden soll (weglassen, um die eigene Reaktion des Bots zu entfernen)
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_pin_message

Eine Nachricht in einem Discord-Kanal anpinnen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der anzupinnenden Nachricht
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_unpin_message

Eine Nachricht in einem Discord-Kanal lösen (Unpin)

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die die Nachricht enthält
messageIdstringJaDie ID der zu lösenden Nachricht
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_create_thread

Einen Thread in einem Discord-Kanal erstellen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, in der der Thread erstellt werden soll
namestringJaDer Name des Threads (1-100 Zeichen)
messageIdstringNeinDie Nachrichten-ID, aus der ein Thread erstellt werden soll (falls aus einer bestehenden Nachricht erstellt wird)
autoArchiveDurationnumberNeinDauer in Minuten bis zur automatischen Archivierung des Threads (60, 1440, 4320, 10080)
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectErstellte Thread-Daten

discord_join_thread

Einem Thread in Discord beitreten

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
threadIdstringJaDie Thread-ID, der beigetreten werden soll
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_leave_thread

Einen Thread in Discord verlassen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
threadIdstringJaDie Thread-ID, die verlassen werden soll
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_archive_thread

Einen Thread in Discord archivieren oder dearchivieren

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
threadIdstringJaDie Thread-ID zum Archivieren/Dearchivieren
archivedbooleanJaOb der Thread archiviert (true) oder dearchiviert (false) werden soll
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectAktualisierte Thread-Daten

discord_create_channel

Einen neuen Kanal in einem Discord-Server erstellen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
namestringJaDer Name des Kanals (1-100 Zeichen)
typenumberNeinKanaltyp (0=Text, 2=Sprache, 4=Kategorie, 5=Ankündigung, 13=Bühne)
topicstringNeinKanalthema (0-1024 Zeichen)
parentIdstringNeinÜbergeordnete Kategorie-ID für den Kanal

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDaten des erstellten Kanals

discord_update_channel

Discord-Kanal aktualisieren

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die aktualisiert werden soll
namestringNeinDer neue Name für den Kanal
topicstringNeinDas neue Thema für den Kanal
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDaten des aktualisierten Kanals

discord_delete_channel

Discord-Kanal löschen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die gelöscht werden soll
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_get_channel

Informationen über einen Discord-Kanal abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, die abgerufen werden soll
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectKanaldaten

discord_create_role

Eine neue Rolle in einem Discord-Server erstellen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
namestringJaDer Name der Rolle
colornumberNeinRGB-Farbwert als Ganzzahl (z.B. 0xFF0000 für rot)
hoistbooleanNeinOb Rollenmitglieder getrennt von Online-Mitgliedern angezeigt werden sollen
mentionablebooleanNeinOb die Rolle erwähnt werden kann

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectDaten der erstellten Rolle

discord_update_role

Eine Rolle in einem Discord-Server aktualisieren

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
roleIdstringJaDie zu aktualisierende Rollen-ID
namestringNeinDer neue Name für die Rolle
colornumberNeinRGB-Farbwert als Ganzzahl
hoistbooleanNeinOb Rollenmitglieder separat angezeigt werden sollen
mentionablebooleanNeinOb die Rolle erwähnt werden kann

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectAktualisierte Rollendaten

discord_delete_role

Eine Rolle aus einem Discord-Server löschen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
roleIdstringJaDie zu löschende Rollen-ID

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_assign_role

Eine Rolle einem Mitglied auf einem Discord-Server zuweisen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie Benutzer-ID, der die Rolle zugewiesen werden soll
roleIdstringJaDie Rollen-ID, die zugewiesen werden soll

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_remove_role

Eine Rolle von einem Mitglied auf einem Discord-Server entfernen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie Benutzer-ID, von der die Rolle entfernt werden soll
roleIdstringJaDie Rollen-ID, die entfernt werden soll

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_kick_member

Ein Mitglied von einem Discord-Server entfernen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie Benutzer-ID des zu entfernenden Benutzers
reasonstringNeinGrund für die Entfernung des Mitglieds

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_ban_member

Ein Mitglied von einem Discord-Server sperren

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie Benutzer-ID, die gesperrt werden soll
reasonstringNeinGrund für die Sperrung des Mitglieds
deleteMessageDaysnumberNeinAnzahl der Tage, für die Nachrichten gelöscht werden sollen (0-7)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_unban_member

Die Sperrung eines Mitglieds auf einem Discord-Server aufheben

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie Benutzer-ID, deren Sperrung aufgehoben werden soll
reasonstringNeinGrund für die Aufhebung der Sperrung des Mitglieds

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_get_member

Informationen über ein Mitglied in einem Discord-Server abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie abzurufende Benutzer-ID

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectMitgliedsdaten

discord_update_member

Ein Mitglied in einem Discord-Server aktualisieren (z.B. Nickname ändern)

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
serverIdstringJaDie Discord-Server-ID (Guild-ID)
userIdstringJaDie zu aktualisierende Benutzer-ID
nickstringNeinNeuer Nickname für das Mitglied (null zum Entfernen)
mutebooleanNeinOb das Mitglied in Sprachkanälen stummgeschaltet werden soll
deafbooleanNeinOb das Mitglied in Sprachkanälen taub geschaltet werden soll

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectAktualisierte Mitgliedsdaten

discord_create_invite

Einen Einladungslink für einen Discord-Kanal erstellen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, für die eine Einladung erstellt werden soll
maxAgenumberNeinDauer der Einladung in Sekunden (0 = läuft nie ab, Standard 86400)
maxUsesnumberNeinMaximale Anzahl der Verwendungen (0 = unbegrenzt, Standard 0)
temporarybooleanNeinOb die Einladung temporäre Mitgliedschaft gewährt
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectErstellte Einladungsdaten

discord_get_invite

Informationen über eine Discord-Einladung abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
inviteCodestringJaDer abzurufende Einladungscode
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectEinladungsdaten

discord_delete_invite

Discord-Einladung löschen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
inviteCodestringJaDer zu löschende Einladungscode
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

discord_create_webhook

Webhook in einem Discord-Kanal erstellen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
channelIdstringJaDie Discord-Kanal-ID, in der der Webhook erstellt werden soll
namestringJaName des Webhooks (1-80 Zeichen)
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectErstellte Webhook-Daten

discord_execute_webhook

Discord-Webhook ausführen, um eine Nachricht zu senden

Eingabe

ParameterTypErforderlichBeschreibung
webhookIdstringJaDie Webhook-ID
webhookTokenstringJaDer Webhook-Token
contentstringJaDer zu sendende Nachrichteninhalt
usernamestringNeinÜberschreibt den Standardbenutzernamen des Webhooks
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectÜber Webhook gesendete Nachricht

discord_get_webhook

Informationen über einen Discord-Webhook abrufen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
webhookIdstringJaDie abzurufende Webhook-ID
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung
dataobjectWebhook-Daten

discord_delete_webhook

Einen Discord-Webhook löschen

Eingabe

ParameterTypErforderlichBeschreibung
botTokenstringJaDer Bot-Token zur Authentifizierung
webhookIdstringJaDie zu löschende Webhook-ID
serverIdstringJaDie Discord-Server-ID (Guild-ID)

Ausgabe

ParameterTypBeschreibung
messagestringErfolgs- oder Fehlermeldung

Hinweise

  • Kategorie: tools
  • Typ: discord