Importer depuis Zendesk

Shayan TaslimMis à jour

Utilisez l’outil d’importation Zendesk pour migrer les publications, commentaires, votes positifs et abonnés d’un forum communautaire Zendesk (Zendesk Gather) vers les tableaux UserJot.

Note

Cet outil permet de migrer les forums communautaires Zendesk, mais pas les tickets Zendesk Support ni les articles de la base de connaissances du centre d’aide Zendesk. Pour migrer les articles du centre d’aide Zendesk, utilisez Importer un centre d’aide existant.

Disponible pour les administrateurs et propriétaires de l’espace de travail avec tous les forfaits, y compris le forfait Gratuit.

Créer un client OAuth confidentiel dans Zendesk

UserJot se connecte à Zendesk avec une autorisation OAuth client_credentials (aucun URI de redirection n’est nécessaire).

  1. Ouvrez Zendesk Admin Center → Applications et intégrations → API → Clients OAuth.

  2. Créez un client OAuth confidentiel et accordez-lui les autorisations hc:read et users:read. Ces autorisations permettent à UserJot de consulter les sujets de la communauté, les publications, les commentaires, les votes, les abonnements et les adresses e-mail des membres, sans accéder aux tickets Support.

  3. Copiez l’identifiant client et le secret client.

UserJot ne conserve pas vos identifiants Zendesk. Ils sont chiffrés uniquement pendant l’exécution de la tâche d’importation en arrière-plan, puis supprimés immédiatement après.

Lancer l’importation

  1. Dans UserJot, ouvrez Paramètres → Données & importation, puis cliquez sur Importer depuis Zendesk.

  2. Saisissez le sous-domaine Zendesk (le sous-domaine .zendesk.com, par exemple acme.zendesk.com ; les domaines personnalisés associés à un hôte, comme support.acme.com, ne sont pas acceptés), l’identifiant client et le secret client, puis cliquez sur Continuer.

  3. Dans Choisir les sujets, associez chaque sujet Zendesk à un tableau UserJot, ou sélectionnez Ne pas importer pour le laisser de côté. Les sujets dont le nom correspond à celui d’un tableau UserJot existant (sans distinction entre majuscules et minuscules) sont présélectionnés automatiquement. Associez au moins un sujet, puis cliquez sur Continuer.

  4. Consultez l’écran Prêt à importer (l’importation prend généralement environ 15 minutes), puis cliquez sur Lancer l’importation.

UserJot effectue l’importation en arrière-plan et envoie un e-mail à l’administrateur qui l’a lancée une fois celle-ci terminée (objet : Your Zendesk import is done). Vous pouvez relancer une importation sans risque : les publications, commentaires, votes et abonnés déjà importés sont dédupliqués à l’aide de leurs identifiants Zendesk.

Éléments importés et ignorés

Données Zendesk

Comportement dans UserJot

Publications

Importées comme demandes publiques avec leur titre, leur contenu (HTML converti en texte brut, jusqu’à 20 000 caractères), leur date de création d’origine, leur statut et leur nombre total de votes positifs.

Statuts

none → En attente, planned → Planifié, completed → Terminé, not_planned et answered → Fermé.

Commentaires

Importés à plat dans leurs publications (jusqu’à 10 000 caractères), avec leur date de création et leur nombre de votes positifs. Les commentaires vides, sans texte ni images, sont ignorés.

Images

Les images HTTPS externes sont copiées et jointes. Les images /hc/ hébergées par Zendesk restent sous forme de liens dans le texte, car Zendesk bloque les téléchargements côté serveur.

Votes

Les votes positifs sont importés ; les votes négatifs sont ignorés. Des entrées individuelles sont créées pour les votants disposant d’une adresse e-mail ou d’un identifiant externe (les votants Zendesk supprimés sont tout de même comptabilisés dans le total de la publication).

Abonnés

Importés comme abonnés aux demandes, avec leur date d’abonnement d’origine, si l’utilisateur dispose d’une adresse e-mail ou d’un identifiant externe.

Éléments non importés

Tickets Support, articles du centre d’aide, étiquettes de contenu, votes négatifs, sujets non associés et journaux des modifications.

Dépannage

  • « Nous n’avons pas trouvé de compte Zendesk. » Saisissez votre sous-domaine .zendesk.com plutôt qu’un domaine personnalisé.

  • « Zendesk n’a pas accepté cet identifiant et ce secret. » Vérifiez que le client OAuth dans Zendesk est défini comme Confidentiel, et non comme Public.

  • « Ce client OAuth ne peut pas consulter le forum. » Vérifiez que les autorisations hc:read et users:read sont toutes deux activées pour le client.

  • Limites de débit. Le chargement des sujets est limité à 10 requêtes par heure. Le lancement d’une importation est limité à 3 fois par heure et à 5 fois par jour.

Étapes suivantes

Cet article a-t-il répondu à votre question ?