Passer au contenu principal

Importer des articles publics depuis Zendesk

Comment migrer votre contenu depuis une knowledge base Zendesk en quelques minutes.

Écrit par Beth-Ann Sher

Comment ça fonctionne

Vous pouvez facilement importer votre contenu d'aide public Zendesk dans Intercom, sans nécessiter de code. Cela vous permet de faire d'Intercom votre source unique de vérité pour les articles de support et de les utiliser pour alimenter les fonctionnalités d'IA d'Intercom.

L'importateur Zendesk est construit sur une pipeline de service robuste et résiliente qui réduit significativement les erreurs et améliore la rapidité et la fiabilité de l'intégration de votre contenu.

Une fois vos articles dans Intercom, vous pouvez :

  • Les utiliser pour alimenter Fin AI Agent et Copilot afin d'obtenir des réponses précises et automatisées.

  • Les rendre accessibles dans l'Inbox pour que les collègues puissent les partager dans les conversations.

  • Les mettre en avant dans votre Help Center pour que les clients puissent s'auto-servir.

Astuce : L'importateur extrait également des métadonnées source précieuses de Zendesk, telles que les étiquettes et catégories, et les applique comme tags à vos articles dans Intercom. Cela vous aide à organiser le contenu et à appliquer des règles pour une résolution IA plus efficace.

Note : Cela tentera de migrer tous vos articles d'aide publiés depuis Zendesk. Pour ajouter des articles spécifiques, nous recommandons de les copier et de les ajouter individuellement au Knowledge Hub dans Intercom.


Choisir comment connecter vos données

Vous avez deux options pour gérer votre contenu Zendesk dans Intercom.

Importer le contenu

Choisissez cette option si vous souhaitez faire d'Intercom votre nouvelle source unique de vérité.

  • Cela effectue une migration unique de tous vos articles Zendesk publiés vers Intercom.

  • Une fois importé, la connexion est coupée. Les modifications effectuées dans Zendesk ne seront pas reflétées dans Intercom.

  • Vous pouvez ensuite éditer et gérer ces articles directement dans Intercom.

Synchroniser le contenu

Choisissez cette option pour synchroniser une version en lecture seule continuellement mise à jour de votre contenu. Zendesk reste votre source de vérité.

  • C'est idéal pour alimenter Fin AI Agent avec votre knowledge base existante sans migrer.

  • La synchronisation est fiable et transparente, garantissant que Fin dispose toujours du contenu le plus récent.

  • Vous continuerez à éditer et gérer vos articles dans Zendesk.


Avant d'importer

Avant de commencer, nous recommandons d'activer l'indexation par les moteurs de recherche dans les paramètres de votre Help Center pour éviter tout retard dans l'apparition de vos articles dans les résultats de recherche. Vous pouvez le faire en allant dans Paramètres > Help Center et en cliquant sur "configurer et styliser" :

Vous trouverez l'option pour activer la recherche indexée sous Général > Confidentialité :


Connexion via un jeton API

Utilisez cette méthode pour importer votre contenu Zendesk en utilisant un jeton API sécurisé.

Étape 1 : Générer un jeton API Zendesk

Tout d'abord, générez un jeton API dans votre Zendesk Admin Center.

  1. Dans Zendesk, allez au Admin Center.

  2. Naviguez vers Apps and integrations > APIs > Zendesk API.

  3. Cliquez sur l'onglet API token et cliquez sur Ajouter un jeton API.

  4. Donnez un nom descriptif au jeton (par exemple, "Intégration Intercom") et copiez-le. Copiez-le et conservez-le en lieu sûr. Zendesk ne l'affichera plus.

