Import aus Zendesk

Shayan TaslimAktualisiert

Verwende den Zendesk-Importer, um Beiträge, Kommentare, Upvotes und Follower aus einem Zendesk-Community-Forum (Zendesk Gather) in UserJot-Boards zu migrieren.

Note

Dieser Importer migriert Zendesk-Community-Foren, keine Zendesk-Support-Tickets oder Wissensdatenbankartikel aus dem Help Center. Um Artikel aus dem Zendesk Help Center zu migrieren, verwende Ein bestehendes Help Center importieren.

Für Workspace-Admins und -Inhaber in allen Tarifen verfügbar, einschließlich Free.

Einen vertraulichen OAuth-Client in Zendesk erstellen

UserJot verbindet sich über einen OAuth-client_credentials-Grant mit Zendesk (eine Redirect-URI ist nicht erforderlich).

  1. Öffne das Zendesk Admin Center → Apps und Integrationen → APIs → OAuth-Clients.

  2. Erstelle einen vertraulichen OAuth-Client und erteile ihm die Berechtigungsbereiche hc:read und users:read. Damit kann UserJot Community-Themen, Beiträge, Kommentare, Stimmen, Abonnements und E-Mail-Adressen von Mitgliedern lesen, ohne auf Support-Tickets zuzugreifen.

  3. Kopiere die Client-ID und das Client-Secret.

UserJot speichert deine Zendesk-Zugangsdaten nicht dauerhaft. Sie werden nur während der Ausführung des Importauftrags im Hintergrund verschlüsselt und unmittelbar danach gelöscht.

Import ausführen

  1. Öffne in UserJot Einstellungen → Daten & Import und klicke auf Aus Zendesk importieren.

  2. Gib deine Zendesk-Subdomain ein (die .zendesk.com-Subdomain, zum Beispiel acme.zendesk.com; benutzerdefinierte Domains wie support.acme.com werden nicht akzeptiert), dazu die Client-ID und das Client-Secret, und klicke dann auf Weiter.

  3. Ordne unter Themen auswählen jedes Zendesk-Thema einem UserJot-Board zu oder lege für ein Thema Nicht importieren fest. Themen, deren Namen (ohne Beachtung der Groß- und Kleinschreibung) mit einem vorhandenen UserJot-Board übereinstimmen, werden automatisch vorausgewählt. Ordne mindestens ein Thema zu und klicke auf Weiter.

  4. Überprüfe Bereit zum Importieren (die Ausführung dauert normalerweise etwa 15 Minuten) und klicke auf Import starten.

UserJot führt den Import im Hintergrund aus und sendet nach Abschluss eine E-Mail an den Admin, der ihn gestartet hat (Betreff: Your Zendesk import is done). Ein erneuter Import ist unbedenklich, da bereits importierte Beiträge, Kommentare, Stimmen und Follower anhand ihrer Zendesk-IDs dedupliziert werden.

Was importiert und was übersprungen wird

Zendesk-Daten

Verhalten in UserJot

Beiträge

Werden als öffentliche Anfragen importiert – mit Titel, Text (HTML wird in Klartext umgewandelt, maximal 20.000 Zeichen), ursprünglichem Erstellungsdatum, Status und Anzahl der Upvotes.

Status

none → Ausstehend, planned → Geplant, completed → Abgeschlossen, not_planned und answered → Geschlossen.

Kommentare

Werden direkt den jeweiligen Beiträgen zugeordnet (maximal 10.000 Zeichen), zusammen mit dem Erstellungsdatum und der Anzahl der Upvotes. Leere Kommentare ohne Text oder Bilder werden übersprungen.

Bilder

Externe HTTPS-Bilder werden kopiert und angehängt. Auf Zendesk gehostete /hc/-Bilder bleiben als Links im Beitragstext erhalten, da Zendesk serverseitige Downloads blockiert.

Stimmen

Upvotes werden importiert, Downvotes übersprungen. Für Nutzer mit E-Mail-Adresse oder externer ID werden einzelne Abstimmungsdatensätze angelegt (auch gelöschte Zendesk-Nutzer zählen weiterhin für die Gesamtzahl der Stimmen eines Beitrags).

Follower

Werden als Abonnenten der Anfrage importiert und behalten ihr ursprüngliches Folgedatum, sofern der Nutzer eine E-Mail-Adresse oder externe ID hat.

Nicht importiert

Support-Tickets, Help-Center-Artikel, Inhalts-Tags, Downvotes, nicht zugeordnete Themen und Änderungsprotokolle.

Fehlerbehebung

  • „Wir konnten kein Zendesk-Konto finden.“ Gib deine .zendesk.com-Subdomain statt einer benutzerdefinierten Domain ein.

  • „Zendesk hat diese ID und dieses Secret nicht akzeptiert.“ Vergewissere dich, dass der OAuth-Client in Zendesk auf Vertraulich und nicht auf „Öffentlich“ eingestellt ist.

  • „Dieser OAuth-Client kann das Forum nicht lesen.“ Vergewissere dich, dass für den Client sowohl die Berechtigungsbereiche hc:read als auch users:read aktiviert sind.

  • Ratenbegrenzungen. Das Laden von Themen ist auf 10 Anfragen pro Stunde begrenzt. Ein Import kann höchstens 3-mal pro Stunde und 5-mal pro Tag gestartet werden.

Nächste Schritte

Hat das Ihre Frage beantwortet?