Intercom Help Center Artikel mit der API exportieren: Ein Leitfaden für 2025

Sie haben also unzählige Stunden damit verbracht, eine fantastische Wissensdatenbank in Intercom aufzubauen und sie mit wirklich hilfreichen Artikeln zu füllen, die die Probleme Ihrer Kunden lösen. Jetzt müssen Sie diese Inhalte herausbekommen, und Sie haben wahrscheinlich bemerkt, dass es nirgendwo einen großen, glänzenden „Exportieren“-Button gibt. Wenn Sie sich die Haare raufen, weil Sie ihn nicht finden, sind Sie nicht allein.

Egal, ob Sie auf eine neue Plattform migrieren, eine lokale Sicherung für den Seelenfrieden erstellen oder eine tiefgehende Analyse Ihrer Inhalte durchführen möchten – der Datenexport sollte kein riesiges Projekt sein. Diese Anleitung führt Sie durch die technischen Schritte zum Exportieren von Intercom-Help-Center-Artikeln mit der API.

Aber seien wir ehrlich, der Weg über die API kann kompliziert werden und hat seine eigenen Tücken. Deshalb zeigen wir Ihnen auch eine viel einfachere, automatisierte Alternative, mit der Sie Ihr Wissen verbinden und verwalten können, ohne eine einzige Zeile Code zu schreiben.

Bevor Sie beginnen: Was Sie benötigen

Der Einstieg in die API-Methode erfordert ein wenig Vorbereitung. Es ist eine technische Aufgabe, daher wird die Vorbereitung dieser Dinge den gesamten Prozess erheblich erleichtern. Hier ist eine kurze Checkliste:

• Admin-Zugriff auf Ihren Intercom-Workspace: Diesen benötigen Sie auf jeden Fall, da Sie die richtigen Berechtigungen zum Erstellen von API-Anmeldeinformationen benötigen.

• Ein Entwickler-Zugriffstoken: Stellen Sie sich dies als ein sicheres Passwort vor, mit dem Ihr Skript oder Tool mit Intercom kommunizieren kann. Wir werden im ersten Schritt behandeln, wie Sie einen erstellen.

• Ein Tool zum Senden von API-Anfragen: Sie können ein Kommandozeilen-Tool wie cURL verwenden, wenn Sie sich in dieser Umgebung wohlfühlen, oder eine benutzerfreundlichere App wie Postman.

• Ein grundlegendes Verständnis von APIs: Es ist hilfreich, wenn Sie wissen, was Endpunkte, GET-Anfragen und JSON-Daten sind, da dies die Schritte leichter verständlich macht.

Eine Schritt-für-Schritt-Anleitung zum Exportieren von Artikeln mit der Intercom-API

Bereit, loszulegen? Hier ist der vollständige Prozess zum Exportieren Ihrer Artikel mit der REST-API von Intercom, aufgeteilt in vier Schritte.

Schritt 1: Holen Sie sich Ihren Intercom-Entwickler-Zugriffstoken

Zunächst benötigen Sie eine Möglichkeit, Intercom nachzuweisen, dass Sie die Berechtigung haben, auf die Daten Ihres Workspaces zuzugreifen. Hier kommt ein Zugriffstoken ins Spiel.

Einen zu bekommen ist ziemlich einfach. Gehen Sie einfach zum Developer Hub in Ihren Intercom-Einstellungen. Von dort aus können Sie eine neue App für den internen Gebrauch erstellen. Geben Sie ihr einen Namen, den Sie sich merken können (z. B. „Artikel-Exporter“), und Intercom generiert einen Zugriffstoken für Sie. Kopieren Sie diesen Token und bewahren Sie ihn an einem sicheren Ort auf; Sie benötigen ihn für jeden API-Aufruf.

Schritt 2: Alle Artikel auflisten, um ihre IDs zu erhalten

Hier ist eine kleine Eigenheit der Intercom-API: Sie können nicht einfach den gesamten Inhalt Ihrer Artikel auf einmal anfordern. Zuerst müssen Sie eine Liste all Ihrer Artikel anfordern, um deren eindeutige IDs zu erhalten. Das ist, als würden Sie einen Bibliothekskatalog bekommen, bevor Sie Bücher ausleihen können.

Dazu verwenden Sie den Endpunkt „List all articles“. Wenn Sie eine Anfrage an diesen Endpunkt mit Ihrem Zugriffstoken senden, sendet Intercom ein JSON-Objekt mit einer Liste Ihrer Artikel zurück, jeder mit seiner eigenen „id“.

Schritt 3: Den Inhalt jedes Artikels abrufen

Mit Ihrer Liste von Artikel-IDs können Sie nun beginnen, den eigentlichen Inhalt abzurufen. Dies erfordert für jeden Artikel eine separate Anfrage, eine nach der anderen.

Sie verwenden den Endpunkt „Retrieve an Article“ und stellen sicher, dass Sie die spezifische Artikel-„id“ in der Anfrage-URL angeben. Die Antwort auf jede Anfrage ist ein JSON-Objekt, das alles über den Artikel enthält: Titel, Autor, Status und natürlich den „body“, der den Inhalt im HTML-Format enthält.

