Bot-Benutzer
Direktnachrichten, Bot-Status, Präsenz und externe Benutzer.
Bot-Präsenz setzen
Aktualisiert den Online-Status und die Aktivität des Bots.
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Status | Präsenzstatus | Ja | Online-Status, der angezeigt wird. Standard: Online. |
| Aktivitätstyp | Aktivitätstyp | Nein | Art der angezeigten Aktivität. |
| Aktivitätstext | Text | Nein | Text, der nach dem Aktivitätsverb angezeigt wird. Maximale Länge: 128 Zeichen. Wird angezeigt, wenn Aktivitätstyp Spielend, Streaming, Hört, Schaut, Benutzerdefinierter Status, Wettkampf ist. |
| Stream-URL | URL | Nein | Twitch-/YouTube-URL (nur bei Streaming-Aktivität). Wird angezeigt, wenn Aktivitätstyp ist. |
Bot-Benutzername festlegen
Ändert den globalen Benutzernamen des Bots.
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Neuer Benutzername | Text | Ja | Der neue globale Benutzername (2-32 Zeichen). Länge: 2 bis 32 Zeichen. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Benutzer | Benutzer | Der aktualisierte Bot-Benutzer. |
Bot-Avatar festlegen
Ändert oder entfernt den globalen Avatar des Bots.
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Avatar-URL | URL | Ja | URL des neuen Avatarbilds, oder leer zum Entfernen. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Benutzer | Benutzer | Der aktualisierte Bot-Benutzer. |
Bot-Banner festlegen
Ändert oder entfernt das Profilbanner des Bots.
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Banner-URL | URL | Ja | URL des neuen Bannerbilds, oder leer zum Entfernen. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Benutzer | Benutzer | Der aktualisierte Bot-Benutzer. |
Bot-Benutzer abrufen (frisch von Discord)
Fragt das eigene Benutzerkonto des Bots direkt bei Discord ab und liefert immer aktuelle Daten. Kostet eine API-Anfrage, wird auf das Rate-Limit angerechnet und kann fehlschlagen. Nutze sonst die Version aus dem Cache.
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Benutzer | Benutzer | Das frisch von Discord abgerufene Benutzerkonto des Bots. |
Anwendung abrufen
Ruft die eigene Discord-Anwendung des Bots ab, einschließlich aller öffentlichen Metadaten.
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Anwendung | Anwendung | Die Discord-Anwendung des Bots. |
Anwendung bearbeiten
Bearbeitet Einstellungen der Discord-Anwendung des Bots.
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Eigene Installations-URL | URL | Nein | Eigene URL, zu der Discord Benutzer zur Installation der App weiterleitet. |
| Beschreibung | Text | Nein | Neue Beschreibung der Anwendung. |
| Rollenverknüpfungs-Verifizierungs-URL | URL | Nein | URL, die Discord zur Verifizierung von Rollenverknüpfungen öffnet. |
| Installationsparameter | Anwendungs-Installationsparameter | Nein | Standardmäßige In-App-Autorisierungsparameter. |
| Flags | Liste von Anwendungs-Flag | Nein | Zu setzende Anwendungs-Flags (nur einige Flags sind setzbar). |
| Icon | URL | Nein | URL des neuen Icons. |
| Titelbild | URL | Nein | URL des neuen Titelbilds. |
| Interactions-Endpoint-URL | URL | Nein | URL, an die Discord Interaktionen anstelle des Gateways sendet. |
| Tags | Liste von Text | Nein | Bis zu 5 Tags, die die Anwendung beschreiben (je max. 20 Zeichen). Maximale Länge: 20 Zeichen. Höchstens 5 Einträge. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Anwendung | Anwendung | Die aktualisierte Anwendung. |
Anwendungs-Rollenverbindungs-Metadaten abrufen
Ruft die Rollenverbindungs-Metadaten-Einträge ab, die derzeit für die Anwendung registriert sind.
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Einträge | Liste von Rollenverbindungs-Metadaten | Die Rollenverbindungs-Metadaten-Einträge, die derzeit registriert sind. |
Anwendungs-Rollenverbindungs-Metadaten aktualisieren
Ersetzt die Rollenverbindungs-Metadaten-Einträge, die für die Anwendung registriert sind (max. 5).
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Einträge | Liste von Rollenverbindungs-Metadaten | Ja | Bis zu fünf Metadaten-Einträge, die für die Anwendung registriert werden. Höchstens 5 Einträge. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Einträge | Liste von Rollenverbindungs-Metadaten | Die Metadaten-Einträge wie nach der Aktualisierung gespeichert. |
Benutzer-Rollenverbindung aktualisieren
Aktualisiert die Rollenverbindung der Anwendung für einen bestimmten Benutzer (Plattformname, Benutzername und Metadatenwerte).
Eingaben
| Name | Typ | Pflicht | Details |
|---|---|---|---|
| Benutzer | Benutzer | Ja | Benutzer, dessen Rollenverbindung aktualisiert wird. |
| Plattformname | Text | Nein | Name der verbundenen Plattform, der in Discord angezeigt wird (max. 50 Zeichen). Maximale Länge: 50 Zeichen. |
| Plattform-Benutzername | Text | Nein | Name des Benutzers auf der verbundenen Plattform (max. 100 Zeichen). Maximale Länge: 100 Zeichen. |
| Metadaten | Nachschlagetabelle von Text zu Text | Nein | Zuordnung von Metadaten-Schlüsseln zu Textwerten, die an Discord gemeldet werden. |
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Erfolgreich | Ja/Nein | Ob die Aktualisierung erfolgreich angewendet wurde. |
Bot-Benutzer abrufen (aus dem Cache, ohne API-Anfrage)
Gibt das eigene Benutzerkonto des Bots aus dem lokalen Cache zurück. Sofort verfügbar und ohne API-Anfrage; Name, Avatar oder Banner können nach einer Änderung aber kurz veraltet sein.
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Benutzer | Benutzer | Das Benutzerkonto des Bots aus dem Cache. |
Bot als Server-Mitglied abrufen
Gibt den Bot als Mitglied des angegebenen Servers zurück.
Ausgaben
| Name | Typ | Details |
|---|---|---|
| Bot-Mitglied | Server-Mitglied | Die Server-Mitgliedschaft des Bots. |