Ein Channel zeigt „failed“
Wenn ein Channel auf der Channels-Seite „Benötigt Aufmerksamkeit” zeigt oder ein Channel-Versuch mit einer Fehlerstufe zurückkommt, gehe diese Seite durch, um die Ursache zu finden und zu beheben.
Die zugrundeliegende Fehlermeldung ist der schnellste Hinweis — beginne damit, sie zu lesen, und gleiche dann mit den Abschnitten unten ab.
Die Fehlermeldung finden
Ein Channel-Fehlschlag löst üblicherweise einen Verbindungs-Hinweis in deinem Glockensymbol aus — öffne ihn, um den zugrunde liegenden Fehler und eine Ein-Klick- Aktion Neu verbinden zu sehen. Wenn die Glocke nichts zu diesem Channel hat, öffne den jüngsten Lauf der Kampagne über das Dashboard und sieh dir den Schritt Channels in der Lauf-Detailansicht an; jedes Pro-Channel-Ergebnis trägt den Grund in seiner eigenen Zeile.
Wenn die Zeile zusätzlichen Kontext hat (eine erweiterte Ansicht zeigt einen Stack Trace oder eine rohe Anbieter-Antwort), ist das der nützlichste Hinweis — es ist, was die API des Channels uns zurückgegeben hat.
Fehler: OAuth / Autorisierung
Nachrichten wie: invalid_grant, Token expired,
Unauthorized, Access token revoked, 401.
Gilt für: LinkedIn (oder jeden zukünftigen OAuth-Channel).
Warum: du hast dein LinkedIn-Passwort geändert, Structura aus den autorisierten Apps von LinkedIn entfernt oder das Token ist natürlich abgelaufen.
Fix:
- Öffne Structura → Channels.
- Klicke auf die LinkedIn-Karte.
- Klicke auf Neu verbinden. Durchlaufe den OAuth-Flow.
Siehe LinkedIn und Trennen oder neu verbinden.
Fehler: Webhook-URL ungültig
Nachrichten wie: 404, Webhook not found,
invalid_token (Slack).
Gilt für: Slack, Discord.
Warum: der Webhook wurde in Slack/Discord gelöscht — entweder wurde der Channel archiviert, ein Admin hat die App widerrufen oder jemand hat den Webhook neu generiert.
Fix:
- Erstelle in Slack/Discord einen neuen Incoming Webhook auf dem Ziel-Channel. Siehe die Seite Slack oder Discord für die genauen Schritte.
- Kopiere die neue URL.
- Öffne in Structura das Installations-Panel des Channels und klicke auf Neu verbinden. Füge die neue URL ein.
Fehler: Rate-Limit
Nachrichten wie: 429, rate limit exceeded,
Too many requests.
Gilt für: jeden Channel, am häufigsten aber bei LinkedIn, wenn du in einem kurzen Zeitfenster viele Beiträge veröffentlichst.
Warum: die API des Channels drosselt uns wegen jüngsten Volumens.
Fix:
- Warte — die meisten Rate-Limits klären sich innerhalb von Minuten bis zu einer Stunde.
- Wenn es anhaltend ist, prüfe, ob du gerade eine ungewöhnliche Welle laufen hast (z. B. einen Backlog veröffentlichst). Verlangsame die Kadenz.
- Auslieferungen werden nicht automatisch wiederholt, also holen verpasste Beiträge während der Drosselung nicht von selbst auf; teile manuell, wenn sie wichtig sind.
Fehler: Payload zu groß
Nachrichten wie: Payload exceeds limit,
Image too large, 413.
Gilt für: Channels, die das Beitragsbild senden — Discord, Telegram, Slack (seltener).
Warum: das Beitragsbild des Beitrags überschreitet das Dateigrößen- oder Pixellimit des Channels.
Fix:
- Verwende kleinere Beitragsbilder. Die eingebauten Visuals-Einstellungen von Structura können auf ein kleineres Seitenverhältnis gesetzt werden, oder verwende JPEG/WebP (kleiner als PNG) unter Structura → Einstellungen → Visuals → Format Encoding.
- Wenn ein bereits veröffentlichter Beitrag aus diesem Grund nicht ausgeliefert wurde, ist der Text der Nachricht wahrscheinlich durchgegangen — prüfe den Channel.
Fehler: Telegram-spezifisch
Nachrichten:
chat not found— Chat-ID falsch oder Bot ist kein Mitglied dieses Chats/Channels. Bei Channels muss der Bot ein Administrator sein.Forbidden: bot can't initiate conversation with a user— bei privaten Chats musst du dem Bot zuerst eine Nachricht senden. Sende dem Bot in Telegram eine Nachricht und versuche es dann erneut.Unauthorized— Bot-Token falsch.
Fix: siehe Telegram, wie du Token und Chat-ID verifizierst und mit korrigierten Werten neu verbindest.
Fehler: IndexNow-spezifisch
Nachrichten:
Key file mismatch— die Datei<key>.txtim Root deiner Website passt nicht zum Schlüssel, unter dem wir einreichen. Lade entweder die richtige Datei erneut hoch oder generiere den Schlüssel im Installations-Panel neu und lade eine neue Datei hoch.Key file not reachable— wir konnten die Datei nicht per HTTP abrufen. Prüfe, dass sie im Web-Root liegt (nicht in/wp-content/), ohne Auth zugänglich ist und 200 zurückgibt.
Siehe IndexNow.
Fehler: E-Mail wurde nicht gesendet
Nachrichten: wp_mail failed, SMTP error.
Gilt für: E-Mail an den Inhaber.
Warum: der ausgehende Mail-Versand von WordPress ist auf dieser Website nicht korrekt konfiguriert.
Fix: siehe den Abschnitt „Stelle sicher, dass WordPress wirklich E-Mails senden kann” auf E-Mail an den Inhaber.
Fehler: alles andere
Manche Channel-Fehler sind vorübergehend — ein kurzer
Ausfall beim Channel, ein Netzwerkaussetzer. Wenn die
Fehlermeldung allgemein ist (500, Unknown error,
timeout) und vereinzelt:
- Warte eine Stunde.
- Beobachte, ob der nächste geplante Beitrag erfolgreich ausgeliefert wird.
- Wenn ja, war es ein vorübergehendes Problem — keine Aktion nötig, außer ggf. den verpassten Beitrag manuell zu teilen.
- Wenn Fehlschläge anhalten, behandle es wie ein Zugangsdaten-Problem und verbinde neu.
Wenn der Channel funktioniert, aber die Nachricht falsch aussieht
Wenn die Auslieferung laut Lauf-Detailansicht „erfolgreich” war, die Nachricht in Slack/Discord/LinkedIn aber komisch aussieht (abgeschnittener Titel, kaputtes Bild, keine Linkvorschau):
- Linkvorschauen auf LinkedIn kommen aus den Open-Graph-Tags
deines Beitrags. Wenn dein Theme oder SEO-Plugin sie
nicht ausgibt, rendert LinkedIn keine Vorschau. Prüfe mit
einem Tool wie
https://www.opengraph.xyz. - Slack-/Discord-Embeds können von spezifischen Beitragsinhalten beeinflusst werden. Wenn das Problem reproduzierbar ist, sende uns eine Beispiel-URL.
Falls du festsitzt
- Dem Channel-Namen.
- Dem Fehlertext aus dem Hinweis (oder dem Schritt Channels der Lauf-Detailansicht).
- Der ungefähren Zeit der fehlgeschlagenen Auslieferung.