Dies ist mit Abstand der repetitivste Teil des Prozesses. Wenn Sie 500 Artikel haben, werden Sie 500 einzelne API-Anfragen stellen.

Schritt 4: Formatieren und Speichern Ihrer exportierten Daten

Sobald Sie den Inhalt für jeden Artikel erhalten, liegt es an Ihnen, ihn zu speichern. Der Artikeltext wird als HTML zurückgegeben, also müssen Sie diese Daten in Dateien speichern. Sie könnten sie als .html-Dateien speichern oder, wenn Sie etwas anderes benötigen, ein Skript schreiben, um das HTML in ein anderes Format wie Markdown oder reinen Text umzuwandeln.

Um dies für ein ganzes Hilfe-Center zu tun, werden Sie mit ziemlicher Sicherheit ein kleines Skript schreiben wollen, das die vollständige Liste der IDs abruft (und die Paginierung handhabt), jede einzelne durchläuft, eine API-Anfrage stellt, um den Inhalt zu erhalten, den Titel und den Text extrahiert und alles in einer lokalen Datei speichert.

Und da haben Sie es. Sie haben Ihre Artikel exportiert. Wie Sie sehen, ist es jedoch nicht gerade ein einfacher Klick auf einen Button.

Häufige Herausforderungen beim Export von Artikeln mit der API

Obwohl die API-Methode die Aufgabe erledigt, ist sie bei weitem nicht perfekt. Viele Teams stoßen auf die gleichen Frustrationen, die diese Aufgabe zu einem echten Ressourcenfresser machen können.

• Es ist ein technischer und zeitaufwändiger Prozess. Wenn Sie kein Ingenieur sind, kann dieser ganze Prozess einschüchternd wirken. Er erfordert technisches Know-how, Zeit zum Schreiben und Debuggen von Skripten und laufende Wartung, wenn Sie ihn mehr als einmal durchführen müssen. Für nicht-technische Personen ist es so gut wie unmöglich, und für Entwickler ist es nur eine weitere Aufgabe, die sie von ihren Hauptprojekten abhält.

• Interne Artikel können nicht exportiert werden. Das ist ein großes Problem. Die Intercom-API erlaubt derzeit nicht den Export von rein internen Artikeln. All das wertvolle Wissen, das Ihr Team täglich nutzt, ist gefangen und hinterlässt Ihnen eine manuelle Kopier- und Einfügearbeit, die den ganzen Zweck eines automatisierten Exports zunichtemacht.

• Formatierung und Inhalt können seltsam werden. Das exportierte HTML ist nicht immer eine perfekte Kopie. Wie Intercom in seiner eigenen Dokumentation erwähnt, gehen alle von Ihnen vorgenommenen benutzerdefinierten Bildgrößenanpassungen verloren, und dynamische Elemente wie Callouts oder ausklappbare Abschnitte werden nicht vollständig unterstützt. Ihre wunderschön formatierten Artikel könnten am Ende etwas kaputt aussehen.

• Es ist eine einmalige Momentaufnahme. Der vielleicht größte Nachteil ist, dass Ihr Export in dem Moment veraltet ist, in dem Sie ihn abschließen. Alle neuen Artikel, Aktualisierungen oder Bearbeitungen, die in Intercom vorgenommen werden, sind nicht in Ihren exportierten Dateien enthalten. Um die Dinge auf dem neuesten Stand zu halten, müssen Sie den gesamten manuellen, technischen Prozess immer wieder von vorne beginnen.

Die bessere Alternative: Vereinheitlichen Sie Ihr Wissen

All diese Kopfschmerzen werfen eine interessante Frage auf: Was, wenn der Export die falsche Lösung für das Problem ist? Das eigentliche Ziel ist nicht nur, einen Ordner mit HTML-Dateien zu erhalten; es geht darum, dieses Wissen an anderer Stelle zu nutzen.

Was wäre, wenn Sie Ihre Artikel überhaupt nicht exportieren müssten? Was wäre, wenn Sie Ihre Intercom-Wissensdatenbank einfach sicher mit den anderen Tools verbinden könnten, die Sie verwenden, und alles live und automatisch synchron halten könnten?

Genau darum geht es bei eesel AI. Anstatt sich mit einem einmaligen Export herumzuschlagen, bietet eesel AI eine Ein-Klick-Integration mit Intercom, mit der Sie diese Probleme vollständig umgehen können.

So hilft es Ihnen:

• Bringen Sie all Ihr Wissen zusammen. Sie können Ihr Intercom-Hilfe-Center in wenigen Minuten verbinden. Aber warum dort aufhören? Sie können auch andere Orte verbinden, an denen Ihr Team Informationen speichert, wie Confluence, Google Docs und sogar frühere Support-Tickets. Ihr Wissen ist immer live und aktuell, ohne manuellen Aufwand.

