Artikel direkt in Webflow veröffentlichen.
Citapult legt jeden Artikel als veröffentlichten Eintrag in deiner Blog-Collection an, lädt die Bilder in die Assets der Website und aktualisiert denselben Eintrag, wenn du den Artikel später änderst.
Aktualisiert am
Was du brauchst
- Eine Webflow-Website mit einer CMS-Collection für die Artikel, die ein Rich-Text-Feld hat.
- Keine Pflichtfelder in dieser Collection außer denen, die Citapult füllt. Die Tabelle unten zeigt, welche das sind.
- Zugriff auf die Site settings der Website, um einen API-Token anzulegen.
Einrichten
1. API-Token anlegen
Öffne in Webflow die Site settings der Website, dann Apps & integrations → API access, und erzeug einen Token. Er braucht Lese- und Schreibrechte für CMS und Assets und Leserechte für Sites. Ein Token gehört zu genau einer Website.
2. Integration hinzufügen
Öffne in Citapult Einstellungen → Integrationen, wähl unter „Art“ Webflow und füg den Token unter „API-Token“ ein. Bei „Collection“ trägst du den Namen der Collection ein, etwa „Blog Posts“. Leer lassen kannst du das Feld, wenn nur eine Collection ein Rich-Text-Feld hat oder nur eine nach Blog, Posts oder Artikeln heißt. Bei „Hinzufügen“ prüft Citapult den Token und ordnet die Felder zu. Die Collection bleibt danach fest.
3. SEO-Felder einsetzen
Citapult füllt Felder wie „Meta Title“ und „Summary“. Als SEO-Titel und Meta-Beschreibung nutzt Webflow sie aber erst, wenn du sie einsetzt: Öffne im Designer die Einstellungen der Collection-Seite und füg die Felder unter SEO settings ein. Das machst du einmal pro Collection.
4. Artikel veröffentlichen
Öffne einen fertigen Artikel und klick auf „Veröffentlichen“. Der Eintrag ist sofort live, ohne dass du die ganze Website neu veröffentlichst. Darunter siehst du, ob Webflow ihn angenommen hat.
5. Optional: automatisch veröffentlichen
Schalte bei den Integrationen „Automatisch veröffentlichen“ ein. Dann gehen Artikel im Status „Zu prüfen“ an ihrem geplanten Tag ohne Klick an alle Integrationen. Die Uhrzeit stellst du im Kalender unter „Zeitplan“ ein.
Welche Felder Citapult füllt
Citapult erkennt die Felder an Typ und Name. Passen mehrere Bildfelder oder mehrere Textfelder, füllt es alle davon. JSON-LD geht nicht mit.
| Citapult | Feld in Webflow |
|---|---|
| Titel | Name |
| Slug | Slug |
| Artikeltext | Das Rich-Text-Feld, bevorzugt eins mit Body oder Inhalt im Slug oder Namen, dann Content oder Text |
| Titelbild | Bildfelder, außer solchen wie Author, Avatar, Portrait oder Logo |
| Meta-Beschreibung | Textfelder wie Summary, Excerpt, Description, Teaser, Intro oder Zusammenfassung |
| Meta-Titel | Textfelder wie Meta Title oder SEO Title |
| Bilder im Text | Assets der Website. Bilder, die du selbst von einer anderen Adresse eingefügt hast, bleiben dort verlinkt. |
Wenn du einen Artikel änderst
Bearbeitest du einen veröffentlichten Artikel, steht er wieder auf „Zu prüfen“. Mit „Aktualisieren“ geht die neue Fassung an denselben Eintrag.
- Ein Live-Eintrag wird live aktualisiert. Hast du ihn in Webflow zum Entwurf gemacht oder archiviert, bleibt er so.
- Hast du ihn gelöscht, legt Citapult ihn neu an.
- Ein Beitragsbild, eine Meta-Beschreibung oder einen Meta-Titel, die du nur in Webflow gesetzt hast, bleiben erhalten. Entfernst du in Citapult etwas, das Citapult vorher gesendet hat, leert „Aktualisieren“ es auch in Webflow.
Was du über Webflow wissen solltest
- Citapult schreibt in die Hauptsprache der Website. Nutzt du Webflow Localization, landen auch Artikel in anderen Sprachen dort.
- YouTube-Videos werden zu Webflows eigenem Video-Block.
- Codeblöcke leert Webflow im Rich-Text-Feld. Citapult schickt sie deshalb als Absatz mit Code, mit Zeilenumbrüchen.
- Bilder über 4 MB nimmt Webflow nicht an.
- Änderst du in Webflow Felder der Collection, klick bei der Integration auf „Testen“. Das ordnet die Felder neu zu.
Integration entfernen
Die Einträge bleiben in Webflow. Fügst du die Integration später neu hinzu, erkennt Citapult sie nicht wieder: Ein erneuter Versand scheitert dann am schon vergebenen Slug, bis du die alten Einträge in Webflow löschst oder ihren Slug änderst.
Fehler und Fragen
„Die Prüfung bei Webflow ist fehlgeschlagen (HTTP 401 …)“ oder HTTP 403
HTTP 403Webflow hat den Token abgelehnt, oder ihm fehlen Rechte. Leg einen neuen an, mit Lese- und Schreibrechten für CMS und Assets und Leserechten für Sites.
„Gib an, in welche Collection die Artikel sollen: …“
Mehrere Collections haben ein Rich-Text-Feld, zum Beispiel Posts und Autoren. Trag einen der genannten Namen bei „Collection“ ein.
„Webflow hat keine Collection ‚…‘ mit einem Rich-Text-Feld.“
Keine Collection mit diesem Namen oder Slug hat ein Rich-Text-Feld. Trag den Namen genau wie in Webflow ein, etwa „Blog Posts“, oder lass das Feld leer.
„… hat Pflichtfelder, die Citapult nicht füllen kann: …“
Die genannten Felder sind in Webflow Pflicht, aber Citapult hat nichts dafür, etwa eine Kategorie oder einen Autor als Referenz. Mach sie in den Einstellungen der Collection optional und klick dann auf „Hinzufügen“ oder „Testen“.
„Nimm den API-Token einer einzelnen Website …“
Der Token reicht an mehrere Websites oder an gar keine, zum Beispiel weil er für einen ganzen Workspace gilt. Leg ihn in den Site settings der einen Website an.
„Der Token gehört zur Website …“
Beim Bearbeiten hast du den Token einer anderen Website eingefügt. Eine Integration bleibt bei ihrer Website, für eine andere füg eine neue Integration hinzu.
Ein Fehler mit HTTP 400 beim Veröffentlichen
HTTP 400 beim VeröffentlichenMeist hat sich in Webflow ein Feld geändert, es wurde umbenannt, gelöscht oder zur Pflicht gemacht. Klick bei der Integration auf „Testen“, dann ordnet Citapult die Felder neu zu, und veröffentliche noch einmal.
„In Webflow gibt es schon einen Eintrag mit dem Slug …“
In der Collection gibt es schon einen Eintrag mit diesem Slug, den Citapult nicht angelegt hat. Lösch ihn oder ändere dort seinen Slug. Solange keine Integration den Artikel hat oder gerade anlegt, kannst du stattdessen auch seinen Slug in Citapult ändern.
Google zeigt nicht den Meta-Titel aus Citapult
Webflow nimmt als SEO-Titel, was in den SEO-Einstellungen der Collection-Seite steht. Setz dort das Feld „Meta Title“ und die Zusammenfassung ein, wie in Schritt 3.