Étape 2 : Connecter Zendesk dans Intercom

  1. Depuis votre espace de travail Intercom, allez dans Knowledge > Sources.

  2. Sous Public articles, trouvez Zendesk et cliquez sur Synchroniser ou Importer.

  3. Entrez vos détails de connexion :

    • Entrez le sous-domaine : Fournissez votre sous-domaine Zendesk (par exemple, mydomain.zendesk.com).

    • Choisissez l'authentification : Sélectionnez API Token pour vous connecter.

    • Cliquez sur Connecter.

    • Vous pouvez éventuellement activer "Synchroniser les articles pour les users connectés" pour inclure le contenu visible uniquement par les users authentifiés.

      Lorsque le processus de Connexion est terminé, vous pouvez passer à l'étape suivante.

  4. Après que Zendesk se connecte à Intercom, vous pouvez utiliser l'onglet Métadonnées pour pré-filtrer exactement quel contenu de Zendesk doit être importé dans Intercom. Choisissez parmi les champs principaux ou les tags personnalisés pour étendre votre filtrage et ciblage. Cliquez sur + Ajouter un filtre pour affiner le contenu selon des critères spécifiques comme les Catégories, Étiquettes ou Horodatages. Si vous sautez cette étape, l'importateur importera par défaut tout le contenu éligible.

  5. Utilisez l'onglet Cible pour décider où votre contenu importé est utilisé dans Intercom.

    • Fin AI Agent : Activez cette option pour utiliser les articles Zendesk pour des réponses automatisées aux clients.

    • Copilot : Activez cette option pour fournir des réponses suggérées à vos collègues.

    • Help Center : Activez cette option si vous souhaitez publier le contenu Zendesk directement dans votre Help Center Intercom.

    • Contrôle d'audience : Choisissez quelles audiences spécifiques (par exemple, "Plan Enterprise" ou "Audience UK") peuvent voir ce contenu.

  6. Faites une dernière vérification de votre configuration avant de commencer l'importation.

    • Entrez un nom personnalisé pour l'import afin de l'identifier dans votre liste Knowledge (par exemple, « Zendesk - Support Public »).

    • Vérifiez le résumé pour voir exactement combien d'articles et de champs sont importés selon vos filtres de métadonnées.

    • Vérifiez que vos paramètres Disponible dans et Audience sont corrects.

  7. Cliquez sur Synchroniser et mettre en ligne pour commencer la transformation de votre contenu Zendesk en articles Intercom.


Connexion via OAuth

Étape 1 : Authentifier Zendesk

Pour importer votre contenu, vous devez d'abord authentifier votre source Zendesk :

  1. Entrez votre sous-domaine Zendesk (par exemple, mydomain.zendesk.com).

  2. Sélectionnez OAuth comme méthode d'authentification.

  3. Cliquez sur Connecter.

Une fois la connexion établie, vous pouvez activer optionnellement Synchroniser les articles pour les utilisateurs connectés pour inclure le contenu visible uniquement par les clients authentifiés. Cliquez sur Suivant lorsque la connexion est réussie.

Votre sous-domaine est la partie de votre URL avant .zendesk.com. Par exemple, si votre URL est https://help.zendesk.com, votre sous-domaine est help.

Étape 2 : Métadonnées

Après que Zendesk se connecte à Intercom, utilisez l'onglet Métadonnées pour pré-filtrer exactement quel contenu doit être importé dans Intercom :

  • Choisissez parmi les champs principaux ou les tags personnalisés pour affiner votre importation.

  • Cliquez sur + Ajouter un filtre pour sélectionner le contenu selon des critères spécifiques comme Catégories, Étiquettes ou Horodatages.

Si vous sautez cette étape, l'importateur importera par défaut tout le contenu éligible.

Étape 3 : Cible

Utilisez l'onglet Cible pour décider où votre contenu importé est utilisé dans Intercom :

  • Fin AI Agent : Activez ceci pour utiliser les articles Zendesk pour des réponses automatisées aux clients.

  • Copilot : Activez ceci pour fournir des réponses suggérées à vos coéquipiers.

  • Help Center : Activez ceci pour publier le contenu Zendesk directement dans votre Help Center Intercom.

  • Contrôle d'audience : Choisissez quelles audiences spécifiques (par exemple, « Plan Enterprise ») peuvent voir ce contenu.