• Starten Sie in Minuten, nicht in Monaten. Vergessen Sie den mehrstufigen API-Prozess, der einen Entwickler erfordert. Mit eesel AI können Sie sich anmelden, Ihre Quellen verbinden und sofort einen Mehrwert sehen, alles ganz allein.

• Setzen Sie Ihr Wissen ein. Ein statischer Export hat begrenzte Einsatzmöglichkeiten. Eine live verbundene Wissensdatenbank hingegen ist ein ernsthafter Vorteil. Einmal verbunden, kann Ihr Intercom-Wissen dabei helfen, einen KI-Copiloten zu betreiben, der Antworten für Ihre Agenten entwirft, einen autonomen KI-Agenten, der Tickets selbstständig löst, oder einen internen Q&A-Bot in Slack. Das ist ein echtes Ergebnis, nicht nur ein Datendump.

Der eesel AI Copilot entwirft eine Antwort und zeigt, wie vereinheitlichtes Wissen Support-Tools direkt unterstützen kann.

Profi-Tipps für das Wissensmanagement in Intercom

Wenn Sie Ihre Denkweise von manuellen Exporten wegbewegen, eröffnen sich bessere Wege zur Verwaltung Ihres Wissens. Hier sind ein paar Tipps, die Ihnen helfen, eine effektivere Strategie aufzubauen.

1. Finden und füllen Sie Wissenslücken automatisch. Einer der schwierigsten Teile bei der Verwaltung eines Hilfe-Centers ist zu wissen, was man als Nächstes schreiben soll. Anstatt zu raten, lassen Sie sich von Ihren Kundenkonversationen leiten. Ein KI-Tool wie eesel AI kann Ihre Support-Tickets analysieren, wiederkehrende Fragen erkennen, die in Ihrem Hilfe-Center nicht beantwortet werden, und automatisch Artikelentwürfe erstellen, um diese Lücken zu füllen.

Ein eesel AI-Dashboard, das zeigt, wie es Wissenslücken aus Support-Konversationen identifiziert, wodurch der manuelle Export von Intercom-Help-Center-Artikeln mit der API zur Analyse vermieden wird.

2. Lassen Sie Wissen nicht in Silos stecken bleiben. Das kollektive Wissen Ihres Unternehmens lebt nicht nur in Intercom. Wichtige Prozesse sind in Confluence dokumentiert, Produkt-Updates werden in Google Docs geteilt und schnelle Lösungen werden in Slack ausgetauscht. Eine bessere Support-Strategie vereint all diese Quellen und gibt Ihrem Team und Ihrer KI einen verlässlichen Ort, um Antworten zu finden.

3. Simulieren Sie, bevor Sie automatisieren. Wenn Sie Ihr Wissen zur Steuerung von KI einsetzen wollen, müssen Sie darauf vertrauen können, dass es korrekt funktioniert. Suchen Sie nach Tools, mit denen Sie risikofrei testen können. Zum Beispiel können Sie im Simulationsmodus von eesel AI Ihr KI-Setup auf Tausenden von früheren Tickets laufen lassen. Sie sehen genau, wie es reagiert hätte, und erhalten solide Prognosen zu den Lösungsraten, was Ihnen hilft, Vertrauen aufzubauen, bevor Sie es für Live-Kunden einschalten.

Die Simulationsfunktion in eesel AI, die es Teams ermöglicht, ihr KI-Setup an vergangenen Tickets zu testen und Vertrauen aufzubauen, bevor sie live gehen.

Über die Notwendigkeit hinaus: Export von Intercom-Help-Center-Artikeln mit der API

Obwohl Sie technisch gesehen Intercom-Help-Center-Artikel mit der API exportieren können, ist der Prozess ziemlich manuell, technisch anspruchsvoll und hat einige erhebliche Einschränkungen. Er lässt Ihr internes Wissen zurück und gibt Ihnen eine statische Momentaufnahme Ihrer Inhalte, die schnell nutzlos wird.

Ein modernerer und effizienterer Ansatz besteht darin, nicht mehr über einmalige Exporte nachzudenken, sondern ein live, vereinheitlichtes Wissenssystem aufzubauen. Anstatt Daten herauszuziehen, sollten Sie Ihre Tools anschließen.

Tools wie eesel AI sind dafür gemacht. Sie ermöglichen es Teams, ihre Wissensquellen in wenigen Minuten zu verbinden und diese Informationen sofort zu nutzen, ohne sich mit APIs herumzuschlagen oder Code zu schreiben. Es ist an der Zeit, das wahre Potenzial Ihrer Wissensdatenbank zu entfesseln.

Bereit, Ihr Wissen zu vereinheitlichen?

Verschwenden Sie keine Zeit mehr mit manuellen Exporten und komplexen API-Skripten. Verbinden Sie all Ihre Wissensquellen, einschließlich Ihres Intercom-Hilfe-Centers, in wenigen Minuten mit eesel AI.

Starten Sie noch heute Ihre kostenlose Testversion und sehen Sie, wie einfach es ist, Ihren Support mit wirklich vereinheitlichtem Wissen zu stärken.