Fjord

Fjord Dokumentation

Module

04

Einbettungen

Erstelle strukturierte Discord-Nachrichten im visuellen Editor, ohne JSON schreiben zu müssen.

Enthaltene Funktionen

  • Titel, Beschreibung, Felder und Medien
  • Live-Vorschau während der Bearbeitung
  • Speichern und erneutes Bearbeiten

Was kannst du mit Einbettungen erstellen?

Mit Einbettungen gestaltest du Discord-Nachrichten im visuellen Editor und prüfst sie in der Live-Vorschau. Du kannst Text, Felder, Bilder und Farben kombinieren, Entwürfe speichern oder Nachrichten in einem Kanal veröffentlichen und später aktualisieren.

Kompositionen verstehen

Beide Formate unterstützen Vorschau, Akzentfarben, Bilder, mehrere Einbettungen sowie das Aufklappen, Kopieren, Entfernen und Umsortieren der Einbettungen. V1 nutzt feste Discord-Felder, V2 frei angeordnete Blöcke. Die folgenden Abschnitte erklären die verfügbaren Eingaben und die Unterschiede.

Der Name einer Komposition dient ausschließlich der Verwaltung im Dashboard und wird nicht an Discord gesendet. Pro Server können bis zu 50 Kompositionen mit Namen von jeweils höchstens 50 Zeichen gespeichert werden.

ZustandVerhalten
EntwurfOhne Zielkanal wird die Komposition gespeichert, aber nicht in Discord veröffentlicht.
Verwaltete VeröffentlichungMit Zielkanal erstellt das Speichern eine dauerhaft mit der Komposition verknüpfte Discord-Nachricht. Weitere Änderungen aktualisieren genau diese Nachricht.
Einmalig sendenSendet die aktuelle Nachricht, ohne die Komposition zu speichern oder eine spätere Verknüpfung anzulegen. Diese Möglichkeit besteht nur vor dem ersten Speichern.

Komponente V1 / V2

Neue Kompositionen beginnen mit V2.

Wähle V1 oder V2 vor dem ersten Speichern. Danach ist die Version unveränderlich, auch bei einem Entwurf oder nach dem Entfernen der Veröffentlichung. Für ein anderes Format erstelle eine neue Komposition. Duplizieren erhält die Version. Gespeicherte V1-Nachrichten werden weder automatisch umgewandelt noch gelöscht.

V1

V1 verwendet klassische Discord-Einbettungen mit einer Akzentfarbe und fest angeordneten Bereichen. Bis zu zehn Einbettungen sind möglich. Die Zahlen in der Tabelle sind maximale Zeichenanzahlen. Autor, Titel, Beschreibung, Footer und alle Feldnamen und Feldwerte dürfen zusammen über sämtliche Einbettungen höchstens 6.000 Zeichen enthalten. Der normale Nachrichtentext zählt separat. Je V1-Einbettung sind höchstens 25 Felder möglich.

EingabeZeichenlimitStatus
Autor256Optional
Autor URL512Optional
Titel256Optional
Titellink (optional)512Optional
Beschreibung4096Optional
Footertext2048Optional
Feldname256Pflicht nach Hinzufügen
Feldwert1024Pflicht nach Hinzufügen

Alle Gestaltungsbereiche sind optional. Fügst du ein Feld hinzu, sind sowohl Feldname als auch Feldwert erforderlich. Entferne unbenutzte Felder. „Nebeneinander“ erlaubt Inline-Felder, deren endgültige Anordnung von Discord und der Bildschirmbreite abhängt. Autorenlink und Autorensymbol benötigen einen Autorennamen, Titellink einen Titel und Footersymbol einen Footertext. Die optionalen Links sind vollständige HTTP(S)-Adressen. Der Zeitstempel zeigt den Versandzeitpunkt.

Rollen- und Kanalauswahl gibt es im normalen Nachrichtentext, in der V1-Beschreibung und im Feldwert. In Autor, Titel, Footer und Feldname stehen diese Erwähnungsauswahlen nicht zur Verfügung. Server-Emojis sind in diesen Textbereichen möglich. Autoren-URL und Titellink sind reine URL-Eingaben ohne Rollen, Kanäle oder Emojis. Erwähnungen in klassischen Einbettungen lösen keine Benachrichtigung aus.

