Importer depuis Zendesk
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.
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).
Ouvrez Zendesk Admin Center → Applications et intégrations → API → Clients OAuth.
Créez un client OAuth confidentiel et accordez-lui les autorisations
hc:readetusers: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.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
Dans UserJot, ouvrez Paramètres → Données & importation, puis cliquez sur Importer depuis Zendesk.
Saisissez le sous-domaine Zendesk (le sous-domaine
.zendesk.com, par exempleacme.zendesk.com; les domaines personnalisés associés à un hôte, commesupport.acme.com, ne sont pas acceptés), l’identifiant client et le secret client, puis cliquez sur Continuer.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.
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 |
|
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 |
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.complutô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:readetusers:readsont 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
Consultez toutes les options de migration dans Présentation de l’importation et de l’exportation.
Triez les commentaires importés dans Trier les demandes.