Étape 4 : Revue

Faites une dernière vérification avant de commencer l'importation :

  1. Entrez un nom personnalisé pour l'import afin de l'identifier dans votre liste Knowledge (par exemple, « Zendesk - Support Public »).

  2. Vérifiez le résumé pour voir le nombre d'articles et de champs importés.

  3. Vérifiez que vos paramètres Disponible dans et Audience sont corrects.

Cliquez sur Synchroniser et mettre en ligne pour commencer.


Importation avec l'importateur hérité

  1. Pour commencer à importer des articles publics, allez dans Knowledge Hub > Sources.

  2. Sous Articles publics, trouvez Zendesk et cliquez sur Synchroniser ou Importer.

  3. Entrez maintenant votre sous-domaine Zendesk et choisissez l'option « Importer le contenu » puis cliquez sur Importer.

Note :

  • L'importateur hérité sera déprécié après le 25 avril. Après cette date :

    • Les synchronisations manuelles et automatiques cesseront.

    • Vous pouvez toujours effectuer une importation unique à tout moment, mais la synchronisation ne reprendra pas tant que vous n'aurez pas migré vers le nouvel importateur.

    • Une fois que vous êtes sur le nouvel importateur (ou après avoir modifié une source migrée), vous aurez accès aux nouveaux filtres et fonctionnalités de métadonnées.

  • Pour démarrer une importation d'articles depuis Zendesk avec l'importateur hérité, vous devez vous connecter avec un accès Admin pour authentifier.

  • Vous devrez choisir le Help Center cible dans Intercom si vous utilisez Multi Help Center.

  • Si vous importez, vos articles Zendesk seront convertis en articles publics natifs que vous pourrez gérer dans Intercom.

  • Pour importer des articles multilingues depuis Zendesk, vous devrez ajouter les langues supplémentaires dans les paramètres de votre Help Center, afin que les traductions importées soient visibles.

  • Le domaine personnalisé de votre Help Center Intercom doit être configuré avant l'importation pour que les redirections soient générées en utilisant ce domaine personnalisé.

Maintenant, attendez que l'importation soit terminée. Pendant ce temps, nous explorerons votre site de documentation, importerons tous vos articles publiés et les placerons dans des collections Help Center correspondant à la structure de votre knowledge base existante. Cela peut prendre de quelques minutes à une heure ou plus. Nous vous enverrons un e-mail une fois terminé, vous n'avez donc pas besoin d'attendre 😄

Après la migration, actualisez la page Contenu dans Knowledge pour voir vos articles importés dans les dossiers de la barre latérale gauche.

Apprenez à gérer les articles publics depuis Knowledge et à les activer pour Fin AI Agent et Copilot.

Important : Si ce n'est pas déjà fait, vous devrez activer votre Help Center sinon vos articles ne seront pas publiés et ne pourront pas être activés pour Fin ou Copilot.

Après le 25 avril

Une fois que l'importateur hérité est déprécié, voici les changements :

  • Les synchronisations manuelles et automatiques cesseront.

  • Vous pouvez toujours effectuer une importation ponctuelle à tout moment, mais la synchronisation ne reprendra pas tant que vous n'aurez pas basculé vers le nouvel importateur.

  • Une fois que vous êtes sur le nouvel importateur (ou après avoir modifié une source migrée), vous aurez accès aux nouveaux filtres et fonctionnalités de métadonnées.


Après la connexion

Nous commencerons à explorer votre site Zendesk, à importer vos articles publiés et à les structurer en collections correspondant à votre knowledge base existante. Toutes les étiquettes ou catégories de Zendesk seront ajoutées comme tags aux articles dans Intercom.

Ce processus peut prendre de quelques minutes à une heure. Nous vous enverrons un e-mail une fois terminé. Vous pouvez vérifier le statut à tout moment dans Knowledge > Sources.

Après la migration, actualisez la page Content dans Knowledge pour voir vos articles importés.