V2 fasst bis zu fünf Link-Buttons in einer Aktionszeile zusammen. Statt der V1-Grenze von fünf Zeilen gilt in V2 das gesamte Komponentenbudget.

Link-Buttons öffnen Webseiten und vergeben keine Rollen. Jeder angelegte Button braucht eine Beschriftung mit höchstens 80 Zeichen und eine vollständige HTTP(S)-URL mit höchstens 512 Zeichen. Emoji ist optional. Buttons lassen sich umordnen und entfernen. V1 zeigt sie unter den Einbettungen mit maximal fünf Buttons pro Aktionszeile und fünf Zeilen insgesamt, also höchstens 25 Buttons. V2 zeigt sie im zugehörigen Container und zählt sie einschließlich Aktionszeilen zum 40-Komponenten-Budget.

Komposition erstellen

Der interne Name ist Pflicht, auch wenn du nur einen Entwurf speicherst. Im Editor sind höchstens 50 Zeichen möglich. Eine neue Komposition erhält einen vorgeschlagenen Namen, den du ändern kannst. Der Name erscheint nur im Dashboard. Für eine Veröffentlichung brauchst du einen erreichbaren Zielkanal und sichtbaren Text, eine Einbettung oder einen vollständigen Link-Button. Ein Titel ist keine Voraussetzung für eine Beschreibung oder ein Bild. Ein leerer Entwurf benötigt noch keinen Nachrichteninhalt.

Benötigte Discord-Rechte

Kanal ansehen Nachrichten senden Links einbetten Dateien anhängen Erwähne @everyone, @here und alle Rollen

In V1 können Erwähnungen im normalen Nachrichtentext benachrichtigen, in klassischen Einbettungen nicht. In V2 können auch Textblöcke Erwähnungen auslösen. Für @everyone, @here und Rollen, die nicht allgemein erwähnbar sind, benötigt Fjord die entsprechende Discord-Berechtigung. Prüfe Erwähnungen vor dem Veröffentlichen.

Kanal ansehen und Nachrichten senden werden für jede Veröffentlichung benötigt. Links einbetten wird für klassische Einbettungen und deren Bilder benötigt. Dateien anhängen ist beim einmaligen Senden lokaler Bilddateien erforderlich. Ein Entwurf veröffentlicht noch keine Discord-Nachricht.

  1. Öffne im Dashboard Einbettungen.
  2. Wähle Neue Komposition und vergib einen internen Namen.
  3. Füge bei Bedarf normalen Nachrichteninhalt hinzu.
  4. Gestalte die erste Einbettung und ergänze bei Bedarf weitere Einbettungen.
  5. Prüfe das Ergebnis in der Discord-Vorschau.
  6. Wähle einen Zielkanal für die Veröffentlichung oder lasse den Kanal leer, um nur einen Entwurf zu speichern.
Name der KompositionPflicht

Dient ausschließlich der Verwaltung im Dashboard und darf höchstens 50 Zeichen enthalten.

NachrichteninhaltOptional

Normaler Nachrichteninhalt ist optional und auf 2.000 Zeichen begrenzt. Eine Veröffentlichung kann auch nur Text enthalten. Sie benötigt sichtbaren Inhalt. Prüfe außerdem die Format- und Komponentengrenzen.

EinbettungOptional

Einbettungen sind optional. Gestalte bis zu zehn Einbettungen. In V2 begrenzt zusätzlich das gemeinsame Komponentenbudget die mögliche Anzahl und Ausstattung.

ZielkanalOptional

Ohne Zielkanal wird ein Entwurf gespeichert. Für eine Veröffentlichung ist ein erreichbarer Zielkanal Pflicht.

Nachrichteninhalt

Der normale Nachrichteninhalt erscheint oberhalb der Einbettungen und darf bis zu 2.000 Zeichen enthalten. Über die Auswahl im Editor können Rollen, Kanäle und Server-Emojis eingesetzt werden.

