Teil 1. So bereiten Sie sich auf den Zendesk®-Import vor
Teil 2. Was, warum und wie importiert man Daten in Zendesk®?
- Zendesk®-Import: Die Vorgehensweise und Details im Detail
- Wie man eine gültige CSV-Datei erstellt
- Zendesk® Datenimportbeschränkung
- Einrichten einer CSV-Datei für den Massenimport
- Liste der Felder für den Import von Organisationen
- So importieren Sie die CSV-Organisationsdatei
- Eine Liste der Felder für den Benutzerimport
- Die Besonderheiten der Rollenvergabe an kundenspezifische Agenten
- So importieren Sie die CSV-Benutzerdatei
- Google Docs-Importer für die Wissensdatenbank
- Schwachstellen beim CSV-Import
- Meistern Sie die Kunst der Datenbankmigration
- Was steckt hinter einer Datenbankmigration?
- Wie man Daten aus einer MySQL-Datenbank exportiert
- Datenextraktion mit dem Oracle-Exportprogramm
- Unterstützte Datensätze für den Zendesk®-Massenimport
- Die Organisationsimportfelder
- Die Benutzerimportfelder
- Zendesk® Leitfaden zum Massenimport
- Die Wissensdatenbank zu Zendesk® übertragen
- API-Datenmigration? Ganz einfach, wenn man es clever angeht
Teil 3. Das Ziel ist erreicht: Was nun?
Was, warum und wie importiert man Daten in Zendesk®?
Zendesk®-Import: Die Vorgehensweise und Details im Detail
Viele Unternehmen streben danach, die Vorteile der Technologie zu nutzen. Die Helpdesk-Software treibt diesen Wandel voran und vereinfacht gleichzeitig den Kundensupport. Der vollständige Migrationsplan enthält eine detaillierte Beschreibung der Prozesse, Verantwortlichkeiten und Zeitrahmen. So lässt sich das Risiko von Budgetüberschreitungen minimieren und die Mitarbeiter nicht mit zusätzlichen Aufgaben überfordern.
Bevor Ihre Datensätze zu Zendesk®-Daten werden, müssen sie die Prozesse ETL (Extrahieren, Transformieren, Laden) durchlaufen. Die Transformation ist optional, die anderen beiden sind unerlässlich. Unabhängig davon, ob Ihr Unternehmen Daten aus einem SQL-Dump oder von einer alten Helpdesk-Plattform importiert, sind die Daten selbst entscheidend. Menge und Qualität beeinflussen die Entscheidung, ob Sie Ihre Daten zu Zendesk® übertragen oder von dort wechseln. Die Anzahl der Kontakte, Tickets, Agenten und Wissensdatenbankinhalte könnte aufgrund von [fehlende Information] nicht erhalten bleiben
- die technischen Beschränkungen während des Export- oder Importprozesses
- Das Importtool bzw. der Migrationsdienst erlaubt das Hochladen großer CSV-Dateien nicht
- Die SQL-Dump-Dateien müssen neu verschlüsselt werden, um den Anforderungen der Zielsoftware zu entsprechen
- API-Beschränkungen während der Datenmigration und ähnliches.
Welche Daten werden auf der neuen, modernen Helpdesk-Plattform benötigt? Das Hauptinteresse besteht im Import von Benutzern (Agenten und Agentengruppen), Kontakten, Unternehmen, Tickets und einer Wissensdatenbank.
Die nächste Frage ist, wie diese Daten zu Zendesk® gelangen. Hier geben wir Tipps, wie dies auf drei verschiedene Arten möglich ist: CSV-Import, Datenbank- oder Dump-SQL-Migration und API-basierter Datentransfer.
Kundensupportdaten lassen sich per CSV-Datei importieren. Das klingt einfach und lässt vermuten, dass es schnell geht. Zendesk® unterstützt den Massenimport von Daten unter bestimmten Bedingungen. Vereinfacht gesagt, können Sie Benutzer (d. h. Kontakte und Unternehmen), Agenten, Agentengruppen sowie die Wissensdatenbank in Zendesk® Guide importieren. Tickets übertragen Sie über die API. Daher können beim erfolgreichen Import Ihrer Organisation einige Hürden auftreten. Der Importprozess unterliegt außerdem Einschränkungen, die von Ihrem gewählten Tarif abhängen und im Folgenden erläutert werden. Lesen Sie weiter.
Wie man eine gültige CSV-Datei erstellt
Bevor wir uns mit dem Zendesk®-Import befassen, sehen wir uns kurz CSV-Dateien und deren korrekte Erstellung an. CSV steht für „Comma-Separated Values“ (Komma-getrennte Werte). Einfache Beispiele hierfür sind Tabellenkalkulationen oder Datenbanken. Programme, die Daten in Tabellen speichern, ermöglichen den Import und Export von Dateien in diesem Format.Um es genauer zu sagen, hier ein Beispiel für eine Tabelle:
| Kontakt | Titel | Etikett | |
| John Doe | Leitender Manager | [email protected] | Er sprach am Dienstag und zeigte Interesse |
| Harry Winston | Vertriebsleiter | [email protected] | Ich solle nächste Woche wieder anrufen |
| Cheryl Cole | Entwicklungsdirektor | [email protected] | Kein Interesse, habe eine Weiterempfehlung ausgesprochen |
Hinweis: Wenn Ihre Datensätze ein Komma enthalten, sollten Sie diese in doppelte Anführungszeichen setzen, um zu vermeiden, dass diese Kommas als Trennzeichen verwendet werden.
So sollten die Datensätze im CSV-Format aussehen:
Kontakt, Titel, E-Mail, Schlagwort
John Doe, leitender Angestellter, [email protected]
, sagte am Dienstag, er sei interessiert.
Harry Winston, Vertriebsleiter, [email protected] , „sagte, ich solle nächste Woche wieder anrufen“.
Cheryl Cole, Entwicklungsdirektorin, [email protected] ,„Kein Interesse, Weiterleitung empfohlen“
Die Kopfzeile ist in der Regel optional (für den Zendesk®-Import jedoch obligatorisch). Die erste Zeile der Datei hat dasselbe Format wie die übrigen Datensatzzeilen. Sie beschreibt die Namen der entsprechenden Felder in der Datei. Kopfzeile und die übrigen Datensätze in der Datei sollten die gleiche Anzahl an Feldern enthalten.
Hier ist ein Beispiel für eine CSV-Datei:
Feldname,Feldname,Feldname
aaa,bbb,ccc
ddd,eee,fff
Eine weitere wichtige Regel des CSV-Formats besagt, dass jede Zeile innerhalb der Datei die gleiche Anzahl an Feldern enthalten muss. Leerzeichen zählen zu den Feldern und dürfen nicht ignoriert werden. Außerdem darf der letzte Datensatz einer Zeile kein Komma enthalten.
Was ist das UTF-8-Format? Es ist die gängigste Zeichenkodierung für das World Wide Web. Um den Fehler „Ungültige Bytefolge in UTF-8“ zu beheben, öffnen Sie Ihre Datei in Google Tabellen (oder Notepad oder Microsoft Excel) und speichern Sie sie erneut mit der UTF-8-Kodierung. Falls Sie die CSV-Datei aus der Software exportiert haben, überprüfen Sie die Optionen (möglicherweise können Sie das Format auswählen) und exportieren Sie die Datensätze erneut.
Zendesk®-Datenimportbeschränkungen
In Zendesk® können Sie die Kerndaten importieren: Benutzer und Organisation. Die Option des Massenimports steht Kunden von [Name der Organisation/des Unternehmens] zur Verfügung- Essentiell
- Team
- Professional
- Unternehmen
Wichtig : Wenn Sie diese Zendesk®-Importoption verwenden, sollten die Organisationen vor den Benutzern importiert werden.
Werfen wir einen Blick auf einige kleine, aber dennoch bemerkenswerte Probleme, die beim Datenimport Grenzen setzen:
- Der Massenimport erlaubt es nicht, Zeitzonen, Fotos, Spracheinstellungen und Ähnliches zu importieren.
- Ihre CSV-Datei sollte maximal 2000 Datensätze enthalten: eine Zeile für die Kopfzeile und die restlichen Zeilen für die Unternehmensdaten.
- Sie können jeweils eine CSV-Datei (bis zu 2000 Datenzeilen) importieren.
- Wenn Ihre Datei mehr als 1999 Datenzeilen enthält, sollten Sie zwei separate Batches erstellen und diese dann importieren.
Einrichten einer CSV-Datei für den Massenimport
Es sollte eine CSV-Datei gemäß den spezifischen Anforderungen erstellt werden. Hier einige Hintergrundinformationen.
- Speichern Sie Ihre Datei im korrekten Format mit UTF-8-Zeichenkodierung.
- Überprüfen Sie die erste Zeile der CSV-Datei. Es sollte sich um eine Kopfzeile handeln.
- Die Kopfzeile muss alle Pflichtfelder oder alle anderen Felder enthalten, die Sie importieren möchten. (Stellen Sie sicher, dass alle diese Felder beim Massenimport unterstützt werden.)
- Geben Sie die enthaltenen Felder in der Reihenfolge ein, in der sie in der Kopfzeile aufgeführt sind.
- Listen Sie in der Kopfzeile nur die Felder auf, für die Sie Daten importieren möchten.
- Das Datum für den Zendesk®-Import sollte im Format JJ/MM/TT oder JJJJ-MM-TT angegeben werden.
- Um Zeilenumbrüche in Notizen oder mehreren benutzerdefinierten Feldern einzufügen, verwenden Sie die Tastenkombinationen: ALT + ENTER unter Windows oder STRG + WAHL + RETURN auf einem Mac.
Liste der Felder für den Import von Organisationen
Die bloße Auflistung der für den Massenimport verfügbaren Felder kann verwirrend sein. Deshalb ist jedes Feld kurz beschrieben, um die Funktion zu verdeutlichen.
| Name | Dieses Feld ist erforderlich und gibt den Namen der Organisation an. |
|---|---|
| externe_ID | Falls Ihre Dokumentation eine eindeutige Identifikations-ID enthält, die sich vom Namen der Organisation unterscheidet, können Sie diese über dieses Feld importieren. |
| Notizen | Dies sind einige Hinweise zur Organisation. Nur Agenten können sie einsehen, Endnutzer (auch Kunden genannt) nicht. |
| Details | Das Feld enthält detaillierte Informationen über die Organisation. Nur Agenten können diese Informationen einsehen, Endbenutzer nicht. |
| Standard | Hier sollten Sie eine oder mehrere E-Mail-Domänen, getrennt durch Leerzeichen, hinzufügen. Dieses Feld dient der Zuordnung von Endbenutzern zu einer Organisation. |
| geteilt | Richtig oder falsch. Es legt die Organisation als eine gemeinsame fest. |
| gemeinsame Kommentare | Wahr oder falsch. Wenn dieses Feld auf „Wahr“ gesetzt ist, können alle Benutzer der Organisation die Tickets der anderen Benutzer kommentieren. Hinweis: Das Feld „Gemeinsam“ muss ebenfalls auf „Wahr“ gesetzt sein, damit dies funktioniert. |
| Gruppe | Hier können Sie eine Standardgruppe (Agentengruppe) für die Organisation festlegen. Diese Zuordnung kann später geändert werden, und die Tickets der Organisation werden der Gruppe zugewiesen, die Sie im Menü auswählen: Admin > Personen > Organisationen > Gruppe. |
| Tags | Dieses Feld enthält Schlagwörter. Trennen Sie die einzelnen Schlagwörter durch Leerzeichen. Diese Option ist verfügbar, nachdem sie im Menü unter „Admin > Kunden > Schlagwörter für Benutzer und Organisationen > Aktiviert“ aktiviert wurde. Wichtig: Diese Option ist in den Tarifen „Team“, „Professional“ und „Enterprise“ verfügbar. |
| custom_fields.<field key> |
Sie können ein benutzerdefiniertes Organisationsfeld mithilfe des custom_fields.“ und eines Feldschlüssels importieren. Einfaches Beispiel: Für den Feldschlüssel „ registration_date“ sollten Sie den Wert „ custom_fields.registration_date“ Wichtig : Um den Schlüssel für ein benutzerdefiniertes Organisationsfeld zu finden, gehen Sie zu „Admin“ > „Organisationsfelder“ und klicken Sie auf den Namen des benutzerdefinierten Felds. Anschließend wird es im Eigenschaftenbereich auf der rechten Seite angezeigt. |
Wenn Sie den Wert von Dropdown-Listenoptionen festlegen möchten, müssen Sie das Tag verwenden, das beim Erstellen der Dropdown-Liste hinzugefügt wurde.
So importieren Sie die CSV-Organisationsdatei
Der Massenimport ermöglicht das Importieren neuer Informationen über die Organisationen oder das Aktualisieren der vorhandenen Informationen.
Der CSV-Import erfordert fünf Schritte:
- Klicken Sie in der Seitenleiste auf das Zahnradsymbol „Admin“ „Personen“.
- Wählen Sie „Massenimport von Organisationen“.
- Wählen Sie den gewünschten Importtyp aus:
- Neue Organisationen gründen
- Bestehende Organisationen aktualisieren
- Klicken Sie auf „Datei auswählen“ oder auf den Link „Daten stattdessen einfügen“.
- Klicken Sie auf Importieren.
Anschließend werden Ihre Dateien in die Warteschlange gestellt. Sobald der Importvorgang abgeschlossen ist, werden die Organisationen Ihrem Zendesk® Support hinzugefügt. Sie erhalten eine E-Mail, sobald alles erledigt ist.
Hinweis: Beim Massenimport können Sie zwei Stapel gleichzeitig in die Warteschlange stellen. Falls weitere Stapel importiert werden müssen, warten Sie bitte, bis der Import des ersten Stapels abgeschlossen ist. Erst dann können Sie einen weiteren Stapel importieren.
Zur weiteren Aktualisierung: Falls Sie die Daten per Massenimport aktualisieren möchten, beachten Sie bitte Folgendes: Die Aktualisierung bestehender Organisationen bedeutet, dass die aktuellen Daten durch die Datensätze aus der CSV-Datei ersetzt werden. Es empfiehlt sich, nur die zu aktualisierenden Felder auszuwählen und die übrigen Spalten leer zu lassen. Die leeren Spalten werden dann mit den vorhandenen Daten überschrieben.
Eine Liste der Felder für den Benutzerimport
Beim Erstellen einer CSV-Datei für den Benutzerimport können Sie die folgenden Felder hinzufügen.
Wichtig : Die Felder Name, E-Mail-Adresse und Einschränkung sind für den Import neuer Benutzer obligatorisch. Für das Update benötigen Sie nur eine eindeutige Kennung (z. B. eine E-Mail-Adresse oder eine externe ID).
| Name | Hier geben Sie den vollständigen Namen des Benutzers ein. |
|---|---|
| Hier die E-Mail-Adresse des Benutzers hinzufügen. Sie können für einen Benutzer mehrere primäre und sekundäre E-Mail-Adressen hinzufügen. Weisen Sie den E-Mail-Adressen des Benutzers einfach dieselbe externe ID zu; diese ID leitet dann alle E-Mails an diesen Benutzer weiter. | |
| externe_ID | Hier können Sie eine Benutzer-ID importieren, die sich von der E-Mail-Adresse des Benutzers unterscheidet (Agenten-ID oder Kundenreferenznummer). Externe IDs müssen für jeden Benutzer eindeutig sein. |
| Details | Dieses Feld ermöglicht das Hinzufügen erweiterter Benutzerinformationen. Diese sind nur für Agenten sichtbar, nicht für Endbenutzer. |
| Notizen | Dies sind einige Notizen zu diesem Benutzer. Nur Agenten können sie sehen, Endbenutzer nicht. |
| Telefon | Die Telefonnummern des Benutzers werden hier importiert. Fügen Sie die eindeutigen Telefonnummern als Direktwahlnummern und die bestehenden Telefonnummern als Nebenwahlnummern hinzu. Sie können auch mehrere primäre und sekundäre Telefonnummern für einen einzelnen Benutzer hinzufügen. Weisen Sie den Telefonnummern dieses Benutzers dieselbe externe ID zu. |
| gemeinsame Telefonnummer | Wahr oder falsch. Falls dieses Feld „wahr“ lautet, handelt es sich um eine gemeinsam genutzte Telefonnummer. Die gemeinsam genutzte Telefonnummer kann nicht als Benutzeridentität festgelegt werden. |
| Rolle | Dieses Feld unterscheidet zwischen Groß- und Kleinschreibung. Hier geben Sie „Endbenutzer“, „Agent“ oder „Administrator“ ein. Wenn Sie keine Rolle angeben, wird der Benutzer als Endbenutzer festgelegt. |
| Beschränkung | Dieses Feld ist für neue Benutzer mit der Rolle „Agent“ erforderlich. Es legt Berechtigungen, den Zugriff auf Tickets usw. fest. Sie können einen der folgenden Werte hinzufügen:
|
| Organisation |
In diesem Feld fügen Sie die Organisation hinzu, in die der Benutzer importiert werden soll. Die Organisation muss bereits existieren; andernfalls schlägt der Import fehl.
Wenn Sie einen Professional- oder Enterprise-Tarif nutzen, können Sie einen Benutzer mehreren Organisationen zuordnen. Geben Sie dazu einfach die gewünschten Organisationen durch ein Pipe-Zeichen (|) getrennt in der Tabelle „Organisation“ Ihrer CSV-Benutzerdatei ein. Die Formatierung sollte wie folgt aussehen: |
| Tags |
Dieses Feld enthält Schlagwörter. Trennen Sie die einzelnen Schlagwörter durch Leerzeichen. Diese Option ist verfügbar, nachdem sie im Menü unter „Admin > Kunden > Schlagwörter für Benutzer und Organisationen > Aktiviert“ aktiviert wurde. |
| Marke |
Falls Ihr Konto mehrere Marken umfasst, können Sie hier eine Subdomain angeben (verwenden Sie meinedomain und nicht meinedomain.zendesk.com ). Die ausgewählte Subdomain bestimmt die Willkommens-E-Mail, die dem Benutzer zugesendet wird, vorausgesetzt, die Marke ist aktiv und verfügt über ein aktiviertes Hilfecenter. Ist die Marke nicht aktiv, verfügt sie nicht über ein aktiviertes Hilfecenter oder existiert sie nicht, wird diese Spalte ignoriert. |
| custom_fields.<field key> |
Sie können ein benutzerdefiniertes Benutzerfeld mithilfe des „custom_fields.“ und eines Feldschlüssels importieren. Einfaches Beispiel: Für den Feldschlüssel „ registration_date“ sollten Sie den Wert „ custom_fields.registration_date“ festlegen. Wenn die Informationen in ein Kontrollkästchen importiert werden, fügen Sie „true“ hinzu, wenn es aktiviert ist, oder „false“, wenn es deaktiviert bleibt. Wichtig : Um den Schlüssel für ein benutzerdefiniertes Organisationsfeld zu finden, gehen Sie zu „Admin“ > „Benutzerfelder“ und klicken Sie auf den Namen des benutzerdefinierten Felds. Anschließend wird es im Eigenschaftenbereich auf der rechten Seite angezeigt. |
Wenn Sie den Wert von Dropdown-Listenoptionen festlegen möchten, müssen Sie das Tag verwenden, das beim Erstellen der Dropdown-Liste hinzugefügt wurde.
Die Besonderheiten der Rollenvergabe an kundenspezifische Agenten
Der Enterprise-Plan bietet die Möglichkeit, Agenten vordefinierte, benutzerdefinierte Rollen zuzuweisen. Diese verfügen über mehr Berechtigungen als die Standardrollen. Hier sind die Rollen und ihre Beschreibungen kurz aufgeführt:
- Legacy Agent ist eine Übergangsrolle für Agenten, die noch keiner anderen Rolle zugewiesen wurden.
- Light Agents sind als Professional- oder Enterprise-Add-on verfügbar. Diese Agenten können Tickets in CC setzen, Tickets einsehen und innerhalb ihrer Gruppen private Kommentare hinzufügen. Sie können Tickets weder zugewiesen noch bearbeitet werden. Die Anzahl der Light Agents ist unbegrenzt und kostenlos.
- Die Mitarbeiter sind für die Bearbeitung von Ticketanfragen zuständig. Sie können Tickets bearbeiten, Berichte einsehen sowie persönliche Ansichten und Makros hinzufügen und bearbeiten.
- Der Teamleiter verfügt über mehr Zugriffsrechte als die Mitarbeiter. Er kann alle Tickets lesen und bearbeiten, Foren moderieren sowie Endbenutzer, Gruppen und Organisationen erstellen und bearbeiten.
- Der Berater verwaltet den Workflow und konfiguriert Ihr Zendesk®. Dieser Agent bearbeitet keine Tickets.
- Administratoren haben die volle Kontrolle über Zendesk®, außer bei der Änderung von Abrechnungsinformationen oder Zahlungsplänen.
Sie können eigene Agentenrollen erstellen. Um diese zu importieren, geben Sie den Namen der Rolle in der Spalte „Einschränkung“ ein. Wenn Sie beispielsweise eine Rolle verwenden, die in Zendesk® noch nicht existiert, wird Ihr Agent als „Light Agent“ festgelegt. Die Rolle kann in Ihrem Profil manuell geändert werden.
Hinweis: Im Enterprise-Plan ist die Agentenrolle wichtiger als die Standard-Agentenbeschränkungen. Anstelle der Standardbeschränkungen müssen Sie eine Agentenrolle hinzufügen.
So importieren Sie die CSV-Benutzerdatei
Der CSV-Benutzerimport erfordert fünf Schritte:
- Klicken Sie in der Seitenleiste auf das Zahnradsymbol „Admin“ „Personen“.
- Wählen Sie „Massenimport von Benutzern“.
- Wählen Sie den gewünschten Importtyp aus:
- Neue Benutzer erstellen
- Bestehende Benutzer aktualisieren
- Klicken Sie auf „Datei auswählen“ oder auf den Link „Daten stattdessen einfügen“.
- Klicken Sie auf Importieren.
Anschließend werden Ihre Dateien in die Warteschlange gestellt. Sobald der Importvorgang abgeschlossen ist, werden die Organisationen Ihrem Zendesk® Support hinzugefügt. Sie erhalten eine E-Mail, sobald alles erledigt ist.
Google Docs-Importer für die Wissensdatenbank
Die Wissensdatenbank kann mithilfe des integrierten Google Docs-Importers in Zendesk® Guide importiert werden.Wer kann es benutzen?
Diese Option ist für die Tarife Lite, Professional und Enterprise verfügbar.Wie funktioniert es?
Sie müssen Guide-Manager sein, um Google Docs zu verbinden und zu importieren. Anschließend können Sie Google Docs aus Ihrem Google Drive hochladen. Durch den Dokumentenimport werden Bilder und Formatierung korrekt behandelt. Die Darstellung der Inhalte wird jedoch durch das Design Ihres Hilfezentrums bestimmt.Ihre Artikel und die Google Docs sind nicht synchronisiert. Außerdem können Sie sie nicht aus der Wissensdatenbank in Google Docs exportieren.
Wenn Sie eine Fehlermeldung erhalten, bedeutet dies, dass die Anzahl der API-Anfragen beim Import möglicherweise überschritten wurde. Der Google Docs-Importer nutzt die API und unterstützt Essential-Konten mit einem Limit von 10 Anfragen pro Minute.
Importieren Sie ein Google-Dokument in das Zendesk® Help Center
- Gehen Sie in Ihrem Zendesk® Guide zu „Inhalte anordnen“ > „Artikel importieren“.
- Wenn Sie nicht in Ihrem Google-Konto angemeldet sind, klicken Sie auf „ Verbinden“. Falls Sie Ihren Guide noch nicht mit Google Drive verbunden haben, werden Sie durch den Anmeldevorgang und die Zugriffserteilung für Zendesk® Guide geführt. Klicken Sie anschließend auf „ Weiter“.
- In Dokumente auswählen, klicken Dateiauswahl öffnen. Anschließend werden Ihnen alle Ordner und Dateien angezeigt, auf die Sie zugreifen können. Suchen Sie die Datei(en), die Sie importieren möchten, und klicken Sie darauf Wählen.
Hinweis : Sie können bis zu 100 Dateien gleichzeitig importieren.
- Die Dateien finden Sie auf der Administrationsseite „Artikel importieren“. Um eine andere Datei auszuwählen, klicken Sie auf „Dokumentauswahl wiederholen“. Klicken Sie anschließend auf „Weiter“.
- Klicken Sie in den Dokumenten „Abschnitt auswählen“ um einen Abschnitt für diesen Artikel in Ihrem Hilfecenter festzulegen. Klicken Sie „Weiter“. Nach dem Import werden die Artikel nicht veröffentlicht. Für Lite- und Professional-Kunden werden die Dokumente als Entwürfe importiert, für Enterprise-Kunden als Artikel in Bearbeitung.
- Klicken Sie unter „Import starten“ auf „Import starten“. Schließen Sie das Fenster während des Importvorgangs nicht. Die Importdauer hängt von der Anzahl der zum Hochladen ausgewählten Dateien ab.
- Wenn der Import abgeschlossen ist, klicken Sie auf „ Ansehen“ , um zu „Artikel anordnen“ zu gelangen, oder klicken Sie auf „Neuen Import starten“, um weitere Google Docs hinzuzufügen.
Schwachstellen beim CSV-Import
Es gibt drei mögliche Hindernisse beim Übertragen Ihrer Daten zu Zendesk® per Massenimport:- Der Massenimport erlaubt keine Daten, die nicht in der CSV-Datei aufgeführt sind. Um weitere Datensätze zu importieren, müssen Sie die Zendesk® REST-API verwenden.
- Kontaktinformationen von Endnutzern können nicht von Facebook- oder X-Konten importiert werden. Dies ist nur über die Zendesk® REST-API möglich.
- Der Massenimport unterstützt nicht den Import von Tickets. Sie können diese über die REST-API zu Ihrem Zendesk® Support hinzufügen.
Meistern Sie die Kunst der Datenbankmigration
Die Migration von Datensätzen aus der Datenbank zu Zendesk® kann zunächst recht aufwendig erscheinen. Klären Sie zunächst alle Details und entscheiden Sie dann, ob Sie diese Migrationsmethode in Ihr Projekt einbeziehen oder eine Alternative wählen möchten.
Was steckt hinter einer Datenbankmigration?
Grob gesagt, entspricht die Datenbankmigration dem altbekannten CSV-Export von Dateien aus Ihrer aktuellen Software und dem anschließenden Import in Zendesk®. Im Idealfall können Sie CSV- (oder XML-)Dateien aus der Datenbank extrahieren oder eine SQL-Dump-Datei erhalten. In jedem Fall müssen Sie die erhaltene Datei später in ein CSV-Format konvertieren, das den Zendesk®-Anforderungen entspricht.
Aktuell bieten Softwareanbieter integrierte Import- und/oder Exportfunktionen an. Technisch gesehen können Sie also ohne Programmierung oder zusätzliche Unterstützung durch Entwickler oder Techniker eine CSV-Datei aus Ihrer alten Helpdesk-Plattform oder einem anderen Legacy-System exportieren. Voraussetzung dafür ist, dass Ihre Software oder Datenbank diese Option bietet.
Wie man Daten aus einer MySQL-Datenbank exportiert
Wenn Ihr aktuelles System eine MySQL-Datenbank als Speicher verwendet, können Sie den SQL-Dump exportieren. Diese Datei enthält alle Daten Ihres alten Systems. Das ist ein Vorteil. Sie können beliebige Daten aus dieser Datei übertragen. Sie sollten jedoch die Datensätze auswählen, die in Zendesk® importiert werden können: Der Aufwand, gültige CSV-Dateien zu erstellen, ist ein Nachteil.
Wie erstelle ich einen SQL-Dump der MySQL-Datenbank über die Kommandozeile?
Es gibt zwei Möglichkeiten, einen Dump zu erstellen, je nachdem, ob Ihr MySQL-Benutzer ein Passwort hat.
Wenn Ihr MySQL-Benutzer ein Passwort hat, dann
mysqldump -h localhost -u [MySQL-Benutzer, z. B. root] -p [Datenbankpasswort] -c --add-drop-table --add-locks --all --quick --lock-tables [Name der Datenbank] > sqldump.sqlWichtig: Zwischen -p und dem Passwort darf kein Leerzeichen stehen.
Wenn kein Passwort vorhanden ist, dann
Datenbanken verfügen über eine Reihe von Hilfsprogrammen, mit denen Sie die folgenden Informationen finden können: Export-Dienstprogramm. Beachten Sie, dass manche Tools nur bestimmte Datensatztypen extrahieren. Prüfen Sie daher, welche Daten Sie damit abrufen können und ob diese für die Erstellung der CSV-Datei für den Zendesk®-Import ausreichen.mysqldump -h localhost -u [MySQL-Benutzer, z. B. root] -c --add-drop-table --add-locks --all --quick --lock-tables [Name der Datenbank] > sqldump.sql
Datenextraktion mit dem Oracle-Exportprogramm
Betrachten wir das Oracle-Exp-Dienstprogramm als Beispiel. Hier finden Sie eine sechsstufige Exportanleitung für den Einstieg:
- Schritt 1. Erstellen Sie ein Exportverzeichnis auf dem Quellserver.
mkdir /Pfad/Pfad - Schritt 2. Gewähren Sie dem Oracle-Benutzer Zugriff.
chown oracle /Pfad/Pfad - Schritt 3. Erstelle ein Verzeichnis in der Datenbank.
CREATE DIRECTORY Your_Dir_Name as '/path/path' - Schritt 4. Fügen Sie Ihren Oracle-Benutzer der Rolle EXP_FULL_DATABASE hinzu.
Gewähren Sie EXP_FULL_DATABASE an Ihren Benutzer - Schritt 5. Weisen Sie der Rolle das von Ihnen erstellte Verzeichnis in der Datenbank zu.
GRANT READ, WRITE ON DIRECTORY Your_Dir_Name TO EXP_FULL_DATABASE - Schritt 6. Führen Sie den Befehl expdp als Oracle-Benutzer aus.
expdp Ihr_Datenbankbenutzer/Passwort schemas=Ihr_Schemaname tables=Tabellenname directory=Ihr_Verzeichnisname version=Ihre_Version_für_Zieldatenbank dumpfile=data.dmp logfile=data.log
Sie können mit dem EXPDP-Befehl weitere Parameter verwenden. Weitere Informationen Oracle-Datenbank
Unterstützte Datensätze für den Zendesk®-Massenimport
Zendesk® bietet Kunden der Tarife Essential, Team, Professional und Enterprise derzeit die Möglichkeit zum Massenimport. Konkret können Sie Ihre Kontakte, Unternehmen (in Zendesk® auch Organisationen genannt) und Agenten importieren (und gegebenenfalls Einschränkungen festlegen, um einen Agenten einer Gruppe hinzuzufügen). Die Anzahl der über die REST-API verfügbaren erweiterten Importtypen ist jedoch begrenzt. Tickets können ebenfalls nur über die REST-API importiert werden. Die genannten Datensatztypen lassen sich auf zwei Massenimportoptionen verteilen: Organisationen und Benutzer.
Die Organisationsimportfelder
Ihre CSV-Datei für Importierende Organisationen sollte die folgenden Felder enthalten:- Name (Pflichtfeld, steht für den Firmennamen)
- external_id (eine eindeutige Identifikations-ID, die sich vom Firmennamen unterscheidet)
- Notizen (nur Agenten können sie sehen)
- Details (Adresse oder sonstige Informationen)
- Standard (E-Mail-Domäne, eine oder mehrere durch Leerzeichen getrennt)
- gemeinsam genutzt (wahr, wenn die Organisation gemeinsam genutzt wird)
- shared_comments (true, wenn alle Benutzer in der Organisation Kommentare zu den Tickets der anderen hinzufügen können)
- Gruppe (eine Standardgruppe (Agentengruppe) für die Organisation)
- Tags (Diese Option muss vor dem Import in Zendesk® aktiviert sein)
- custom_fields.
(z. B. Feldschlüssel registration_date , Wert festlegen: custom_fields.registration_date )
Die Benutzerimportfelder
Die CSV-Datei für Benutzer importieren In Zendesk® Support können unter anderem die folgenden Felder enthalten sein.- Name (Pflichtfeld, vollständiger Name des Benutzers)
- E-Mail (Pflichtfeld, E-Mail-Adresse des Benutzers. Sie können eine primäre und eine sekundäre E-Mail-Adresse hinzufügen. Weisen Sie den E-Mail-Adressen des Benutzers dieselbe externe ID zu.)
- external_id (Benutzer-ID, die sich von der E-Mail-Adresse des Benutzers unterscheidet)
- Details (Erweiterte Informationen über den Benutzer. Nur Agenten können diese einsehen)
- Notizen (nur Agenten können sie sehen)
- Telefon (Hier werden die Telefonnummern des Benutzers importiert. Sie können primäre und sekundäre Telefonnummern für einen einzelnen Benutzer hinzufügen. Weisen Sie den Telefonnummern dieselbe externe ID zu.)
- shared_phone_number (Wenn dieser Wert „true“ lautet, handelt es sich um eine gemeinsam genutzte Telefonnummer.)
- Rolle (Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Sie können „Endbenutzer“, „Agent“ oder „Administrator“ eingeben. Wenn das Feld leer ist, wird der Benutzer auf „Endbenutzer“ festgelegt.)
- Beschränkung (Ein Pflichtfeld, wenn der Benutzer ein Agent ist. Es legt die Berechtigungen usw. fest. Folgende Werte sind hinzuzufügen:)
- „Zugewiesen“ bedeutet, dass diesem Agenten Tickets zugewiesen wurden.
- „Gruppen“ bedeutet die Tickets in den Gruppen dieses Agenten.
- „Keine“ bedeutet, dass es keine Einschränkungen gibt und der Agent auf alle Tickets zugreifen kann.
- Organisation bedeutet die von Benutzern in der Organisation dieses Agenten angeforderten Tickets.
- „angefordert“ bedeutet, dass der Agent der Anforderer ist und es sich um seine Tickets handelt.
- Light Agent bedeutet, dass ein Benutzer die gleichen Einschränkungen wie ein Light Agent hat.
- Organisation (Fügen Sie die Organisation hinzu, in die der Benutzer importiert werden soll. Wenn Sie Kunde eines Professional- oder Enterprise-Tarifs sind, können Sie einen Benutzer mehreren Organisationen hinzufügen. Die Struktur sollte folgendermaßen aussehen:
Organisation1|Organisation2|Organisation3. - Tags (verwenden Sie ein Leerzeichen, um die einzelnen Tags zu trennen)
- Marke (Wenn Sie mehrere Marken haben, können Sie eine Subdomain angeben (verwenden Sie meineDomain und nicht meineDomain.zendesk.com).
- custom_fields.
(z. B. Feldschlüssel registration_date , Wert festlegen: custom_fields.registration_date )
Zendesk® Leitfaden zum Massenimport
Zu Import Diese CSV-Dateien folgen der Anweisung:- Gehen Sie zum Zahnradsymbol für Administratoren „Personen“.
- Wählen Sie den Typ der CSV-Datei aus, die Sie importieren möchten:
- Wählen Sie den gewünschten Importtyp aus:
- Massenimport von Organisationen.
- Massenimport von Benutzern.
- Wählen Sie die gewünschte Option aus:
- Importtyp: Neue Organisationen erstellen
- Importtyp: Neue Benutzer erstellen
- Klicken Sie auf „Datei auswählen“ oder auf den Link „Daten stattdessen einfügen“.
- Klicken Sie auf Importieren.
Die Wissensdatenbank zu Zendesk® übertragen
Die Migration der Wissensdatenbank ist über den Google Docs Importer in Zendesk® Guide möglich. Kunden der Tarife Lite, Professional und Enterprise können ihre Artikel aus Google Docs in Entwürfe (Lite und Professional) bzw. in Artikel im Bearbeitungsmodus (Enterprise) in Zendesk® Guide übertragen.
Der Google Docs Importer funktioniert über eine API. Wenn das Limit von 10 Anfragen pro Minute überschritten wird, erhalten Sie eine Fehlermeldung. Sie können bis zu 100 Dateien gleichzeitig importieren.
Es sind mehrere Schritte zu unternehmen:
- Gehen Sie zu „Inhalte anordnen“ > „Artikel importieren“.
- Klicken Sie auf „Verbinden“ , um sich in Ihrem Google-Konto anzumelden und Zendesk® Guide den Zugriff zu gewähren. Klicken Sie anschließend auf „ Weiter“.
- Klicken Sie unter „Dokumente auswählen“ „Dateiauswahl öffnen“ und wählen Sie die zu importierenden Dateien aus. Klicken Sie anschließend auf „Auswählen“.
- Klicken Sie in „Dokumente platzieren“ „Abschnitt auswählen“ , um einen Abschnitt für diesen Artikel in Ihrem Hilfecenter zu definieren. Klicken Sie auf „ Weiter“.
- Klicken Sie auf „Import starten“ und schließen Sie das Fenster während des Importvorgangs nicht. Je mehr Dateien Sie ausgewählt haben, desto länger dauert der Importvorgang.
- Wenn der Import abgeschlossen ist, klicken Sie auf „ Ansehen“ , um zu „Artikel anordnen“ zu gelangen, oder klicken Sie auf „Neuen Import starten“, um weitere Google Docs hinzuzufügen.
API-Datenmigration? Ganz einfach, wenn man es clever angeht
Fast jeder Unternehmer kennt den Ratschlag: „Nutzen Sie einfach die API, um Daten in Zendesk® zu importieren.“ und fragt sich dann: „Was ist überhaupt eine API?“ Wer danach gegoogelt hat, findet unzählige Ergebnisse mit Akronymen, Fachjargon und wenig hilfreichen Erklärungen. Das alles vermittelt ein eher vages oder gar falsches Bild davon, was dieser Begriff eigentlich bedeutet.
Was ist eine API?
API steht für Application Programming Interface (Anwendungsprogrammierschnittstelle). Der Begriff ist sehr vieldeutig und kann je nach Kontext Verschiedenes bedeuten. Eine allgemeine Erklärung findet sich in Wikipedia:
In der Computerprogrammierung ist eine Anwendungsprogrammierschnittstelle (API) eine Sammlung von Unterprogrammdefinitionen, Protokollen und Werkzeugen zur Entwicklung von Anwendungssoftware. Allgemein gesprochen handelt es sich um klar definierte Kommunikationsmethoden zwischen verschiedenen Softwarekomponenten.
Technisch gesehen beschreiben APIs die Regeln, die Entwickler bei der Interaktion mit einer Programmiersprache, einer Softwarebibliothek oder einem anderen Softwaretool befolgen müssen. Der Begriff wird jedoch häufig auch zur Beschreibung einer bestimmten Art von Webschnittstelle verwendet.
Web-APIs stellen eine Reihe von Regeln für die Interaktion mit einem Webserver (z. B. einem Zendesk®-Server) dar, üblicherweise zum Abrufen von Daten. APIs bieten Mechanismen, um auf die vom API-Anbieter (hier Zendesk®) gespeicherten Daten zuzugreifen und diese zu bearbeiten. Der Prozess sieht folgendermaßen aus:
- Sie senden eine „Anfrage“ an einen Zendesk®-Webserver.
- Anschließend greift es auf eine Zendesk®-Datenbank (mit Ihren Daten) zu.
- Anschließend sendet der Webserver Ihnen die Daten in einer „Antwort“ zurück
Warum nutzen Unternehmen die API?
Der Mehrwert der API liegt in den erweiterten Funktionen, die in der Benutzeroberfläche (weder nativ noch gemäß Ihrem Zendesk®-Plan) verfügbar sind. Daher erweist sich die API als Ressource für die App-Erstellung, den Massenimport, das Abrufen von Daten aus externen Quellen und vieles mehr.
Die Zendesk®-API ist Bestandteil eines Servicepakets für Unternehmen. Organisationen nutzen Zendesk®-Dienste und profitieren von der zusätzlichen API. Diese ermöglicht es ihnen, eigene Integrationen zu entwickeln oder Anwendungen zu erstellen.
Aktuell können Zendesk®-Kunden der Tarife Essential und Team ihre Daten per API direkt exportieren, während Kunden des Professional-Tarifs den Datenexport sogar automatisieren können. Ebenso können Sie mit der API Tickets, Benutzerdaten oder beliebige andere Datentypen für Berichtszwecke abrufen. Die API bietet unter anderem folgende Funktionen:
- Aktualisierung mehrerer Datensätze
- Tickets erstellen
- Ticketdaten aus dem alten Helpdesk (oder der Datenbank) migrieren
- Massenbearbeitung von Benutzern
- Datensatzsuche
Weitere Informationen zu Aufgaben, die mit einer API gelöst werden können, finden Sie in diesem Beitrag auf Zendesk® Develop.
Überblick über das Format
Moderne APIs bevorzugen das JSON-Format, und auch die Zendesk®-API liefert Daten in diesem Format. Wenn Sie Informationen an die API senden möchten, um Daten in Ihrem Zendesk®-Konto zu erstellen oder zu aktualisieren, müssen Sie diese zunächst in JSON konvertieren. Wenn Sie Daten von Zendesk® abrufen möchten, erhalten Sie diese ebenfalls im JSON-Format. Daher müssen Sie sie in ein verwendbares Format konvertieren. Weitere Informationen zu Zendesk® JSON finden Sie hier: Hier.Die formatierten Daten können Sie in Ihrem Webbrowser anzeigen, nachdem Sie eine JSON-Viewer-Erweiterung für Chrome oder Firefox . JSON sieht folgendermaßen aus:
{ "posts": [ { "id": 36467, "title": "Wie öffne ich den Safe?" }, { "id": 36468, "title": "Wie setze ich die Kombination zurück?" }, ] }
Der Zendesk®-Endpunkt bietet folgende Ansicht:
subdomain.zendesk.com/api/v2/users/me.json
Lassen Sie uns die Aktionen auflisten, die Endpunkte ausführen können:
| Aktion | Beschreibung |
|---|---|
| ERHALTEN | Elemente abrufen |
| POST | Erstelle Elemente, die nicht existierten |
| SETZEN | Vorhandene Elemente aktualisieren |
| LÖSCHEN | Gegenstände entfernen |
Im Browser können Sie nur GET-Anfragen stellen. Andere Aktionen lassen sich mit Tools wie cURL oder der API-Konsole im Zendesk® Developer Portal durchführen.
Ein paar Worte zu cURL. Es handelt sich um ein Kommandozeilen-Tool, mit dem Sie API-Befehle ohne Browser testen können. Sie können cURL für die vier oben genannten Aufruftypen verwenden. Weitere Informationen finden Sie unter „cURL installieren und verwenden“ .
Jede API-Anfrage erhält eine Antwort, die darüber informiert, ob sie erfolgreich war oder nicht. Diese Antworten werden als Statuscodes und geben Aufschluss darüber, warum die Anfrage fehlgeschlagen ist. Die grundlegenden Anfragen sind:
| Statuscode | Beschreibung |
|---|---|
| 200 | Die Anfrage war erfolgreich |
| 400 | Die Anfrage war nicht erfolgreich |
| 409 | Fehler beim Zusammenführen oder bei den Einschränkungen, bitte versuchen Sie es erneut |
| 422 | Nicht verarbeitbare Entität |
| 429 | Das Datenratenlimit wurde überschritten |
| 500 | Warnung oder vorübergehender Status, wenden Sie sich an den Support, falls das Problem weiterhin besteht |
Weitere Informationen zur Zendesk® Support API finden Sie auf Zendesk® Entwicklerseite.
Ist diese Migrationsmethode für Sie geeignet?
Im Allgemeinen ermöglicht diese Datenimportoption die Übertragung von Kontakten, Unternehmen, Agenten und Agentengruppen, Tickets und vielen weiteren Datensatztypen (über die Support-API) sowie der Wissensdatenbank (über die Help-Center-API ). Allerdings ist die Umsetzung nicht ganz so einfach. Um den vollen Nutzen dieser Methode auszuschöpfen, benötigen Sie ein IT-Team mit Erfahrung im Umgang mit APIs oder können einen freiberuflichen Entwickler mit der Erstellung des Migrationscodes beauftragen.
Zunächst sollten Sie die zu erwartenden Kosten und den Zeitraum einkalkulieren, in dem Ihr IT-Team den Zendesk®-Datenimport anstelle seiner eigentlichen Aufgaben übernehmen wird. Ebenso wird der beauftragte Entwickler Ihr Budget erhöhen und die Projektdauer verlängern. Außerdem sollten Sie sich darauf einstellen, dass Sie die Fristen möglicherweise nicht einhalten können.
Der API-basierte Migrationsplan zu Zendesk® wird von dem Team erstellt, das den Code schreibt. Er beinhaltet jedoch mindestens folgende Schritte:
- Vergleichen Sie die aktuelle Helpdesk-Plattform und die Zendesk®-APIs, um die für den Wechsel verfügbaren Daten zu definieren
- Erarbeiten Sie die Feldzuordnung für die korrekte Platzierung in Zendesk®
- Entwickle einen Migrationscode und teste ihn
Vor- und Nachteile eines Importtools von Drittanbietern
Bevor Sie voreilige Schlüsse ziehen, betrachten Sie die von Helpdesk-Plattformen und anderen Unternehmen angebotenen APIs aus einer anderen Perspektive. Sie werben mit einer „benutzerfreundlichen API“ und versprechen, dass Sie damit die vom Helpdesk erfassten Daten abrufen, importieren und verarbeiten können. Viele dieser APIs sind jedoch alles andere als benutzerfreundlich, und selbst erfahrene Softwareentwickler haben Schwierigkeiten, sie zu nutzen. Dieses Problem liegt an mangelnden Programmierkenntnissen und/oder bürokratischen Hürden im Unternehmen. Dadurch sind diese APIs außerhalb der Abteilung, die sie entwickelt hat, praktisch unbrauchbar.
Um diesen Engpass beim Zendesk®-Import zu beheben, können Sie einen Drittanbieterdienst nutzen, der Daten zwischen Helpdesk-Plattformen importiert. Die Vor- und Nachteile sind folgende:
| + | Das hauseigene IT-Team wird nicht von seinen Aufgaben abgelenkt (falls Sie über ein solches Team verfügen) |
| + | Es ist nicht nötig, mit einem freiberuflichen Entwickler zusammenzuarbeiten |
| + | Die Organisationsdaten sind gesichert (in der Regel bieten diese Dienste Datenverschlüsselung an) |
| + | Zeit gespart und eine klare Frist |
| - | Die Kosten sollten besprochen werden |
| - | Die aktuelle Plattform verfügt möglicherweise über keine oder nur eingeschränkte APIs, sodass für einige Daten ein CSV-Import erforderlich sein kann |
Zusammenfassend lässt sich sagen, dass die API-Migration zu Zendesk® zwar eine erweiterte Liste von Datensätzen importieren kann, aber eine gründliche Vorbereitung erfordert, um korrekt durchgeführt zu werden.
Die Zusammenfassung
Den meisten Unternehmen ist mittlerweile klar geworden, dass eine Zendesk®-Migration mehr umfasst als nur das Übertragen von Daten von der alten Plattform (oder Tabellenkalkulationen). Die Planung des Importprozesses nimmt mehr Zeit in Anspruch als die Migration selbst. Vorbei sind die Zeiten, in denen der Import von Tickets, Kontakten und anderen Datensätzen in ein neues System Wochen dauerte. Heute ist dies innerhalb weniger Stunden möglich. Allerdings gibt es Faktoren wie Datenvolumen, Beschränkungen des Migrationsdienstes oder der API, die den Zeitrahmen und das Budget beeinflussen können.