Comment les métadonnées Zendesk sont importées

Pour vous faire gagner du temps, l'importateur intègre automatiquement la structure de votre knowledge base Zendesk dans Intercom.

Les métadonnées Zendesk telles que les étiquettes, catégories et tags de contenu sont toutes importées et converties en tags sur vos articles Intercom.

Ces métadonnées sont essentielles pour rendre votre contenu utile. Avec ces tags appliqués automatiquement, vous pouvez :

  • Filtrer votre contenu dans la section Knowledge pour voir les articles par catégorie.

  • Exclure le contenu non pertinent du Fin AI Agent.

  • Diriger les réponses vers le bon public en créant des audiences spécifiques Fin AI Agent basées sur les tags des articles.

Par exemple, si vous avez du contenu dans Zendesk étiqueté « EMEA-only », cette étiquette deviendra un tag dans Intercom. Vous pouvez alors créer une audience pour vos clients européens dans Fin AI Agent et la configurer pour n'utiliser que les articles avec le tag « EMEA-only ».


Redirections d’articles Zendesk

Les redirections d’articles sont générées automatiquement lors du processus d’importation — et avec la nouvelle chaîne d’importation, elles sont plus fiables que jamais. Bien que les URL des articles Zendesk et Intercom soient dans des formats différents, les redirections garantissent que les liens existants ne se cassent pas après la migration, préservant ainsi leur score SEO.

Les redirections sont mises en œuvre sous forme de redirections permanentes (réponses HTTP 301).

Comment fonctionne la correspondance des redirections

Les redirections sont associées à l’ID numérique stable de l’article intégré dans l’URL Zendesk — pas au slug, qui peut changer. Cela signifie que toutes les variantes d’URL pour un même article correspondent à un seul enregistrement de redirection et au même article Intercom.

Le visiteur arrive à (URL Zendesk originale)

Redirige vers

/hc/en-us/articles/12345678-how-to-reset-password

Article Intercom

/hc/en-us/articles/12345678-reset-your-password

Même article Intercom

/hc/en-us/articles/12345678

Même article Intercom

Note : Les redirections sont créées automatiquement lors de l’importation et ne bloqueront jamais l’importation en cas de problème.

Support multilingue

Lors de l’importation de collections et d’articles en plusieurs langues, chaque variante linguistique aura sa propre redirection associée à l’URL Zendesk originale de l’article.

Revue des redirections existantes

Une fois l’importation terminée, vous pouvez consulter les redirections générées via la section Domains dans Paramètres > Help Center > Configurer et styliser :

De là, faites défiler jusqu’à Domains et cliquez sur « gérer les redirections » :

Le panneau affiche l’URL originale et l’article/la collection vers laquelle elle redirige.

Important :

  • Les redirections ne seront affichées que pour le domaine personnalisé choisi. Par exemple, si vous importez des articles d’un Help Center Zendesk à https://support.examply.com, les redirections apparaîtront dans la section domain uniquement si vous avez sélectionné support.examply.com comme domaine personnalisé et que vous utilisez le protocole de sécurité HTTPS.

  • Si vous n’êtes pas prêt à basculer votre CNAME pour pointer vers Intercom pour votre domaine personnalisé, vous pouvez toujours faire créer les redirections lors de l’importation depuis Zendesk en ajoutant votre domaine personnalisé dans votre Help Center Intercom, et en sélectionnant l’option d’utiliser le protocole de sécurité HTTPS.

  • Avec Multi Help Center, les redirections ne sont pas liées à un Help Center spécifique. Elles sont plutôt associées à un domain. Cela signifie que les redirections apparaîtront sur tout Help Center utilisant le même domain que celui où se trouvaient les articles Zendesk.

  • Les redirections seront disponibles pour tous les articles importés depuis Zendesk après le 22 septembre 2022.


Contenu non catégorisé