In V1 können Erwähnungen im normalen Nachrichtentext benachrichtigen, in klassischen Einbettungen nicht. In V2 können auch Textblöcke Erwähnungen auslösen. Für @everyone, @here und Rollen, die nicht allgemein erwähnbar sind, benötigt Fjord die entsprechende Discord-Berechtigung. Prüfe Erwähnungen vor dem Veröffentlichen.

Einbettungen gestalten

Discord zeigt das Autorensymbol nur an, wenn zusätzlich ein Autorenname eingetragen ist. Trage oben einen Namen ein, damit das Icon in der Vorschau erscheint. Discord zeigt das Footersymbol nur an, wenn zusätzlich ein Footertext eingetragen ist. Trage oben einen Text ein, damit das Icon in der Vorschau erscheint.

V2

Ein Bildblock kann als Galerie bis zu zehn Bilder enthalten. Mit „+ Weiteres Bild“ ergänzt du weitere Bilder, die sich einzeln entfernen lassen. Für jedes Bild und Thumbnail sind eine Bildbeschreibung mit bis zu 80 Zeichen und die Spoiler-Einstellung optional. Ein Abschnitt unterstützt bis zu drei Texte mit jeweils bis zu 4000 Zeichen. Mit „+ Weiterer Text“ ergänzt du bis zu zwei weitere Texte. Unter Zubehör wählst du zwischen Thumbnail und Link-Button. Der Link-Button benötigt eine Beschriftung mit bis zu 80 Zeichen und eine vollständige HTTP(S)-URL mit bis zu 512 Zeichen. Emoji und Deaktivierung sind optional. Die zusätzlichen Abschnittstexte und der Zubehör-Button zählen zum Komponentenlimit. Die einzelnen Bilder einer Galerie zählen nicht als zusätzliche Komponenten.

In V2 kannst du Container und Bilder, einschließlich Thumbnails, als Spoiler kennzeichnen. Ihr Inhalt ist zunächst verborgen und wird per Klick angezeigt.

V2 bietet bis zu zehn Container mit eigener Akzentfarbe. Verwende Textblöcke oder Abschnitte mit einem optionalen Thumbnail rechts, jeweils mit bis zu 4000 Zeichen und Markdown. Trennlinien können eine sichtbare Linie oder nur Abstand anzeigen, jeweils klein oder groß. Bausteine lassen sich hinzufügen, kopieren, entfernen und mit den Pfeilen umordnen. Leere Text- und Bildbausteine erzeugen keinen sichtbaren Inhalt. Die V2-Textbereiche bieten Rollen-, Kanal- und Server-Emoji-Auswahl.

V2 hat keine klassischen Autorenfelder, Titellink-Eingaben, Inline-Felder, Footericons oder einen Zeitstempelschalter. Überschriften und Links setzt du mit Markdown in Textblöcken. Eine kleine Fußzeile lässt sich mit dem unten gezeigten Markdown schreiben, ein Zeitstempel mit dem Zeit-Token. V1 bietet umgekehrt keine frei angeordneten V2-Blöcke. In einer Nachricht werden die beiden Formate nicht gemischt.

-# ... · {time.full}

Container

Schnellfarben · 10

Textblock

Markdown · 4000

Abschnitt mit Thumbnail

Markdown · 4000 · Thumbnail ≤ 5 MB

Bild

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

Trennlinie

Trennlinie anzeigen · Klein / Groß

Für V2 gilt eine gemeinsame Grenze von 40 Komponenten für die gesamte Nachricht. Container, Textanzeigen, Abschnitte, Thumbnail, Bildgalerie, Trennlinie, Aktionszeile, Button und Auswahlmenü zählen jeweils mit. Menüoptionen zählen nicht einzeln. Auch automatisch ergänzte Trennlinien und Bedienelemente verbrauchen das Budget. Ein Container mit Text, Bild, Trennlinie und einem Button samt Aktionszeile benötigt beispielsweise sechs Komponenten. Die zehn Container können daher nicht beliebig voll ausgestattet werden.

Bilder verwenden

