Confluence-Inhalte in ein kundenfacing Help Center umzuziehen ist ein häufiges Projekt für DACH-SaaS-Teams, die Confluence bisher als interne Wissensdrehscheibe genutzt haben und jetzt einen externen Help-Center-Layer für Kunden brauchen. Zendesk Guide ist eine naheliegende Ziel-Plattform, weil Procurement schon mit Zendesk arbeitet oder weil das Sales-Team das Ticketing dort hat.
Dieser Artikel deckt den vollständigen Migrationspfad von Confluence zu Zendesk Guide: Export, Format-Konvertierung, Anhänge, Permissions, URL-Strategie mit 301-Redirects (die SEO-Falle), Cutover-Plan. Plus den Punkt, den die meisten Migrationen überspringen: was du nach der Migration anders machen musst, damit Zendesk Guide nicht genauso schnell verfällt wie Confluence es tat.
Warum Teams von Confluence zu Zendesk Guide wechseln
Confluence ist als interne Plattform gebaut, nicht für externe Kunden. Public Spaces existieren seit Jahren, aber das Such- und Lese-Erlebnis bleibt hinter dedizierten Help-Center-Tools zurück. Theming ist begrenzt, SEO-Out-of-the-Box ist mittelmässig, Artikel-Permissions auf Item-Ebene fehlen in vielen Plänen. Wer Confluence als kundenfacing Help Center betreibt, baut technische Schulden auf, die spätestens beim ersten SEO-Audit sichtbar werden.
Zendesk Guide hat den gegenteiligen Profil. Es ist von Anfang an als Customer-Help-Center konzipiert. Search, Branding, Ticket-Deflection sind eingebaut. Der Trade-Off: Zendesk Guide ist an Zendesk Suite gebunden, die Lizenzkosten sind pro Agent, und die Doku-Pflege bleibt manuell. Zendesk Guide löst das Lese-Erlebnis, nicht das Pflegeproblem.
Vor dem Export: Audit der Confluence-Inhalte
Erste Phase, oft übersprungen: ein Audit der bestehenden Confluence-Spaces. Welche Spaces enthalten Inhalte, die wirklich nach extern gehören. Welche sind interne Sales-Playbooks, Engineering-Specs oder Onboarding-Materialien, die nicht migriert werden sollten. Welche Artikel sind veraltet, weil sich das Produkt seit dem letzten Update geändert hat.
Faustregel aus mehreren DACH-Migrationen: zwischen 40 und 70 Prozent der Confluence-Inhalte sind nicht migrationswürdig. Sie sind intern-only, redundant oder schlicht falsch. Ein Audit vor der Migration spart drei bis sechs Wochen Bereinigungsarbeit auf der neuen Plattform.
Schritt 1: Export aus Confluence
Confluence Cloud bietet drei Export-Optionen. Erstens den nativen Space-Export als HTML oder XML, der über die Space-Settings ausgelöst wird. Der XML-Export enthält alle Inhalte, Anhänge und Metadaten in einem proprietären Format. Der HTML-Export liefert lesbare Dateien, aber ohne strukturierte Metadaten.
Zweitens die Confluence REST API, die einzelne Pages programmatisch abrufen kann. Endpoint: GET /wiki/api/v2/pages/{id} liefert Page-Inhalt in HTML oder Markdown. Für grössere Migrationen ist das der robustere Weg, weil er programmatisch scriptbar ist und einzelne Pages selektiv exportiert.
Drittens Drittanbieter-Migrationstools wie Help Desk Migration oder Relokia, die Confluence direkt mit Zendesk Guide verbinden und den Import automatisieren. Preisrahmen für 500-2000 Articles: typischerweise 500 bis 2500 USD je nach Komplexität. Lohnt sich, wenn das interne Team keine Migrations-Skripte schreiben will.
Schritt 2: Format-Konvertierung
Confluence Pages sind in Confluence Storage Format gespeichert, einer XML-basierten Variante. Zendesk Guide arbeitet mit HTML oder Markdown. Die Konvertierung ist nicht trivial, weil Confluence-spezifische Macros (Info-Boxen, Code-Blöcke, Toc-Macros, Expand-Macros) keine direkten Zendesk-Äquivalente haben.
Typische Konvertierungs-Punkte: Info-Macros werden zu Zendesk-Callouts oder bleiben als gestyltes HTML, Code-Blöcke übertragen sich meist sauber, Toc-Macros werden zu manuell gepflegten Sprungmarken, Tables migrieren in der Regel ohne Probleme, Embeds wie Confluence-Diagramme müssen oft neu erzeugt werden, weil die Quell-Tools (Gliffy, Draw.io) nicht direkt eingebettet werden können.
Schritt 3: Anhänge und Bilder
Confluence speichert Anhänge in eigenen URLs, die nach der Migration nicht mehr funktionieren. Bilder, PDFs, Screenshots müssen rehostet werden, entweder direkt in Zendesk Guide hochgeladen oder über einen CDN-Provider. Die Bild-URLs in den Artikeln müssen anschliessend ersetzt werden, automatisiert über ein Konvertierungs-Skript.
Praktischer Stolperstein: Confluence-Anhänge laufen oft über CDN-URLs mit zeitlich begrenzten Tokens. Wer den Export verzögert, bekommt 403-Errors beim Re-Download. Empfehlung: Export und Anhangs-Download in einem Pass durchführen.
Schritt 4: Kategorien und Permissions
Confluence organisiert Inhalte in Spaces, Parent-Pages und Page-Trees. Zendesk Guide arbeitet mit Categories, Sections und Articles. Die Hierarchie-Konvertierung ist nicht eins-zu-eins. Eine sinnvolle Faustregel: Confluence-Space wird zu Zendesk-Category, Top-Level-Parent-Pages werden zu Sections, Child-Pages werden zu Articles.
Permissions sind der zweite Stolperstein. Confluence hat granulare Permissions auf Space-, Page- und User-Ebene. Zendesk Guide hat Visibilität auf Article-Level (öffentlich, eingeloggt, internal). Permission-Pläne müssen oft neu gedacht werden, weil das Mapping nicht direkt funktioniert.
Schritt 5: 301-Redirects, die SEO-Falle
Der häufigste Fehler in Migrations-Projekten: 301-Redirects vergessen oder unvollständig setzen. Confluence-URLs haben das Format company.atlassian.net/wiki/spaces/SPACE/pages/12345/Page-Title. Zendesk Guide hat das Format support.company.com/hc/de/articles/360001234567-Page-Title. Komplett unterschiedlich, keine automatische URL-Übernahme.
Wer ohne Redirect-Mapping migriert, verliert Google-Rankings über Nacht. Externe Backlinks auf Confluence-URLs werden zu 404s. Bookmarks von Kunden funktionieren nicht mehr. Bezahlte Anzeigen, die auf Confluence-URLs gezeigt haben, schicken Klicks ins Leere.
Die Lösung: vollständige Redirect-Map als CSV mit alter URL und neuer URL, dann auf der Confluence-Domain (oder via Cloudflare-Worker bei DNS-Wechsel) als 301 implementieren. Bei mehreren tausend Pages ist das ein zwei- bis fünftägiges Projekt. Mehr zur Mechanik findest du in unserem Artikel zu DSGVO-konformer Wissensdatenbank und in der Übersicht zur Help-Center-Aktualität.
Schritt 6: Cutover-Plan
Der Cutover-Tag ist die Phase, in der Confluence als externes Help Center abgeschaltet wird und Zendesk Guide live geht. Praxis-Checkliste: DNS-Wechsel vorbereitet und getestet, 301-Redirects aktiv und getestet auf einer Stichprobe, Search-Index in Zendesk Guide aufgebaut, interne Suche getestet, Customer-Support-Team auf neue URLs und Such-Workflow trainiert, Status-Communication an Bestandskunden vorbereitet.
Wer am Freitagabend live geht, hat das Wochenende, um Probleme zu finden, bevor Kunden am Montag morgens auf 404s laufen. Wer am Montag morgens live geht, hat eine schlechte Woche.
Schritt 7: Nach der Migration
Hier wird es interessant. Die meisten Migrationen behandeln das Projekt als einmaligen Ablauf: Export, Import, Cutover, fertig. Tatsächlich ist das der Moment, in dem die eigentliche Frage entscheidet, ob Zendesk Guide langfristig funktioniert: wer pflegt die Artikel.
Zendesk Guide löst das Such- und Lese-Erlebnis, aber nicht das Pflegeproblem. Genau wie Confluence verfällt Zendesk Guide, wenn das Produkt sich ändert und niemand die Artikel anfasst. Ohne einen Prozess für Doku-Updates ist Zendesk Guide in zwei Quartalen genauso veraltet wie Confluence vorher war.
Die Optionen: erstens ein dediziertes Doku-Team, das die Artikel manuell pflegt, was bei 100+ Artikeln signifikante FTE bedeutet. Zweitens ein automatisierter Doku-Mechanismus, der bei jedem Release-Deploy die betroffenen Artikel flaggt. HappySupport ist auf diesen Use Case spezialisiert. Mehr in unserem Artikel zur selbst-aktualisierenden Wissensdatenbank und zur versteckten Kostenstelle veraltender Dokumentation.
Häufige Migrationsfehler
Erster Fehler: das Audit überspringen und alles migrieren. 40 bis 70 Prozent der Confluence-Inhalte gehören nicht ins externe Help Center.
Zweiter Fehler: 301-Redirects vergessen oder unvollständig setzen. SEO-Rankings sind über Nacht weg.
Dritter Fehler: Anhänge nicht rehosten. Confluence-CDN-URLs verfallen, Bilder werden zu Broken Links.
Vierter Fehler: keine Permission-Strategie für Zendesk Guide. Internal-only Artikel landen in der Public Help Center.
Fünfter Fehler: keine Doku-Pflege-Strategie nach dem Cutover. Zendesk Guide wird in zwei Quartalen genauso veraltet wie Confluence.
HappySupport im Kontext
HappySupport sitzt neben Zendesk Guide oder ersetzt es als externes Help Center. Der Unterschied: HappySupport-Artikel werden automatisch auf Veraltung geprüft, wenn das Produkt sich ändert. HappyAgent verbindet sich mit deinem GitHub-Repository und flaggt Artikel, deren zugrunde liegender Code sich seit dem letzten Release geändert hat. HappyRecorder zeichnet UI-Schritte als DOM- und CSS-Selektoren statt als Pixel-Screenshots auf, sodass Layout-Änderungen die Doku nicht direkt brechen.
Für DACH-SaaS-Teams, die wöchentlich shippen und kein dediziertes Doku-Team haben, ist HappySupport eine Alternative zur klassischen Migration. Mehr zur Architektur in selbst-aktualisierende Wissensdatenbank, im Vergleich HappySupport vs Confluence.