Si vous avez du contenu non catégorisé sur votre site, Articles créera automatiquement une collection « Général » pour vous. Les collections aident vos users à naviguer et à trouver facilement ce dont ils ont besoin, alors pensez à réorganiser ces articles par sujet avant de les publier.


Contenu que nous ne supportons pas encore

Nous convertirons votre contenu dans un format que nous supportons (par exemple en copiant les images). Cependant, nous ne supportons pas encore les formats suivants :

L’importation depuis l’URL d’une catégorie/collection n’est pas non plus supportée. Vous devrez importer votre knowledge base depuis l’URL principale.


Articles avec formatage non supporté

S’il y a des problèmes lors de l’importation de votre contenu, nous ajouterons une étiquette Review à l’article afin que vous puissiez le corriger avant de le publier. Il suffit d’ouvrir l’article à revoir et de lire la recommandation que nous avons ajoutée. La recommandation sert de repère, vous devrez donc la supprimer et insérer le contenu recommandé avant de publier l’article.


FAQs

Quel est mon sous-domaine Zendesk ?

Ceci est le domain de votre compte Zendesk (pas l’URL de votre Help Center). Votre sous-domaine Zendesk est son identifiant unique et il existe plusieurs façons de le trouver que vous pouvez voir ici.

Mon Help Center contient des articles en 2 langues mais je n’en vois qu’une seule après l’importation ?

Intercom importera toutes les langues prises en charge, mais nous n’activerons pas cette langue pour le Help Center. Vous devrez ajouter la langue dans leurs paramètres du Help Center, et après cela la traduction sera visible.

J’ai un article localisé en EN-US et EN-GB et il a été importé en deux articles différents ?

Intercom ne prend en charge qu’une courte liste de versions localisées des langues : portugais / portugais brésilien, allemand / allemand (formel), chinois traditionnel / simplifié.

Pour toutes les autres versions localisées, nous les associons à la langue la plus proche prise en charge par Intercom (ex : EN-GB, EN-US, EN-AU sont toutes associées à EN). En cas de conflit, nous créons un article différent pour chaque version localisée afin d’éviter toute perte de données.

J’ai des articles en irlandais mais ils n’ont pas été importés, que s’est-il passé ?

Nous n’importons que des articles dans l’une des langues prises en charge par le Messenger Intercom.

L’email indique qu’il a importé « X » articles, mais je n’en vois que « Y » dans mon Help Center ?

Le total indiqué dans l’email inclut toutes les différentes langues dans lesquelles l’article existe. Un article avec des traductions en anglais, français et portugais comptera comme 3 articles dans l’email.

Quelle est la différence entre « Synchroniser le contenu » et « Importer le contenu » depuis Zendesk ?

La principale différence entre la synchronisation du contenu et l’importation du contenu depuis Zendesk est l’endroit où vous prévoyez d’éditer vos articles à l’avenir.

  • Choisissez de synchroniser le contenu si vous souhaitez conserver Zendesk comme éditeur principal. Cela crée une version en lecture seule de vos articles dans Intercom qui reste à jour avec votre knowledge base Zendesk.

  • Choisissez de importer le contenu si vous souhaitez migrer complètement vers Intercom. Cela crée une copie modifiable de vos articles dans Intercom, qui devient votre nouvelle source unique de vérité.

Si je supprime un article dans Zendesk, sera-t-il également supprimé d’Intercom ?

Oui, si vous supprimez un article dans Zendesk alors que vous avez une synchronisation active, il sera également supprimé d’Intercom. Cela se produit automatiquement lors de la prochaine synchronisation pour garantir que les deux knowledge bases restent cohérentes.

Est-il sûr d’utiliser une clé API Zendesk pour l’authentification ?

Oui, il est sûr d’utiliser une clé API Zendesk pour l’authentification. C’est une méthode standard et sécurisée pour connecter des applications qui accorde à Intercom des permissions spécifiques pour accéder à vos articles sans exposer votre mot de passe administrateur ou d’autres informations sensibles du compte.

Avez-vous trouvé la réponse à votre question ?