Import z Zendesk

Shayan TaslimZaktualizowano

Użyj narzędzia do importowania z Zendesk, aby przenieść wpisy, komentarze, głosy poparcia i obserwujących z forum społeczności Zendesk (Zendesk Gather) do tablic UserJot.

Note

To narzędzie importuje fora społeczności Zendesk, a nie zgłoszenia Zendesk Support ani artykuły z bazy wiedzy Centrum pomocy Zendesk. Aby przenieść artykuły z Centrum pomocy Zendesk, użyj opcji Importuj istniejące centrum pomocy.

Dostępne dla administratorów i właścicieli obszaru roboczego we wszystkich planach, w tym w planie Free.

Utwórz poufnego klienta OAuth w Zendesk

UserJot łączy się z Zendesk za pomocą mechanizmu OAuth client_credentials (adres URI przekierowania nie jest potrzebny).

  1. Otwórz Centrum administracyjne Zendesk → Aplikacje i integracje → Interfejsy API → Klienci OAuth.

  2. Utwórz poufnego klienta OAuth i przyznaj mu zakresy hc:read i users:read. Dzięki tym zakresom UserJot może odczytywać tematy społeczności, wpisy, komentarze, głosy, subskrypcje i adresy e-mail członków bez dostępu do zgłoszeń w Support.

  3. Skopiuj Identyfikator klienta i Klucz tajny klienta.

UserJot nie przechowuje na stałe Twoich danych logowania do Zendesk. Są one szyfrowane tylko na czas działania zadania importowania w tle i natychmiast usuwane po jego zakończeniu.

Uruchom import

  1. W UserJot otwórz Ustawienia → Dane i import, a następnie kliknij Importuj z Zendesk.

  2. Wpisz subdomenę Zendesk (subdomenę .zendesk.com, na przykład acme.zendesk.com; niestandardowe domeny kierujące na Twoją instancję, takie jak support.acme.com, nie są obsługiwane), Identyfikator klienta i Klucz tajny klienta, a następnie kliknij Kontynuuj.

  3. Na ekranie Wybierz tematy przypisz każdy temat Zendesk do tablicy UserJot albo pozostaw dla niego opcję Nie importuj. Tematy, których nazwy pasują do nazw istniejących tablic UserJot (bez uwzględniania wielkości liter), są automatycznie wstępnie zaznaczane. Przypisz co najmniej jeden temat i kliknij Kontynuuj.

  4. Sprawdź ekran Gotowe do importu (import trwa zazwyczaj około 15 minut), a następnie kliknij Rozpocznij import.

UserJot przeprowadza import w tle i po jego zakończeniu wysyła wiadomość e-mail do administratora, który go uruchomił (temat: Your Zendesk import is done). Ponowne uruchomienie importu jest bezpieczne, ponieważ wcześniej zaimportowane wpisy, komentarze, głosy i obserwujący są deduplikowani na podstawie identyfikatorów Zendesk.

Co jest importowane, a co pomijane

Dane Zendesk

Działanie w UserJot

Wpisy

Importowane jako publiczne zgłoszenia z tytułem, treścią (HTML jest konwertowany na zwykły tekst; maks. 20 000 znaków), pierwotną datą utworzenia, statusem i łączną liczbą głosów poparcia.

Statusy

none → Oczekujące, planned → Zaplanowane, completed → Ukończone, not_planned i answered → Zamknięte.

Komentarze

Importowane bezpośrednio w zgłoszeniach (maks. 10 000 znaków) wraz z datą utworzenia i liczbą głosów poparcia. Puste komentarze, które nie zawierają tekstu ani obrazów, są pomijane.

Obrazy

Obrazy zewnętrzne HTTPS są kopiowane i dołączane. Obrazy /hc/ hostowane przez Zendesk pozostają linkami w treści, ponieważ Zendesk blokuje pobieranie po stronie serwera.

Głosy

Głosy poparcia są importowane, a głosy sprzeciwu pomijane. Dla użytkowników z adresem e-mail lub zewnętrznym identyfikatorem tworzone są osobne wpisy głosujących (głosy usuniętych użytkowników Zendesk nadal są uwzględniane w łącznej liczbie głosów przy wpisie).

Obserwujący

Importowani jako subskrybenci zgłoszeń z pierwotną datą rozpoczęcia obserwowania, jeśli użytkownik ma adres e-mail lub zewnętrzny identyfikator.

Nie są importowane

Zgłoszenia do Support, artykuły z Centrum pomocy, tagi treści, głosy sprzeciwu, nieprzypisane tematy i dzienniki zmian.

Rozwiązywanie problemów

  • „Nie udało się znaleźć konta Zendesk”. Wpisz subdomenę .zendesk.com, a nie niestandardową domenę.

  • „Zendesk nie zaakceptował tego identyfikatora i klucza tajnego”. Sprawdź, czy klient OAuth w Zendesk jest ustawiony jako Poufny, a nie Publiczny.

  • „Ten klient OAuth nie może odczytać forum”. Sprawdź, czy dla klienta włączono oba zakresy: hc:read i users:read.

  • Limity zapytań. Pobieranie tematów jest ograniczone do 10 zapytań na godzinę, a uruchamianie importu — do 3 razy na godzinę i 5 razy dziennie.

Następne kroki

Czy ten artykuł odpowiedział na Twoje pytanie?