Sie müssen Ihre Zendesk Daten extrahieren? Ob Sie einen Bericht erstellen, Ihre Historie sichern, auf eine neue Plattform migrieren oder einfach nur eine Führungsfrage mit konkreten Zahlen beantworten möchten – es gibt verschiedene Möglichkeiten. Nicht alle sind gleichwertig.
Dieser Leitfaden behandelt alle Zendesk angebotenen Exportmethoden, was jede einzelne tatsächlich liefert (und was sie stillschweigend auslässt) und wann man stattdessen auf ein Migrationstool zurückgreifen sollte.
Was Sie aus Zendesk exportieren können – und was nicht
Bevor Sie etwas anklicken, sollten Sie sich informieren, was das Exportsystem von Zendeskabdeckt. Sie können vier Datentypen exportieren:
- **Tickets** – Ticketfelder, Status, Bearbeiter, Anforderer, Tags, Datum
- **Benutzer** – Agenten- und Endbenutzerdatensätze
- **Organisationen** – Organisationsnamen, Domänen, benutzerdefinierte Felder
Was bei Standardexporten auffallend fehlt:
- Ticketkommentare und Konversationsverlauf – die eigentlichen Antworten und internen Notizen sind nicht im CSV -Export enthalten
- Anhänge – Dateien, die Tickets beigefügt sind, werden in keinem nativen Exportpaket mitgeliefert
- Kommentare zur Kundenzufriedenheit auf Tickets – während die rohe Zufriedenheitsbewertung „Gut“ oder „Schlecht“ als Metadaten in Massenexporten von Tickets enthalten ist, wird das tatsächliche schriftliche Feedback des Kunden vollständig entfernt
- Echtzeit-Chatprotokolle – separates Produkt, separater Exportpfad
- Benutzerdefinierte Objektdaten – nur über die API verfügbar
Wenn man diese Lücken imfront kennt, spart das viel Zeit. Falls Sie den Gesprächsverlauf benötigen, reicht der Standardexport nicht aus – wir werden Ihre Optionen später in diesem Leitfaden erläutern.
Methode 1 – Zendesk -Tickets aus einer Ansicht exportieren (CSV)
Die schnellste und einfachste Exportmethode. Sie funktioniert ohne spezielle Kontokonfiguration und kann von jedem Agenten mit den entsprechenden Berechtigungen ausgeführt werden.
Schritt-für-Schritt-Anleitung
- Melden Sie sich in Ihrem Zendesk Konto an.
- Klicken Sie in der linken Seitenleiste auf das Symbol **Ansichten** (das Raster aus horizontalen Linien).
- Wählen Sie die Ansicht aus, die die zu exportierenden Tickets enthält. Falls Sie keine benutzerdefinierte Ansicht eingerichtet haben, verwenden Sie eine der integrierten Ansichten, z. B. *Alle ungelösten Tickets*.
- Gehen Sie in die obere rechte Ecke der Ansichtsseite. Hinweis: Falls temporäre Suchfilter aktiv sind, ist die Export-Schaltfläche ausgeblendet. Deaktivieren Sie daher zunächst alle aktiven Filter. Klicken Sie je nach Version auf CSV exportieren“ oder wählen Sie im Dropdown-Menü „Aktionen“ die Option „Als CSVexportieren“.
- Bestätigen Sie den CSV -Export. Zendesk verarbeitet die Datei und sendet einen Download-Link an die in Ihrem Konto hinterlegte E-Mail-Adresse.
- Öffnen Sie die E-Mail und laden Sie die ZIP-Datei herunter, die Ihre CSVenthält.
Was ist in der CSV Datei enthalten?
Die exportierte CSV enthält die in Ihrer Ansicht sichtbaren Spaltenfelder sowie Standardfelder:
| Feld | Inklusive |
|---|---|
| Ticket-ID | ✓ |
| Thema | ✓ |
| Name und E-Mail-Adresse des Anfragenden | ✓ |
| Name des Empfängers | ✓ |
| Status | ✓ |
| Priorität | ✓ |
| Erstellungsdatum / Letzte Aktualisierung | ✓ |
| Tags | ✓ |
| Benutzerdefinierte Ticketfelder | ✓ (falls sichtbar) |
| Ticketkommentare / Antworten | ✗ |
| Anhänge | ✗ |
| Interne Notizen | ✗ |
Die Beschränkung auf 1.000 Tickets – und wie man sie umgehen kann
Dies ist der häufigste Kritikpunkt: Zendesk schneidet den Export von Ansichten bei 1.000 Tickets ab. Enthält Ihre Ansicht mehr Datensätze, stoppt der Export stillschweigend bei 1.000 Tickets ohne Warnung oder Fehlermeldung.
Um dieses Problem zu umgehen:
- Erstellen Sie mehrere gefilterte Ansichten mit Datumsbereichen, die jeweils weniger als 1.000 Tickets enthalten, und exportieren Sie anschließend jede Ansicht separat.
- Nutzen Sie stattdessen den vollständigen Massenexport (Methode 2) – dabei gibt es kein Limit pro Exportticket.
- Nutzen Sie die Zendesk API (Methode 4) für den programmatischen Zugriff auf alle Datensätze.
Methode 2 – Vollständiger Massendatenexport (CSV)
Der vollständige Datenexport liefert Ihnen ein komplettes Repository Ihrer Kerndaten ohne Ticketanzahlbeschränkungen. Er eignet sich ideal für die Erstellung eines vollständigen Backups oder die Vorbereitung einer Migration.
So aktivieren Sie den Datenexport (Kontoinhaber erforderlich)
Aus Sicherheitsgründen ist der vollständige Datenexport standardmäßig deaktiviert. Der Kontoinhaber muss den Support nicht kontaktieren, sondern die Funktion unter Admin Center → Konto → Sicherheit → Datenexport explizit aktivieren. Dort müssen die zugelassenen E-Mail-Domänen angegeben werden, die die exportierten Dateien empfangen dürfen. Nach der Konfiguration kann jeder Administrator einen Export an eine zugelassene E-Mail-Adresse anfordern.
Schritt für Schritt: Fordern Sie Ihren vollständigen Ticket-Export an
- Klicken Sie in Zendeskauf das Admin Center-Symbol (Rastersymbol).
- Navigieren Sie zu Konto → Sicherheit → Datenexport.
- Scrollen Sie zum Abschnitt CSV -Export“.
- Legen Sie einen Datumsbereich fest, wenn Sie den Umfang einschränken möchten, oder lassen Sie das Feld leer, um alle historischen Datensätze abzurufen.
- Klicken Sie auf Exportieren.
- Zendesk verarbeitet den Export im Hintergrund und sendet Ihnen einen ZIP-Ordner mit Ihrer CSV Datei per E-Mail an Ihre genehmigte E-Mail-Adresse.
Schritt für Schritt: Benutzer und Organisationen exportieren
Da das native Massendatenexporttool CSV Dateien ausschließlich auf Ticketdatensätze beschränkt, ist für die Extraktion einer sauberen Tabelle Ihrer Kunden- und Organisationsverzeichnisse ein programmatisches API-Skript erforderlich:
- Generieren Sie ein API-Token, indem Sie zu Admin Center → Apps und Integrationen → APIs → Zendesk API navigieren.
- Stellen Sie sicher, dass der Tokenzugriff aktiviert ist, und klicken Sie dann auf „API-Token hinzufügen“, um sichere Anmeldeinformationen zu generieren.
- Verwenden Sie ein programmatisches Skript (wie Python), um Anfragen an die Endpunkte /api/v2/users.json oder /api/v2/organizations.json zu senden.
- Konfigurieren Sie Ihre Code-Schleife so, dass sie Ihre aktiven Benutzer- und Organisationsverzeichnisse durchläuft, deren benutzerdefinierte Attribute abruft und diese direkt in eine lokalecsv Datei auf Ihrem Rechner schreibt.
Format- und Methodenleitfaden
| Format / Methode | Am besten geeignet für | Anmerkungen |
|---|---|---|
| CSV (Natives Massenverarbeitungstool) | Tabellenkalkulationsanalyse, BI-Tools | Einfacher in Excel/Google Sheets zu öffnen; nativ streng auf Ticket-Kerndaten und Metadaten beschränkt. Benutzer und Organisationen sind über den nativen CSV Zugriff nicht verfügbar. |
| API (Python / Code-Skripte) | Benutzerdefinierte Tabellenstrukturen, vollständige Kontrolle über Benutzer-/Organisationsdaten | Die ultimative Lösung für Kundenlisten. Mithilfe der API können Sie native Dateisperren vollständig umgehen, Ihre globalen Benutzer- oder databasesicher paginieren und diese Rohdatenprofile direkt in eine lokale CSV Datei schreiben. |
Wie lange dauert ein Zendesk -Export?
- Kleinere Konten (< 10.000 Tickets): in der Regel einige Minuten
- Mittlere Konten (10.000 – 500.000 Tickets): 30 Minuten bis einige Stunden
- Große Konten (> 1.000.000 Tickets): Die Bearbeitung kann bis zu 24 Stunden dauern; der Export erfolgt automatisch in 31-Tage-Schritten
Methode 3 – Zendesk Wissensdatenbank-/Leitfadendaten als CSV exportieren
Die oben genannten Methoden decken Ticket-, Benutzer- und Organisationsdaten ab. Zendesk Guide (Ihre Wissensdatenbank) ist ein separater Inhaltstyp und erfordert eine andere Vorgehensweise.
Verwendung der integrierten Exportfunktion des Hilfezentrums
Zendesk bietet im Standard-Admin-Dashboard keine native Exportfunktion für Guide-Artikel oder Kategorien mit nur einem Klick. Zwar können Sie in der Ansicht „Artikel verwalten“ mehrere Artikel auswählen und deren Einstellungen aktualisieren (z. B. Labels oder Autoren in großen Mengen ändern), deren Inhalte lassen sich jedoch nicht herunterladen oder exportieren. Für einen vollständigen Guide-Export als CSVist ein Python-API-Skript die zuverlässigste Methode.
Exportieren von Guide-Daten mit einem Python-Skript
Für einen vollständigen Guide-Export als CSVist ein Python-Skript, das die Zendesk Help Center API nutzt, die zuverlässigste Methode. Hier ist ein minimales, lauffähiges Beispiel:
Voraussetzungen:
- Python 3 installiert
- `requests`-Bibliothek: Führen Sie `pip install requests` aus
- Ihre Zendesk Subdomain, Ihre Administrator-E-Mail-Adresse und Ihr API-Token
import requests import csv SUBDOMAIN = "your-subdomain" EMAIL = "your-email@example.com" API_TOKEN = "your-api-token" url = f"https://{SUBDOMAIN}zendesk/api/v2/help_center/articles.json" auth = (f"{EMAIL}/token", API_TOKEN) articles = [] while url: response = requests.get(url, auth=auth) data = response.json() articles.extend(data["articles"]) url = data.get("next_page") with open("zendeskcsv, "w", newline="", encoding="utf-8") as f: writer = csv(f, fieldnames=["id", "title", "body", "section_id", "created_at", "updated_at"]) writer.writeheader() for article in articles: writer.writerow({ "id": article["id"], "title": article["title"], "body": article.get("body", ""), "section_id": article.get("section_id", ""), "created_at": article["created_at"], "updated_at": article["updated_at"], }) print(f"Exported {len(articles)} articles to zendesk_guide_export.csv")
Das Skript durchläuft automatisch alle Artikel Seite für Seite. Führen Sie es aus, und Sie erhalten eine übersichtliche CSV mit Artikel-IDs, Titeln, dem reinen HTML-Inhalt, Abschnittszuordnungen und Zeitstempeln.
Fehlerbehebung:
- **Syntax-/Terminalfehler** – Stellen Sie sicher, dass Sie Python 3 verwenden (auf manchen Betriebssystemen `python3` und nicht `python`)
- **Probleme mit der Zeichenkodierung** – der Parameter `encoding="utf-8"` im Skript deckt die meisten Fälle der Formatierung ab; falls Sie in Excel fehlerhafte HTML-Tags oder verstümmelten Text sehen, verwenden Sie in Excel das Menü Daten → Wählen Sie **Text/CSV** und wählen Sie beim Dateiimport explizit das UTF-8-Format aus.
- **Fehlende eingeschränkte Artikel** — Nur für interne Agenten/eingeschränkte Artikel erfordern API-Zugangsdaten auf Administratorebene; überprüfen Sie, ob Ihr API-Token zu einem aktiven Administratorkonto mit Berechtigungen zum Anzeigen aller Guide-Segmente gehört.
Sie möchten lieber keinen Code schreiben? Help Desk Migration übernimmt Zendesk Guide – Artikel, Kategorien, Abschnitte und Anhänge – automatisch im Rahmen einer vollständigen Migration.
Vergleich aller 4 Exportmethoden
| Methode 1: CSV anzeigen | Methode 2: Massenexport | Methode 3: Geführter Export | Methode 4: API | |
|---|---|---|---|---|
| Ticketlimit | 1,000 | Unbegrenzt | N / A | Unbegrenzt |
| Enthält Kommentare | ✗ | ✗ | N / A | ✓ |
| Inklusive Anhänge | ✗ | ✗ | ✓ (via HDM) | ✓ |
| Wissensdatenbank | ✗ | ✗ | ✓ | ✓ |
| Benutzer / Organisationen | ✗ | ✓ | ✗ | ✓ |
| Formate | CSV | JSON, CSV, XML | CSV | JSON |
| Administratorrechte erforderlich | NEIN | Ja (zum Aktivieren) | Nein (API-Token) | Nein (API-Token) |
| Einrichtungsaufwand | Niedrig | Niedrig | Mittel (Python) | Hoch (Code) |
| Am besten geeignet für | Schnelle Stichproben | Vollständige Datensicherungen | KB-Archiv | Entwicklungspipelines / Migration |
Um Konversationsströme (den eigentlichen Text in Nachrichten und internen Notizen) nativ und in großen Mengen zu extrahieren, müssen Sie den Endpunkt für inkrementelle Ticketereignisse anstelle des Endpunkts für den einfachen Ticket-Wrapper abfragen. Dieser Stream gibt spezifische Konversationsparameter zurück, wenn Sie den Parameter `include=comment_events` für das Sideloading anwenden
GET https://{subdomain}zendesk/api/v2/incremental/ticket_events.json?start_time=1763550000&include=comment_events
Ersetzen Sie `start_time=0` durch einen Unix-Zeitstempel, um nur Datensätze abzurufen, die nach diesem Zeitpunkt aktualisiert wurden – nützlich für tägliche inkrementelle Synchronisierungen.
Authentifizierung: Verwenden Sie die Basisauthentifizierung mit `{email}/token` als Benutzernamen und Ihrem API-Token als Passwort, oder OAuth, falls Sie dies eingerichtet haben.
Paginierung: Inkrementelle Endpunkte verwenden Stream-Markierungen. Für zeitbasiertes Tracking müssen Sie die Ganzzahlzeichenfolge `end_time` aus der JSON-Antwortnutzlast extrahieren und als neue `start_time` in Ihre nachfolgende API-Anfrage einfügen. Wiederholen Sie diese Schleife so lange, bis die boolesche Eigenschaft `end_of_stream` der Nutzlast den Wert `true` hat.
Die Entwicklung einer benutzerdefinierten Exportpipeline ist zeitaufwändig. Wenn es darum geht, Daten auf eine neue Plattform zu migrieren, automatisiert Help Desk Migration diesen Vorgang ohne jegliche Programmierung und ordnet Felder automatisch zu.
So exportieren Sie Kommentare und Konversationen Zendesk -Tickets
Das ist die Frage, die die meisten Ratgeber überspringen – und genau diese Frage bereitet den Teams am häufigsten Probleme.
Das Problem: der Standard CSV -Export als auch der vollständige Massenexport lassen Ticketkommentare aus. Man erhält zwar die Ticketinformationen (Status, Bearbeiter, Datum, Tags), aber nicht den eigentlichen Gesprächsverlauf – die Antworten, internen Notizen und den Kontext, die Tickets als Dokumente nützlich machen.
Warum fehlen Kommentare im Standardexport?
Der CSV Export von Zendeskwurde für Berichterstellung und Analyse entwickelt, nicht für die vollständige Datenportabilität. Es wird davon ausgegangen, dass Sie Zendeskweiterhin nutzen, daher benötigen Sie den Konversationstext nicht als portable Datei.
Wie man Kommentare über die API erhält
Verwendung der Tickets-API mit Sideloading:
GET https://{subdomain}zendesk/api/v2/tickets/{ticket_id}/comments.json
Diese Funktion gibt alle öffentlichen Antworten, privaten internen Notizen und Systemereignisse für ein Ticket in chronologischer Reihenfolge zurück, einschließlich des Autors und des Zeitstempels jedes Kommentars.
Für den Massenexport von Kommentaren aus allen Tickets verwenden Sie den inkrementellen Export-Endpunkt mit `include=comment_events`, wie in Methode 4 gezeigt.
Der Nachteil: Das Abrufen von Kommentaren für ein großes Konto über die API ist zeitaufwändig und erfordert das Schreiben von Code, um Tickets mit ihren Kommentaren zu verknüpfen und eine kohärente Struktur auszugeben.
Wann ein Migrationstool die schnellere Option ist
Wenn Sie Kommentare benötigen, weil Sie die Plattform wechseln, gibt es einen schnelleren Weg. Help Desk Migration migriert den gesamten Konversationsverlauf – öffentliche Antworten, interne Notizen und Dateianhänge – direkt in Ihren neuen Helpdesk, mit automatischer Feldzuordnung und ohne CSV Zwischenspeicherung.
Was HDM von Zendeskmigriert:
- Tickets mit vollständigem Gesprächsverlauf (öffentlich + privat)
- Anhänge
- Nutzer und Organisationen
- Wissensdatenbankartikel (Leitfaden)
- Benutzerdefinierte Felder und Tags
Sie wechseln zu einer neuen Plattform? – Keine Kreditkarte erforderlich, Einrichtung dauert etwa 20 Minuten.
Alle Exportmethoden im Vergleich
| Methode 1: CSV anzeigen | Methode 2: Massenexport | Methode 3: Geführter Export | Methode 4: API | |
|---|---|---|---|---|
| Ticketlimit | 1,000 | Unbegrenzt | N / A | Unbegrenzt |
| Enthält Kommentare | ✗ | ✗ | N / A | ✓ |
| Inklusive Anhänge | ✗ | ✗ | ✓ (via HDM) | ✓ |
| Wissensdatenbank | ✗ | ✗ | ✓ | ✓ |
| Benutzer / Organisationen | ✗ | ✓ | ✗ | ✓ |
| Formate | CSV | JSON, CSV, XML | CSV | JSON |
| Administratorrechte erforderlich | NEIN | Ja (zum Aktivieren) | Nein (API-Token) | Nein (API-Token) |
| Einrichtungsaufwand | Niedrig | Niedrig | Mittel (Python) | Hoch (Code) |
| Am besten geeignet für | Schnelle Stichproben | Vollständige Datensicherungen | KB-Archiv | Entwicklungspipelines / Migration |
Behebung häufiger Zendesk -Exportfehler
Die Export-E-Mail ist nie angekommen
- Überprüfen Sie zuerst Ihren Spam-Ordner
- Stellen Sie sicher, dass die E-Mail-Adresse Ihres Zendesk Kontos zugänglich ist
- Bei Massenexporten kann die Bearbeitung großer Konten bis zu 24 Stunden dauern – warten Sie, bevor Sie eine erneute Anfrage stellen
- Das erneute Anfordern eines Exports, während ein anderer Export bereits verarbeitet wird, kann zu Konflikten in der Warteschlange führen. Stornieren Sie daher zuerst die ausstehende Anfrage über die Registerkarte „Berichte“
- Beachten Sie, dass ein Exportauftrag nach dem Absenden nicht mehr über die Benutzeroberfläche abgebrochen oder geändert werden kann. Mehrere Exportaufträge innerhalb kurzer Zeit können die Serverwarteschlange überlasten. Warten Sie daher am besten, bis das System die ursprüngliche Anfrage vollständig verarbeitet hat.
Download-Link abgelaufen
Zendesk -Export-Downloadlinks sind nach einer bestimmten Zeit ungültig (in der Regel 3 Tage für Massenexporte, kürzer für Ansichtsexporte). Wenn Ihr Link abgelaufen ist, gehen Sie zu **Admin Center → Berichte → Export** und fordern Sie die Datei erneut an.
Syntaxfehler in der heruntergeladenen Datei
Am häufigsten bei JSON-Exporten. Zendesk exportiert NDJSON (Zeilenumbruch-getrenntes JSON) – jede Zeile ist ein separates JSON-Objekt, kein herkömmliches JSON-Array. Tools, die ein `[...]`-Array erwarten, geben einen Syntaxfehler aus.
Lösung: Die Datei in ein JSON-Array einbetten oder mit einem einfachen Skript konvertieren:
Probleme mit der Zeichenkodierung
Wenn Sonderzeichen (Akzente, nicht-lateinische Schriften, Gedankenstriche) in Excel fehlerhaft dargestellt werden:
- Öffnen Sie die CSV nicht per Doppelklick
- In Excel gehen Sie zu **Daten → Aus Text/CSV**
- Wählen Sie die Datei aus und wählen Sie im Importassistenten **UTF-8** als Kodierung
Fehlende interne (eingeschränkte) Artikel im Guide-Export
Das Python-Skript oder der API-Aufruf benötigt Administratorrechte für den Zugriff auf interne Artikel. Wenn Ihr API-Token zu einem Agentenkonto gehört, werden interne Artikel stillschweigend herausgefiltert. Verwenden Sie stattdessen ein Administrator-E-Mail-/Token-Paar.
## Wenn manuelle Exporte nicht ausreichen – Umzug auf eine neue Plattform
Manuelle Exporte eignen sich gut für Backups, Berichte und einmalige Datenabfragen. Sie stoßen jedoch an ihre Grenzen, wenn das Ziel der tatsächliche Umzug auf eine andere Plattform ist.
Die Probleme häufen sich:
- Kommentare und Konversationsverlauf erfordern die API, nicht den Export über die Benutzeroberfläche.
- Der Import einer unformatierten JSON- oder CSV in ein neues Helpdesk-System erfordert eine Feldzuordnung – selten eine 1:1-Übereinstimmung
. - Anhänge verbleiben im Zendesk-Speicher, nicht in Ihrer Exportdatei.
- Der Export großer Konten dauert Stunden oder Tage, der Import weitere Stunden.
- Inkrementelle Aktualisierungen zwischen Exportbeginn und Migrationsabschluss erzeugen Datenlücken.
Genau dafür wurden migrationsspezifische Tools entwickelt.
Wie Help Desk Migration den vollständigen Zendesk Datentransfer handhabt
Help Desk Migration verbindet sich über eine API direkt mit Zendesk und Ihrer Zielplattform und überträgt Daten ohne zwischengeschaltetes CSV Format:
- ** Zendeskverbinden** – Geben Sie Ihre Subdomain und Ihr API-Token ein
- **Verbinden Sie Ihr Ziel** – Freshdesk, Jira Service Management, HubSpot, Intercomoder über 60 weitere
- **Felder zuordnen** – der Assistent zeigt Ihnen Quell- und Zielfelder nebeneinander an; benutzerdefinierte Felder sind enthalten
- **Führen Sie eine Demo-Migration durch** – migriert eine Stichprobe von 20 Tickets, damit Sie das Ergebnis vor dem endgültigen Commit überprüfen können
- **Führen Sie die vollständige Migration durch** – HDM kümmert sich automatisch um Paginierung, Ratenbegrenzung, Anhänge und Konversationsverlauf
- **Delta-Migration** – Führen Sie nach der Hauptmigration eine letzte Synchronisierung durch, um Tickets zu erfassen, die während des Zeitraums aktualisiert wurden
Was bewegt sich:
- Tickets mit vollständigem Gesprächsverlauf (öffentliche + private Notizen)
- Ticketanlagen
- Nutzer und Organisationen
- Wissensdatenbankartikel mit Struktur (Kategorien, Abschnitte)
- Benutzerdefinierte Felder und Tags
— Einrichtung in 20 Minuten, keine Kreditkarte erforderlich.
Häufig gestellte Fragen
Sie möchten Ihr gesamtes Zendesk -Konto auf eine neue Plattform migrieren? Sehen Sie genau, was migriert wird, bevor Sie die vollständige Migration durchführen.