Einen Bot erstellen
Schritt 1. Erstelle eine Anwendung (folge dem Link).
Schritt 2. Füge einen Bot hinzu (klicke auf die Schaltfläche "Bot hinzufügen").
Schritt 2.1. Wähle im Abschnitt Installation die Option Installationslink → Keiner.
Schritt 2.2. Deaktiviere im Abschnitt Bot die Option Öffentlicher Bot und aktiviere dann die folgenden Intents:
- Message Content Intent
- Server Members Intent
Du kannst auch Presence Intent für die zukünftige Verwendung aktivieren.
Schritt 3. Hole dir den Token (Token zurücksetzen).
Schritt 4. Füge den Bot zum Server hinzu:
- Gehe zu OAuth2 → URL-Generator.
- Wähle unter Bereiche die Option bot.
- Wähle unter Bot-Berechtigungen die Optionen Nachrichten senden, Nachrichtenverlauf lesen und alle anderen erforderlichen Berechtigungen aus.
Öffne dann den generierten Link, wähle den Server aus, zu dem du den Bot hinzufügen möchtest, und bestätige die Autorisierung.
Um den vollständigen Webhook von Discord zu erhalten, weise der Variable save_webhook einfach einen beliebigen Wert zu.
Wenn die Variable gesetzt ist, wird der Webhook in discord_webhook gespeichert.
Den Discord-Bot in MaviBot verbinden
Gehe nun in deinem Projekt in MaviBot zum Abschnitt „Messengers“:
Füge dann den von Discord kopierten Token ein.
Klicke auf die Schaltfläche Fertig.
Rechnerfunktionen
Auf eine Nachricht antworten
discord_reply_to_message(message_id, text) - Diese Funktion wird verwendet, um auf eine Nachricht zu antworten.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der Nachricht, auf die du antworten möchtest. |
| ! text | Der Text der Antwortnachricht. |
Eine Nachricht löschen
discord_delete_message(message_id) - Diese Funktion wird verwendet, um eine Nachricht zu löschen.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der zu löschenden Nachricht. |
Eine Nachricht bearbeiten
discord_edit_message(message_id, text) - Diese Funktion wird verwendet, um eine Nachricht zu bearbeiten.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der zu bearbeitenden Nachricht. |
| ! text | Der neue Text der Nachricht. |
Eine Nachricht anpinnen
discord_pin_message(message_id) - Diese Funktion wird verwendet, um eine Nachricht anzupinnen.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der anzupinnenden Nachricht. |
Eine Nachricht lösen
discord_unpin_message(message_id) - Diese Funktion wird verwendet, um eine Nachricht zu lösen.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der zu lösenden Nachricht. |
Eine Reaktion an eine Nachricht senden
discord_send_reaction(message_id, reaction) - Diese Funktion wird verwendet, um eine Reaktion an eine Nachricht zu senden.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der Nachricht, an die eine Reaktion gesendet werden soll. |
| ! reaction | Die zu sendende Reaktion. Du kannst ein einzelnes Emoji (z. B. ❤️) oder die ID eines benutzerdefinierten Emojis auf dem Server angeben. Informationen zum Abrufen der ID eines benutzerdefinierten Emojis findest du unten. |
Eine Reaktion von einer Nachricht in einem Kanal entfernen
discord_delete_reaction(message_id, reaction, user_id) - Diese Funktion wird verwendet, um eine Reaktion von einer Nachricht in einem Kanal zu entfernen.
| Parameter | Beschreibung |
|---|---|
| ! message_id | Die ID der Nachricht, von der die Reaktion entfernt werden soll. |
| ! reaction | Die zu entfernende Reaktion. Du kannst ein einzelnes Emoji (z. B. ❤️) oder die ID eines benutzerdefinierten Emojis auf dem Server angeben. Informationen zum Abrufen der ID eines benutzerdefinierten Emojis findest du unten. |
| user_id | Die ID des Benutzers, dessen Reaktion du entfernen möchtest. Dieser Parameter ist optional, wenn du die Reaktion vom aktuellen Bot entfernen möchtest. |
Callbacks
Wenn ein Benutzer eine Reaktion sendet, wird ein Callback im Chat im folgenden Format empfangen:
new_like ❤️ uid413984787162726410
Wobei uid413984787162726410 die ID des Benutzers ist, der die Reaktion gesendet hat.
So erhältst du die ID eines benutzerdefinierten Emojis
Wenn du eine benutzerdefinierte Reaktion an eine Nachricht in einem Discord-Kanal sendest, wird ein Callback im folgenden Format empfangen:
new_like beer:1479419477396291696 uid413984787162726410
Wobei beer:1479419477396291696 die ID der Reaktion ist. Du kannst sie zur Verwendung in reaktionsbezogenen Funktionen kopieren.
So erhältst du die Nachrichten-ID
Du kannst die Nachrichten-ID des Clients aus dem Webhook abrufen, wenn save_webhook aktiviert ist. Beispiel:
data = discord_webhook["data"]
msg_id = data["id"]
result = discord_reply_to_message(msg_id, "Dies ist eine Antwort auf eine Nachricht")