Die Bildgrenzen gelten pro Datei. In V1 dürfen Autorensymbol, Thumbnail und Footersymbol jeweils höchstens 5 MB groß sein. Die Grenze für das große Bild entspricht der unten angegebenen Grenze für Bildblöcke in V2. PNG, JPG/JPEG, WebP und GIF werden unterstützt. Datei auswählen ersetzt ein Bild, Entfernen leert den Bildplatz. Ohne zugehörigen Autoren- oder Footertext sind deren Icons nicht sichtbar.

Wähle PNG, JPG/JPEG, WebP oder GIF. Bilder werden beim Speichern hochgeladen. Thumbnails dürfen höchstens 5 MB groß sein, Bildblöcke höchstens 10 MB. Beim direkten Senden im Einbettungsmodul sind höchstens zehn lokale Bilder mit zusammen 20 MB möglich.

Thumbnail5 MB
Bild10 MB

Speichern und veröffentlichen

Fehlt die verwaltete Nachricht bereits in Discord, veröffentlicht erneutes Speichern sie neu. Eine duplizierte Komposition behält das Format, hat aber zunächst keinen Veröffentlichungskanal und ist vom Original unabhängig.

Als Entwurf speichern

Lasse die Kanalauswahl leer und speichere. Der Entwurf bleibt im Dashboard verfügbar, ohne eine Discord-Nachricht zu erstellen.

Dauerhaft veröffentlichen

Wähle einen Kanal und speichere. Die erstellte Discord-Nachricht bleibt mit der Komposition verknüpft. Spätere Änderungen werden beim Speichern in derselben Nachricht aktualisiert.

Veröffentlichung verschieben

Wählst du für eine bereits veröffentlichte Komposition einen anderen Kanal, wird beim nächsten Speichern zuerst die neue Nachricht erstellt und anschließend die alte entfernt.

Veröffentlichung entfernen

Veröffentlichung entfernen löscht nur die verwaltete Discord-Nachricht. Die Komposition bleibt als gespeicherter Entwurf erhalten.

Komposition löschen

Komposition löschen entfernt den gespeicherten Eintrag und seine gespeicherten Bilder. Eine bereits gesendete Discord-Nachricht wird dabei nicht gelöscht und kann Bildverweise verlieren. Wenn auch die verwaltete Nachricht verschwinden soll, entferne zuerst ausdrücklich die Veröffentlichung. Einmalig gesendete Nachrichten werden nicht nachträglich verwaltet.

Verwalten und duplizieren

Gespeicherte Kompositionen können geöffnet, umbenannt, dupliziert und gelöscht werden. Innerhalb einer Komposition lassen sich bis zu zehn Einbettungen anlegen, neu anordnen und duplizieren. Eine Duplizierung wird verhindert, wenn dadurch die Anzahl- oder Textgrenzen von Discord überschritten würden.

Du kannst innerhalb des Moduls zwischen Kompositionen und der Übersicht wechseln. Ungespeicherte Änderungen bleiben erhalten. Bevor du das Modul verlässt, musst du alle offenen Änderungen speichern oder verwerfen. Die gemeinsame Speicherleiste bleibt auch in der Übersicht sichtbar. Speichern übernimmt alle offenen Kompositionsänderungen. Abbrechen verwirft sie. Das gilt auch für Änderungen in gerade nicht geöffneten Kompositionen.

Fehler beheben

BeobachtungPrüfung
Die Nachricht kann nicht veröffentlicht werden.Ist ein erreichbarer Textkanal gewählt und darf Fjord dort Nachrichten und Einbettungen senden?
Ein Bild wird abgelehnt.Wähle PNG, JPG/JPEG, WebP oder GIF. Bilder werden beim Speichern hochgeladen. Thumbnails dürfen höchstens 5 MB groß sein, Bildblöcke höchstens 10 MB. Beim direkten Senden im Einbettungsmodul sind höchstens zehn lokale Bilder mit zusammen 20 MB möglich.
„Einmalig senden“ ist nicht verfügbar.Die Funktion ist nur vor dem ersten Speichern verfügbar und auf zehn lokale Anhänge begrenzt.
Eine Rolle wird nicht erwähnt.In V1 können Erwähnungen im normalen Nachrichtentext benachrichtigen, in klassischen Einbettungen nicht. In V2 können auch Textblöcke Erwähnungen auslösen. Für @everyone, @here und Rollen, die nicht allgemein erwähnbar sind, benötigt Fjord die entsprechende Discord-Berechtigung. Prüfe Erwähnungen vor dem Veröffentlichen.
Der gespeicherte Kanal ist nicht mehr verfügbar.Wähle einen bestehenden Kanal, in dem Fjord veröffentlichen darf, und speichere erneut.

