Wie Channels funktionieren

Ein Channel ist jedes Ziel außerhalb deiner WordPress-Website, an das Structura einen frisch veröffentlichten Beitrag pushen kann — LinkedIn, Slack, Discord, Telegram, IndexNow, eine E-Mail an dich und so weiter. Wenn eine Kampagne einen Beitrag veröffentlicht, spielt Structura ihn an jeden Channel aus, den du verbunden hast.

Stell dir deine WordPress-Website als Heimat des Artikels vor und Channels als die Orte, an denen er angekündigt wird.

Die drei beweglichen Teile

Ein Channel hat drei zusammenarbeitende Teile:

Deine WordPress-Website. Lässt das Plugin laufen. Wenn ein Beitrag veröffentlicht wird, sagt das Plugin der Structura-Cloud „ein Beitrag ist gerade live gegangen” — mit dem Titel, der URL, der Zusammenfassung und dem Bild.

Die Structura-Cloud. Empfängt dieses Ereignis und spielt es an jeden Channel aus, den du für diese Website verbunden hast. Die Cloud hält deine Channel-Zugangsdaten (OAuth-Tokens, Webhook-URLs, API-Schlüssel) verschlüsselt und pro Website gescopt.

Den Channel selbst. LinkedIn, Slack, Discord — das tatsächliche Ziel. Die Cloud ruft die API des Channels mit dem auf, was der Channel erwartet, und nutzt dabei die von dir autorisierten Zugangsdaten.

Warum die Cloud die Auslieferung übernimmt. Channel-APIs verlangen Geheimnisse, die wir sonst auf jeder WordPress-Website speichern müssten. Die Zentralisierung in der Cloud bedeutet (a) deine Tokens leben nicht auf deinem Server, (b) Token-Refresh passiert ohne deine Website anzufassen, und (c) wir können einen Channel-Bug beheben ohne ein Plugin-Update auszuspielen.

Was an einen Channel gesendet wird

Jeder Channel erhält dieselbe Kern-Payload:

Beitragstitel.
Beitrags-URL auf deiner WordPress-Website.
Zusammenfassung oder Auszug — typischerweise der erste Absatz oder das Auszugsfeld des Beitrags.
Beitragsbild-URL — falls der Beitrag eines hat.
Veröffentlichungs-Zeitstempel.

Jeder Channel formatiert diese Felder dann für seine eigene Oberfläche. LinkedIn macht daraus einen Link-Vorschau-Beitrag; Slack macht daraus eine Block-Kit-Karte; IndexNow sendet nur die URL; E-Mail sendet eine schlichte Benachrichtigung mit dem ersten Absatz inline. Siehe die jeweilige Channel-Seite für Details.

Der Channels Store

Alle verfügbaren Channels leben im Channels Store, erreichbar über das Hauptportal unter app.structurawp.com und gespiegelt in wp-admin. Du durchstöberst das Angebot, verbindest die gewünschten, und sie werden zu aktiven Zielen für jede Website auf deiner Lizenz.

Siehe Channels Store durchsuchen, um Channels zu finden, und Einen Channel verbinden für den allgemeinen Verbindungs-Flow.

Verbindungsarten

Channels verbinden sich auf eine von drei Arten, je nachdem, was der Zieldienst unterstützt:

OAuth. Du klickst auf Verbinden, wirst zur Anmeldeseite des Channels weitergeleitet und genehmigst den Zugriff. Wird genutzt für: LinkedIn. (Weitere OAuth-Channels sind geplant.)

Webhook-URL. Du fügst eine URL ein, an die Structura postet. Wird genutzt für: Slack, Discord.

Zugangsdaten / Schlüssel. Du gibst einen API-Schlüssel oder einen ähnlichen Identifier ein. Wird genutzt für: IndexNow (die Schlüsseldatei deiner Website), Telegram (Bot-Token + Chat-ID).

Keine Verbindung erforderlich. Eine kleine Anzahl „eigenständiger” Channels funktioniert ohne etwas zu verbinden. Wird genutzt für: E-Mail an den Inhaber (verwendet deine WordPress-Admin-E-Mail).

Welche Verbindungsart gilt, wird klar angezeigt, wenn du im Store auf Verbinden klickst — du siehst entweder einen OAuth-Verbinden-Knopf, ein Webhook-URL-Eingabefeld oder ein API-Schlüssel-Formular.

Was du pro Website kontrollierst

Verbindungen sind aktivierungs-gescopt — das heißt, sie sind an die spezifische Website-Aktivierung gebunden, nicht an deine Lizenz allgemein. Wenn du Structura auf zwei verschiedenen Websites aktivierst, verwaltest du deren Channel-Verbindungen unabhängig.

Damit kannst du z. B. LinkedIn auf deiner Firmen-Website verbunden haben und Discord auf deiner Nebenprojekt-Website, ohne Cross-Posting.

Channel-Lebenszyklus

Ein Channel auf deiner Website durchläuft folgende Zustände:

Nicht installiert. Im Store, zeigt Verbinden.
Installiert / verbunden. Auslieferungen erfolgen, wenn Beiträge veröffentlicht werden.
Benötigt Aufmerksamkeit. Eine Auslieferung ist fehlgeschlagen (falsche Zugangsdaten, widerrufene OAuth, Channel-Ausfall). Die Oberfläche zeigt einen Inline-Fehler.
Getrennt. Du hast ihn explizit entfernt. Auslieferungen stoppen.

Siehe Channel-Aktivität & Fehler, wie du den Zustand überwachst, und Trennen oder neu verbinden, wie du aus Zustand 2 oder 3 herauskommst.

Wann Auslieferungen erfolgen

Eine Auslieferung wird einmal pro Channel pro Beitragsveröffentlichung versucht, in dem Moment, in dem der Beitrag live geht. Im MVP gibt es keine Wiederholungs-Warteschlange für fehlgeschlagene Auslieferungen — wenn Slack ausfällt, während dein Beitrag veröffentlicht wird, schafft es dieser Beitrag nicht automatisch zu Slack.

Was du tun kannst:

Die Lauf-Detailansicht jeder Kampagne beobachten — der Schritt Channels listet eine Zeile pro verbundenem Channel mit dessen Auslieferungs-Ergebnis.
Die zugrundeliegenden Zugangsdaten korrigieren oder warten, bis der Channel-Ausfall vorbei ist.
Den verpassten Beitrag bei Bedarf manuell aus dem Channel selbst teilen.

Siehe Channel-Aktivität & Fehler.