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 coder. 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 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 vos 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 aussi des métadonnées sources précieuses de Zendesk, comme les labels 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é. Vous connecterez et synchroniserez d'abord votre contenu Zendesk, puis déclencherez l'import séparément depuis Knowledge > Sources pour le convertir en articles natifs Intercom.

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

  • Une fois importé, la connexion est coupée. Les modifications faites dans Zendesk ne seront pas reflétées dans Intercom. Cette conversion est irréversible.

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

    Pour importer, connectez et synchronisez d'abord votre source Zendesk en suivant les étapes ci-dessous. Une fois la synchronisation terminée, allez dans Knowledge > Sources, cliquez sur Gérer sur votre source Zendesk synchronisée, sélectionnez Importer le contenu, puis confirmez l'import.

Note : L'import se fait maintenant en deux étapes distinctes. D'abord, connectez et synchronisez votre contenu Zendesk en suivant les étapes ci-dessous. Une fois la synchronisation terminée, allez dans Knowledge > Sources, cliquez sur Gérer sur votre source Zendesk synchronisée, sélectionnez Importer le contenu, puis confirmez l'import pour le convertir en articles natifs Intercom — cette étape est manuelle et ne s’exécutera pas automatiquement après la synchronisation. Une fois importé, la synchronisation est supprimée, tout filtrage de synchronisation Zendesk est retiré, et votre contenu devient des articles éditables classiques dans votre espace de travail. L'import est irréversible.

Synchroniser le contenu

Choisissez cette option pour synchroniser une version mise à jour en continu et en lecture seule 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 l’indexation sous Général > Confidentialité :

Note : Le contenu est importé dans la langue définie dans Zendesk. Pour l’anglais, seuls EN-US, EN-UK et EN-CA sont pris en charge — il n’y a pas d’option EN générique. Les articles importés ne seront pas non plus placés automatiquement dans une collection ; vous devrez les organiser manuellement après l’import.


Connexion via token API

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

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

Commencez par générer un token API dans votre Admin Center Zendesk.

  1. Dans Zendesk, allez dans le Admin Center.

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

  3. Cliquez sur l’onglet API token puis sur Ajouter un token API.

  4. Donnez un nom descriptif au token (par exemple, « Intégration Intercom ») et copiez-le. Copiez-le et conservez-le en lieu sûr. Zendesk ne le montrera 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. Saisissez vos informations de connexion :

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

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

    • Cliquez sur Connecter.

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

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

  4. Après que Zendesk est connecté à Intercom, vous pouvez utiliser l’onglet Métadonnées pour pré-filtrer précisément quel contenu 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, labels ou horodatages. Si vous passez 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 de l'audience : Choisissez les audiences spécifiques (par exemple, « Enterprise plan » ou « UK audience ») qui peuvent voir ce contenu.

  6. Faites une vérification finale de votre configuration avant de commencer l'importation.

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

    • Vérifiez le résumé pour voir exactement combien d'articles et de champs sont importés en fonction de 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. Saisissez 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 éventuellement activer 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 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 coéquipiers.

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

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

Étape 4 : Revue

Faites une vérification finale avant de commencer l'importation :

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

  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. Saisissez 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 commencer 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 pouvez 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 qui correspondent à la structure de votre knowledge base existante. Cela peut prendre de quelques minutes à une heure ou plus. Nous vous enverrons un e-mail lorsque ce sera 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é sera obsolète, voici ce qui change :

  • 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. Les articles importés ne seront pas placés automatiquement dans une collection — utilisez les tags importés pour filtrer et organiser votre contenu.

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.

Une fois l'importation terminée, allez dans Knowledge > All Content pour trouver vos articles importés. Ils apparaîtront comme des articles individuels — pas dans une collection. Utilisez les tags importés de Zendesk pour les filtrer et les organiser.


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 des 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 d'origine)

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 d'origine.

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 d'origine et l'article/la collection vers lequel 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 le Multi Help Center, les redirections ne sont pas liées à un Help Center spécifique. Elles sont plutôt associées à un domaine. Cela signifie que les redirections apparaîtront sur n'importe quel Help Center utilisant le même domaine que celui où se trouvaient les articles Zendesk.

  • Les redirections seront disponibles pour tous les articles importés de 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 les URL de 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 sa mise en ligne. Il vous 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 ?

Il s'agit du domain de votre compte Zendesk (pas de l'URL du 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'import ?

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, après quoi 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 : Portuguese / Brazilian Portuguese, German / German (Formal), Chinese Traditional / Simplified.

Pour l'anglais spécifiquement, Intercom prend en charge EN-US, EN-UK et EN-CA — il n'y a pas d'option EN générique. En cas de conflit de locale, un article séparé est créé pour chaque variante 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 Intercom Messenger.

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 d'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é.

Mes articles affichent toujours l'icône Zendesk même s'ils sont modifiables dans Intercom — dois-je me reconnecter en synchronisation pour corriger cela ?

Non, vous ne devez pas vous reconnecter en synchronisation pour corriger une icône Zendesk résiduelle. Si vos articles sont modifiables dans Intercom, ils ont été importés (pas synchronisés) et sont déjà des articles natifs Intercom — la connexion Zendesk a été supprimée, et l'icône est juste un reste cosmétique de l'importation. Reconnecter la source en synchronisation rendrait ces articles en lecture seule à nouveau et les empêcherait d'être indexés par les moteurs de recherche, car les articles synchronisés sont exclus de l'indexation pour éviter les pénalités de contenu dupliqué avec votre Help Center Zendesk. Si vous souhaitez que vos articles natifs soient indexés par Google, laissez l'import en place — l'icône n'a aucun effet sur la fonctionnalité ou le SEO.

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 configurée, 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 ?