Importa da Zendesk

Shayan TaslimAggiornato

Usa lo strumento di importazione Zendesk per migrare post, commenti, voti positivi e follower da un forum della community Zendesk (Zendesk Gather) alle bacheche di UserJot.

Note

Questo strumento importa i forum della community Zendesk, non i ticket Zendesk Support né gli articoli della knowledge base dell’Help Center. Per migrare gli articoli di Zendesk Help Center, usa Importa un centro assistenza esistente.

Disponibile per gli amministratori e i proprietari degli spazi di lavoro con qualsiasi piano, incluso Free.

Crea un client OAuth riservato in Zendesk

UserJot si connette a Zendesk con una concessione OAuth client_credentials (non è necessario un URI di reindirizzamento).

  1. Apri Zendesk Admin Center → App e integrazioni → API → Client OAuth.

  2. Crea un client OAuth riservato e assegnagli gli ambiti hc:read e users:read. Questi ambiti consentono a UserJot di leggere argomenti, post, commenti, voti, iscrizioni ed e-mail dei membri della community senza accedere ai ticket di Support.

  3. Copia l’identificativo client e il segreto client.

UserJot non conserva in modo permanente le credenziali Zendesk. Vengono crittografate solo durante l’esecuzione del processo di importazione in background e cancellate subito dopo.

Esegui l’importazione

  1. In UserJot, apri Impostazioni → Dati e importazione e fai clic su Importa da Zendesk.

  2. Inserisci il sottodominio Zendesk (il sottodominio .zendesk.com, ad esempio acme.zendesk.com; i domini personalizzati associati a un host, come support.acme.com, non sono accettati), l’identificativo client e il segreto client, quindi fai clic su Continua.

  3. Nella schermata Scegli gli argomenti, associa ogni argomento Zendesk a una bacheca UserJot oppure imposta Non importare per l’argomento. Gli argomenti i cui nomi corrispondono a una bacheca UserJot esistente (senza distinzione tra maiuscole e minuscole) vengono preselezionati automaticamente. Associa almeno un argomento e fai clic su Continua.

  4. Controlla la schermata Tutto pronto per l’importazione (l’esecuzione dura in genere circa 15 minuti) e fai clic su Avvia importazione.

UserJot esegue l’importazione in background e, al termine, invia un’e-mail all’amministratore che l’ha avviata (oggetto: Your Zendesk import is done). È possibile ripetere l’importazione senza rischi, perché i post, i commenti, i voti e i follower già importati vengono deduplicati in base ai rispettivi ID Zendesk.

Cosa viene importato e cosa viene ignorato

Dati Zendesk

Comportamento in UserJot

Post

Importati come richieste pubbliche con titolo, corpo (HTML convertito in testo semplice, fino a 20.000 caratteri), data di creazione originale, stato e totale dei voti positivi.

Stati

none → In attesa, planned → Pianificata, completed → Completata, not_planned e answered → Chiusa.

Commenti

Importati direttamente nei post (fino a 10.000 caratteri), con data di creazione e numero di voti positivi. I commenti vuoti, senza testo o immagini, vengono ignorati.

Immagini

Le immagini HTTPS esterne vengono copiate e allegate. Le immagini /hc/ ospitate su Zendesk rimangono come link nel testo del corpo, perché Zendesk blocca i download lato server.

Voti

I voti positivi vengono importati; quelli negativi vengono ignorati. Vengono create righe individuali per gli utenti con un indirizzo e-mail o un ID esterno (i votanti Zendesk eliminati continuano a essere conteggiati nel totale del post).

Follower

Importati come iscritti alle richieste, con la data originale in cui hanno iniziato a seguirle, se l’utente ha un indirizzo e-mail o un ID esterno.

Elementi non importati

Ticket di Support, articoli dell’Help Center, tag dei contenuti, voti negativi, argomenti non associati e registri delle modifiche.

Risoluzione dei problemi

  • «Non è stato possibile trovare un account Zendesk.» Inserisci il sottodominio .zendesk.com anziché un dominio personalizzato.

  • «Zendesk non ha accettato l’identificativo e il segreto.» Verifica che il client OAuth in Zendesk sia impostato su Riservato, non su Pubblico.

  • «Questo client OAuth non può leggere il forum.» Verifica che sul client siano abilitati entrambi gli ambiti hc:read e users:read.

  • Limiti di frequenza. Il caricamento degli argomenti è limitato a 10 richieste all’ora; l’avvio di un’importazione è limitato a 3 richieste all’ora e 5 al giorno.

Passaggi successivi

Ha risposto alla tua domanda?