Importeren vanuit Zendesk

Shayan TaslimBijgewerkt:

Gebruik de Zendesk-importeur om berichten, opmerkingen, upvotes en volgers vanuit een Zendesk-communityforum (Zendesk Gather) te migreren naar UserJot-borden.

Note

Met deze importeur migreer je Zendesk-communityforums, geen Zendesk Support-tickets of artikelen uit de Help Center-kennisbank. Gebruik Een bestaand helpcenter importeren om artikelen uit Zendesk Help Center te migreren.

Beschikbaar voor workspacebeheerders en -eigenaren met elk abonnement, ook met Free.

Een vertrouwelijke OAuth-client aanmaken in Zendesk

UserJot maakt verbinding met Zendesk via een OAuth client_credentials-grant (er is geen omleidings-URI nodig).

  1. Open Zendesk Admin Center → Apps en integraties → API's → OAuth-clients.

  2. Maak een vertrouwelijke OAuth-client aan en geef deze de scopes hc:read en users:read. Met deze scopes kan UserJot communityonderwerpen, berichten, opmerkingen, stemmen, abonnementen en e-mailadressen van leden lezen, zonder toegang tot Support-tickets.

  3. Kopieer de Client-ID en het Clientgeheim.

UserJot bewaart je Zendesk-inloggegevens niet permanent. Ze worden alleen versleuteld zolang de importtaak op de achtergrond wordt uitgevoerd en worden direct daarna verwijderd.

De import uitvoeren

  1. Open in UserJot Instellingen → Gegevens & import en klik op Importeren vanuit Zendesk.

  2. Voer je Zendesk-subdomein in (het .zendesk.com-subdomein, zoals acme.zendesk.com; aangepaste domeinen die naar je host verwijzen, zoals support.acme.com, worden niet geaccepteerd), evenals de Client-ID en het Clientgeheim. Klik vervolgens op Doorgaan.

  3. Koppel bij Onderwerpen kiezen elk Zendesk-onderwerp aan een UserJot-bord, of stel het onderwerp in op Niet importeren. Onderwerpen met dezelfde naam als een bestaand UserJot-bord (hoofdletterongevoelig) worden automatisch vooraf geselecteerd. Koppel minstens één onderwerp en klik op Doorgaan.

  4. Controleer Klaar om te importeren (de import duurt doorgaans ongeveer 15 minuten) en klik op Import starten.

UserJot voert de import op de achtergrond uit en stuurt de beheerder die de import heeft gestart na afloop een e-mail (onderwerp: Your Zendesk import is done). Je kunt een import veilig opnieuw uitvoeren: eerder geïmporteerde berichten, opmerkingen, stemmen en volgers worden ontdubbeld op basis van hun Zendesk-ID's.

Wat wordt geïmporteerd en wat wordt overgeslagen?

Zendesk-gegevens

Gedrag in UserJot

Berichten

Geïmporteerd als openbare verzoeken met titel, inhoud (HTML omgezet naar platte tekst, maximaal 20.000 tekens), oorspronkelijke aanmaakdatum, status en totaal aantal upvotes.

Statussen

none → In behandeling, planned → Gepland, completed → Voltooid, not_planned en answered → Gesloten.

Opmerkingen

Als losse opmerkingen bij hun berichten geïmporteerd (maximaal 10.000 tekens), met aanmaakdatum en aantal upvotes. Lege opmerkingen zonder tekst of afbeeldingen worden overgeslagen.

Afbeeldingen

Externe HTTPS-afbeeldingen worden gekopieerd en bijgevoegd. Afbeeldingen die door Zendesk worden gehost, zoals /hc/, blijven als links in de berichttekst staan, omdat Zendesk downloads vanaf servers blokkeert.

Stemmen

Upvotes worden geïmporteerd; downvotes worden overgeslagen. Voor gebruikers met een e-mailadres of externe ID worden afzonderlijke stemmers aangemaakt (verwijderde Zendesk-stemmers tellen nog wel mee voor het totaal van het bericht).

Volgers

Geïmporteerd als abonnees van verzoeken, met de oorspronkelijke volgdatum, als de gebruiker een e-mailadres of externe ID heeft.

Niet geïmporteerd

Support-tickets, Help Center-artikelen, inhoudstags, downvotes, niet-gekoppelde onderwerpen en wijzigingslogboeken.

Problemen oplossen

  • "We konden geen Zendesk-account vinden." Voer je .zendesk.com-subdomein in, niet een aangepast domein.

  • "Zendesk heeft deze ID en dit geheim niet geaccepteerd." Controleer of de OAuth-client in Zendesk is ingesteld op Vertrouwelijk en niet op Openbaar.

  • "Deze OAuth-client heeft geen toegang tot het forum." Controleer of zowel de scopes hc:read als users:read zijn ingeschakeld voor de client.

  • Limieten voor aanvragen. Het laden van onderwerpen is beperkt tot 10 aanvragen per uur. Een import starten is beperkt tot 3 keer per uur en 5 keer per dag.

Volgende stappen

Heeft dit je vraag beantwoord?