Discord-Webhooks
In Macro Deck enthaltenPoste umfangreiche Nachrichten mit Embeds und Erwähnungen über Webhooks in Discord-Kanäle, mit Live-Vorschau.
Der Dialog Discord-Webhook hinzufügen mit den Feldern Name und Webhook-URL
- Webhooks unter einem Namen speichern, einen pro Kanal
- Visueller Editor mit einer Vorschau, die wie Discord aussieht
- Bis zu 10 Embeds mit Feldern, Bildern, Autor und Fußzeile
- Erwähnungen benachrichtigen niemanden, außer du erlaubst es
- Vorlagenvariablen werden beim Ausführen der Aktion eingesetzt
Mit einem Discord-Webhook kann alles, was seine URL kennt, in einen Discord-Kanal posten. Die Integration Discord-Webhooks speichert Webhooks unter einem Namen und bietet dir eine Aktion, Discord-Webhook-Nachricht senden, mit einem visuellen Editor für die Nachricht. Sie braucht weder die Discord-App noch ein Discord-Konto auf dem Computer, auf dem Macro Deck läuft.
Was du senden kannst
Der Editor hat vier Tabs:
- Nachricht: der Nachrichtentext mit Discord-Markdown und Zeilenumbrüchen, dazu Schaltflächen, die eine Benutzer- oder Rollenerwähnung,
@everyoneoder@hereeinfügen. - Embeds: bis zu 10 Embeds, jeweils mit Titel und Titellink, Beschreibung, Farbe, Zeitstempel, Autor, Fußzeile, Bild, Vorschaubild und bis zu 25 Feldern, die nebeneinander angezeigt werden können.
- Profil: ein Benutzername und ein Avatar für diese Nachricht statt der des Webhooks.
- Erwähnungen: wer durch die Erwähnungen in der Nachricht benachrichtigt werden darf.
Standardmäßig benachrichtigt eine Nachricht niemanden, auch wenn sie jemanden, @everyone oder @here erwähnt. Die Erwähnung wird in Discord trotzdem angezeigt, sie pingt nur nicht. Alle Textfelder akzeptieren Vorlagenvariablen, die beim Ausführen der Aktion eingesetzt werden, so kann eine Nachricht die aktuelle Szene, den Song oder die Zuschauerzahl enthalten.
Die Vorschau unter dem Editor ändert sich beim Tippen und zeigt die Nachricht so, wie Discord sie darstellt. Sie sendet nie etwas an Discord. Bilder erscheinen als Platzhalter, und Variablen stehen so da, wie du sie geschrieben hast. Testnachricht senden sendet die Nachricht sofort an Discord, nachdem du mit Jetzt senden bestätigt hast, damit du prüfen kannst, wie sie wirklich aussieht.
Einige Beispiele:
- Eine Taste Live gehen, die ein Embed mit deinem Stream-Titel und Link in deinem Ankündigungskanal postet.
- Eine Taste, die den gerade laufenden Song in einem Musikkanal postet.
- Eine Automation, die eine Nachricht in einen Moderatorenkanal sendet, wenn in deinem Stream etwas passiert.
Gespeicherte Webhooks und eigene URLs
Füge pro Kanal eine Konfiguration hinzu und wähle den Webhook dann in jeder Aktion über seinen Namen. Ändert sich die URL, änderst du sie an einer Stelle. Für eine einmalige Nachricht kannst du Webhook auch auf Eigene URL stellen und die URL in die Aktion einfügen. Macro Deck speichert jede Webhook-URL verschlüsselt, zeigt sie nie wieder an und schreibt sie nie ins Protokoll.
Macro Deck prüft vor dem Senden die Limits von Discord, zum Beispiel 2000 Zeichen Nachrichtentext und 6000 Zeichen in allen Embeds zusammen, und listet beim Bearbeiten alle Probleme über der Vorschau auf. Begrenzt Discord, wie oft ein Webhook posten darf, wartet Macro Deck und versucht es noch einmal, wenn die Wartezeit 5 Sekunden oder weniger beträgt.
Das brauchst du
- Macro Deck 3 unter Windows, macOS oder Linux
- Eine Internetverbindung auf dem Computer, auf dem Macro Deck läuft
- Ein Discord-Kanal, in dem du Webhooks verwalten darfst, und seine Webhook-URL
So richtest du sie ein
Schritt 1: Webhook in Discord erstellen
Öffne in Discord die Einstellungen des Kanals, gehe zu Integrationen und dann zu Webhooks und erstelle einen Webhook oder wähle einen aus. Klicke auf Webhook-URL kopieren. Die URL beginnt mit
https://discord.com/api/webhooks/. Wer sie hat, kann in den Kanal posten, behandle sie also wie ein Passwort.Schritt 2: Discord-Webhooks in Macro Deck öffnen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf Discord-Webhooks. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Konfiguration hinzufügen. Der Schalter oben rechts öffnet denselben Dialog.
Schritt 3: Webhook speichern
Fülle den Dialog Discord-Webhook hinzufügen aus:
- Name: wird angezeigt, wenn du den Webhook in einer Aktion auswählst, zum Beispiel der Kanalname.
- Webhook-URL: die URL, die du in Discord kopiert hast.
Klicke auf Fortfahren. Füge für jeden weiteren Kanal eine Konfiguration hinzu.
Schritt 4: Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf die Taste, die du verwenden willst. Das Deck muss entsperrt sein: Zeigt die Schaltfläche oben rechts Sperren, ist es entsperrt. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen Discord-Webhooks und nimm Discord-Webhook-Nachricht senden.
Schritt 5: Nachricht schreiben
Wähle unter Webhook den gespeicherten Webhook. Schreibe den Nachrichtentext im Tab Nachricht und füge bei Bedarf im Tab Embeds Embeds hinzu. Prüfe die Vorschau und klicke dann auf Testnachricht senden und Jetzt senden, um die Nachricht in Discord zu sehen.
Schritt 6: Taste drücken
Drücke die Taste auf deinem Handy, Tablet oder im Web-Client. Die Nachricht erscheint im Discord-Kanal, mit eingesetzten Variablen. Falls nicht, zeigt die Aktion den Grund an, zum Beispiel dass Discord das Webhook-Token abgelehnt hat.
Aktionen1
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Discord-Webhook-Nachricht senden
- Sendet eine Nachricht mit optionalen Embeds über einen gespeicherten oder eigenen Discord-Webhook, bearbeitet mit Live-Vorschau.
Häufige Fragen
Wie erwähne ich einen Benutzer oder eine Rolle?
Für eine Erwähnung brauchst du die Discord-ID. Schalte in Discord in den erweiterten Einstellungen den Entwicklermodus ein, klicke dann mit der rechten Maustaste auf den Benutzer oder die Rolle und wähle ID kopieren. Lege im Tab Erwähnungen fest, ob niemand, alle Erwähnten oder nur die IDs, die du angibst, benachrichtigt werden.
Was ist der Unterschied zur Discord-Integration?
Die Discord-Integration hat eine ältere Aktion Webhook ausführen mit einem Embed und ohne Vorschau. Sie funktioniert weiterhin. Discord-Webhooks bietet zusätzlich mehrere Embeds, Kontrolle über Erwähnungen, ein Profil pro Nachricht und die Live-Vorschau.
Wo wird die Webhook-URL gespeichert?
Macro Deck speichert sie verschlüsselt auf dem Computer, auf dem Macro Deck läuft. Sie wird nie wieder angezeigt, nie ins Protokoll geschrieben und ist nie Teil der Vorschau. Um sie zu ändern, gib sie erneut ein. Akzeptiert werden nur Discord-Webhook-Adressen auf discord.com, discordapp.com, ptb.discord.com und canary.discord.com.
Warum wird eine Variable in meiner Testnachricht nicht eingesetzt?
Testnachricht senden sendet Variablen so, wie sie geschrieben sind. Eingesetzt werden sie erst, wenn die Aktion über eine Taste, eine Automation oder ein Skript läuft.
Warum schlägt die Aktion fehl?
Die Aktion zeigt den Grund an, zum Beispiel dass die Nachricht leer oder zu lang ist, dass der Webhook in Discord nicht mehr existiert, dass Discord das Webhook-Token abgelehnt hat oder dass Discord den Webhook drosselt. Wurde das Token abgelehnt, kopiere die Webhook-URL erneut und gib sie in der Konfiguration ein.
Kann ich die Nachricht in der Companion-App bearbeiten?
Die Companion-App und ältere Desktop-Apps zeigen die einfachen Einstellungen der Aktion, mit der Nachricht als Schlüssel und Werte wie content und embeds.0.title, und speichern keine Änderungen aus dem visuellen Editor. Bearbeite umfangreiche Nachrichten in der aktuellen Desktop-App.
