Comment exporter les articles du centre d'aide Intercom avec l'API : Un guide pour 2025

Alors comme ça, vous avez passé d'innombrables heures à construire une fantastique base de connaissances dans Intercom, la remplissant d'articles vraiment utiles qui résolvent les problèmes de vos clients. Maintenant, vous devez sortir ce contenu, et vous avez probablement remarqué qu'il n'y a aucun gros bouton brillant « exporter » nulle part. Si vous vous arrachez les cheveux à le chercher, vous n'êtes pas seul.

Que vous migriez vers une nouvelle plateforme, créiez une sauvegarde locale pour avoir l'esprit tranquille, ou que vous vouliez effectuer une analyse approfondie de votre contenu, extraire vos données ne devrait pas être un projet colossal. Ce guide est là pour vous guider à travers les étapes techniques pour exporter les articles du centre d'aide d'Intercom avec l'API.

Mais soyons réalistes, la voie de l'API peut devenir compliquée et a ses propres pièges. Nous vous montrerons donc également une alternative beaucoup plus simple et automatisée qui vous permet de connecter et de gérer vos connaissances sans écrire une seule ligne de code.

Avant de commencer : ce dont vous aurez besoin

Se lancer dans la méthode API nécessite un peu de préparation. C'est une tâche technique, donc avoir ces éléments prêts rendra tout le processus beaucoup plus fluide. Voici une petite checklist :

• Un accès administrateur à votre espace de travail Intercom : C'est absolument nécessaire, car vous devrez obtenir les bonnes permissions pour créer des identifiants API.

• Un jeton d'accès développeur : Considérez-le comme un mot de passe sécurisé qui permet à votre script ou outil de communiquer avec Intercom. Nous verrons comment en créer un dans la première étape.

• Un outil pour effectuer des requêtes API : Vous pouvez utiliser un outil en ligne de commande comme cURL si vous êtes à l'aise dans cet environnement, ou une application plus conviviale comme Postman.

• Une compréhension de base des API : Il sera utile de savoir ce que sont les endpoints, les requêtes GET et les données JSON, car cela facilitera le suivi des étapes.

Un guide étape par étape pour exporter des articles avec l'API d'Intercom

Prêt à commencer ? Voici le processus complet pour exporter vos articles en utilisant l'API REST d'Intercom, décomposé en quatre étapes.

Étape 1 : Obtenez votre jeton d'accès développeur Intercom

Pour commencer, vous avez besoin d'un moyen de prouver à Intercom que vous avez la permission d'accéder aux données de votre espace de travail. C'est là qu'un jeton d'accès entre en jeu.