Platzhalter für Kompositionen

Die folgenden Platzhalter kannst du im normalen Nachrichteninhalt beider Versionen und in den klassischen V1-Textfeldern einsetzen. Sie werden beim Senden oder Aktualisieren ersetzt, nicht laufend aktualisiert. In V2-Blöcken werden diese Server-, Kanal- und Bot-Platzhalter derzeit nicht ersetzt. Dort funktioniert der oben beschriebene Zeit-Token. Mitgliedsbezogene Platzhalter und dynamische Avatarbilder gehören zum Willkommensmodul.

{member.guild.member_count}Mitgliederzahl
{guild.owner.mention}Serverinhaber-Erwähnung
{member.guild.name}Servername
{guild.owner.id}Serverinhaber-ID
{channel.mention}Zielkanal-Erwähnung
{time.relative}Relative Zeit
{channel.id}Zielkanal-ID
{bot.mention}Bot-Erwähnung
{time.full}Datum & Uhrzeit
{guild.id}Server ID
{bot.name}Botname
{bot.id}Bot-ID

Voraussetzungen und Grenzen

Eine gültige Gestaltung benötigt nicht alle optionalen Bereiche. Reine Farbe oder leere Bausteine ersetzen keinen sichtbaren Inhalt für eine Veröffentlichung. Die Vorschau sendet keine Nachricht und ersetzt keinen Test im Zielkanal. Beide Editoren bieten keine Abstimmungen, Sticker, Formulare oder frei programmierbaren Aktionen. Die Daten und Bearbeitungsmöglichkeiten hängen außerdem von den freigegebenen Dashboard-Rechten ab.

Vorschau, Spoiler und Bilddateien

In der V2-Vorschau behält ein einzelnes Galeriebild sein Seitenverhältnis. Mehrere Bilder erscheinen in einem Raster mit gleich großen Ausschnitten im Format 16:9. Zwei oder vier Bilder stehen in zwei Spalten, drei sowie fünf bis zehn Bilder in drei Spalten. Ein Thumbnail steht rechts neben dem Abschnittstext. Die Bildbeschreibung dient als Alternativtext und erscheint nicht als zusätzliche Bildunterschrift.

Die Bild- und Container-Spoilerschalter gehören zum V2-Editor. Einzelne Galeriebilder und Thumbnails lassen sich unabhängig verdecken. Ein Container-Spoiler verdeckt den Inhalt, während der äußere Rahmen sichtbar bleibt. Ein Klick deckt den Inhalt in der Vorschau auf, ohne die gespeicherte Spoilereinstellung zu ändern. Auch Mitglieder können Spoiler in Discord per Klick aufdecken.

Für Nachrichtenbilder werden PNG, JPG/JPEG, WebP und GIF akzeptiert. Dateityp und Bildinhalt müssen zusammenpassen. Eine geänderte Dateiendung macht aus einer HTML- oder SVG-Datei kein unterstütztes Bild. Die Dateigrößen aus den Bildtabellen gelten weiterhin pro Datei. Wird ein lokales Bild abgelehnt oder kann es nicht mehr gelesen werden, wähle die Originaldatei erneut aus und speichere noch einmal.

Markdown-Textbereiche unterstützen Web- und E-Mail-Links. Die Vorschau öffnet HTTP(S)- und mailto-Links, aber keine Links auf lokale Dateien oder Blob-Adressen. Autorenlinks, Titellinks und Link-Buttons benötigen vollständige HTTP(S)-URLs. Die Vorschau veröffentlicht keine Nachricht. Prüfe das gespeicherte Ergebnis in Discord, dessen Darstellung je nach Client und Bildschirmbreite abweichen kann.