En obtenir un est assez simple. Rendez-vous simplement dans le Hub Développeur dans vos paramètres Intercom. De là, vous pouvez créer une nouvelle application pour un usage interne. Donnez-lui un nom dont vous vous souviendrez (comme « Exportateur d'articles »), et Intercom générera un jeton d'accès pour vous. Copiez ce jeton et conservez-le en lieu sûr ; vous en aurez besoin pour chaque appel API.

Étape 2 : Listez tous les articles pour obtenir leurs ID

Voici une petite particularité de l'API d'Intercom : vous ne pouvez pas simplement demander tout le contenu de vos articles en une seule fois. D'abord, vous devez demander une liste de tous vos articles pour obtenir leurs ID uniques. C'est comme obtenir un catalogue de bibliothèque avant de pouvoir emprunter des livres.

Pour ce faire, vous utiliserez l'endpoint « Lister tous les articles ». Lorsque vous envoyez une requête à cet endpoint avec votre jeton d'accès, Intercom vous renverra un objet JSON avec une liste de vos articles, chacun avec son propre « id ».

Étape 3 : Récupérez le contenu de chaque article

Avec votre liste d'ID d'articles prête, vous pouvez maintenant commencer à extraire le contenu réel. Cela implique de faire une requête distincte pour chaque article, un par un.

Vous utiliserez l'endpoint « Récupérer un Article », en veillant à inclure l'« id » spécifique de l'article dans l'URL de la requête. La réponse pour chaque requête sera un objet JSON contenant tout sur l'article : son titre, son auteur, son état et, bien sûr, le « body », qui contient le contenu au format HTML.

C'est de loin la partie la plus répétitive du processus. Si vous avez 500 articles, vous allez faire 500 requêtes API individuelles.

Étape 4 : Formatez et enregistrez vos données exportées

Au fur et à mesure que vous obtenez le contenu de chaque article, c'est à vous de l'enregistrer. Le corps de l'article est renvoyé en HTML, vous devrez donc enregistrer ces données dans des fichiers. Vous pourriez les enregistrer en tant que fichiers .html ou, si vous avez besoin de quelque chose de différent, écrire un script pour convertir le HTML dans un autre format comme le Markdown ou le texte brut.

Pour faire cela pour tout un centre d'aide, vous voudrez presque certainement écrire un petit script qui récupère la liste complète des ID (en gérant la pagination), boucle sur chacun d'eux, fait une requête API pour obtenir le contenu, extrait le titre et le corps, et enregistre le tout dans un fichier local.

Et voilà. Vous avez exporté vos articles. Comme vous pouvez le voir, cependant, ce n'est pas exactement un simple clic de bouton.

Les défis courants de l'exportation d'articles avec l'API

Bien que la méthode API fasse le travail, elle est loin d'être parfaite. De nombreuses équipes se heurtent aux mêmes frustrations qui peuvent transformer cette tâche en une véritable perte de ressources.

• C'est un processus technique et chronophage. À moins d'être ingénieur, tout ce processus peut sembler intimidant. Il nécessite des connaissances techniques, du temps pour écrire et déboguer des scripts, et une maintenance continue si vous devez le faire plus d'une fois. Pour les non-techniciens, c'est pratiquement impossible, et pour les développeurs, c'est juste une autre tâche qui les détourne de leurs projets principaux.

• Les articles internes ne peuvent pas être exportés. C'est un gros problème. L'API d'Intercom ne permet actuellement pas d'exporter les articles à usage interne uniquement. Toutes ces connaissances précieuses que votre équipe utilise chaque jour sont bloquées, vous laissant avec un travail de copier-coller manuel qui va à l'encontre de l'objectif d'une exportation automatisée.

• Le formatage et le contenu peuvent devenir bizarres. Le HTML exporté n'est pas toujours une réplique parfaite. Comme Intercom le mentionne dans sa propre documentation, tout redimensionnement d'image personnalisé que vous avez effectué sera perdu, et les éléments dynamiques comme les encadrés ou les sections dépliables ne sont pas entièrement pris en charge. Vos articles magnifiquement formatés pourraient finir par avoir l'air un peu cassés.

• C'est un instantané ponctuel. Le plus grand inconvénient est peut-être que votre exportation est obsolète à la seconde où vous la terminez. Tous les nouveaux articles, mises à jour ou modifications apportées dans Intercom ne seront pas dans vos fichiers exportés. Pour maintenir les choses à jour, vous devez recommencer tout le processus manuel et technique.

La meilleure alternative : unifier vos connaissances

Tous ces maux de tête soulèvent une question intéressante : et si l'exportation était la mauvaise solution au problème ? Le véritable objectif n'est pas seulement d'obtenir un dossier de fichiers HTML ; c'est d'utiliser ces connaissances ailleurs.

Et si vous n'aviez pas du tout besoin d'exporter vos articles ? Et si vous pouviez simplement connecter en toute sécurité votre base de connaissances Intercom aux autres outils que vous utilisez et la garder à jour et synchronisée automatiquement ?

C'est tout l'objet d'eesel AI. Au lieu de vous battre avec une exportation ponctuelle, eesel AI fournit une intégration en un clic avec Intercom qui vous permet de contourner entièrement ces problèmes.

Voici comment cela aide :

• Rassemblez toutes vos connaissances. Vous pouvez connecter votre centre d'aide Intercom en quelques minutes. Mais pourquoi s'arrêter là ? Vous pouvez également connecter d'autres endroits où votre équipe stocke des informations, comme Confluence, Google Docs, et même d'anciens tickets de support. Vos connaissances sont toujours à jour et en temps réel, sans aucun effort manuel.

• Commencez en quelques minutes, pas en quelques mois. Oubliez le processus API en plusieurs étapes qui nécessite un développeur. Avec eesel AI, vous pouvez vous inscrire, connecter vos sources et commencer à voir de la valeur immédiatement, tout seul.

• Mettez vos connaissances au travail. Une exportation statique a des utilisations limitées. Une base de connaissances connectée et en temps réel, en revanche, est un avantage sérieux. Une fois connectées, vos connaissances Intercom peuvent aider à alimenter un Copilote IA qui rédige des réponses pour vos agents, un Agent IA autonome qui résout les tickets par lui-même, ou un bot de Q&R interne dans Slack. C'est un résultat concret, pas seulement un vidage de données.

Le Copilote IA d'eesel en train de rédiger une réponse, montrant comment les connaissances unifiées peuvent alimenter directement les outils de support.

Conseils de pro pour la gestion des connaissances Intercom

Lorsque vous changez votre façon de penser et que vous vous éloignez des exportations manuelles, vous ouvrez la porte à de meilleures façons de gérer vos connaissances. Voici quelques conseils pour vous aider à élaborer une stratégie plus efficace.

1. Trouvez et comblez automatiquement les lacunes de connaissances. L'une des parties les plus difficiles de la gestion d'un centre d'aide est de savoir quoi écrire ensuite. Au lieu de deviner, laissez vos conversations avec les clients vous guider. Un outil d'IA comme eesel AI peut examiner vos tickets de support, repérer les questions récurrentes qui ne trouvent pas de réponse dans votre centre d'aide, et générer automatiquement des brouillons d'articles pour combler ces lacunes.

Un tableau de bord eesel AI montrant comment il identifie les lacunes de connaissances à partir des conversations de support, évitant le besoin d'exporter manuellement les articles du centre d'aide Intercom avec l'API pour analyse.

2. Ne laissez pas les connaissances rester coincées dans des silos. La sagesse collective de votre entreprise ne réside pas uniquement dans Intercom. Des processus importants sont documentés dans Confluence, les mises à jour de produits sont partagées dans Google Docs, et les solutions rapides sont échangées dans Slack. Une meilleure stratégie de support unifie toutes ces sources, offrant à votre équipe et à votre IA un endroit fiable pour trouver des réponses.

3. Simulez avant d'automatiser. Si vous comptez utiliser vos connaissances pour alimenter une IA, vous devez avoir confiance qu'elle fonctionnera correctement. Recherchez des outils qui vous permettent de tester sans risque. Par exemple, le mode simulation d'eesel AI vous permet d'exécuter votre configuration d'IA sur des milliers de tickets passés. Vous pouvez voir exactement comment elle aurait répondu et obtenir des prévisions solides sur les taux de résolution, ce qui vous aide à renforcer votre confiance avant de l'activer pour les clients en direct.

La fonctionnalité de simulation dans eesel AI, qui permet aux équipes de tester leur configuration d'IA sur des tickets passés et de renforcer la confiance avant de passer en direct.

Dépasser le besoin d'exporter les articles du centre d'aide Intercom avec l'API

Bien que vous puissiez techniquement exporter les articles du centre d'aide Intercom avec l'API, il est assez clair que le processus est manuel, techniquement exigeant et présente des limites importantes. Il laisse vos connaissances internes de côté et vous donne un instantané statique de votre contenu qui devient rapidement inutile.

Une approche plus moderne et efficace consiste à cesser de penser aux exportations ponctuelles et à commencer à construire un système de connaissances unifié et en temps réel. Au lieu de sortir les données, vous devriez connecter vos outils.

Des outils comme eesel AI sont conçus pour cela. Ils permettent aux équipes de connecter leurs sources de connaissances en quelques minutes et de mettre immédiatement ces informations au travail, le tout sans avoir à manipuler des API ou à écrire du code. Il est temps de libérer le véritable potentiel de votre base de connaissances.

Prêt à unifier vos connaissances ?

Arrêtez de perdre du temps avec des exportations manuelles et des scripts API complexes. Connectez toutes vos sources de connaissances, y compris votre centre d'aide Intercom, en quelques minutes avec eesel AI.

Commencez votre essai gratuit dès aujourd'hui et découvrez à quel point il est facile d'alimenter votre support avec des connaissances véritablement unifiées.