Passer au contenu principal

Synchroniser ou importer des articles internes depuis des sources externes

Comment synchroniser ou importer votre contenu d'assistance depuis Confluence, Guru ou Notion.

Utilisez cet article pour connecter Confluence, Guru ou Notion comme source de contenu pour Fin AI Agent et/ou Copilot. Vous pouvez contrôler quelles pages ou cartes sont synchronisées grâce à des pré-filtres de métadonnées, et configurer le ciblage d'audience et la disponibilité pour chaque source. Les trois sources utilisent un flux de configuration guidé en quatre étapes — Connecter, Métadonnées, Ciblage et Revue — pour un contrôle précis de ce qui entre dans Fin et où cela est utilisé.

Lorsque le contenu est synchronisé :

  • Il ne peut pas être modifié dans Fin. Les modifications doivent être effectuées dans l'outil source (Confluence, Notion ou Guru).

  • Les modifications dans la source, y compris les pages et cartes nouvelles, modifiées ou supprimées, se synchronisent généralement avec Fin en quelques minutes pour Guru et Notion, et pour les sources Confluence avec les mises à jour en temps réel activées. Une synchronisation complète s'exécute également toutes les 24 heures en sauvegarde, donc tout ce que la mise à jour en temps réel manque est quand même récupéré. Elle peut aussi être relancée manuellement.

  • La synchronisation quotidienne est sautée lorsqu'il n'y a eu aucune mise à jour du contenu dans la source depuis la dernière synchronisation, car cela ne produirait rien de nouveau.

  • Le contenu sera ajouté à de nouveaux dossiers synchronisés dans Fin. Un dossier synchronisé ne peut pas être modifié et tous les dossiers sont affichés par ordre alphabétique.

  • Les mises à jour en temps réel s'activent automatiquement pour Guru et Notion. Pour Confluence, un administrateur du site Confluence installe l'application Fin for Confluence, puis vous choisissez Temps réel pour chaque source Confluence. Apprenez comment activer les mises à jour en temps réel pour Confluence.

Lorsque le contenu est importé :

  • Il est transformé en articles internes natifs qui peuvent être modifiés/supprimés depuis votre espace de travail Fin.

  • Le contenu sera ajouté à un nouveau dossier natif dans Fin. Les dossiers natifs peuvent être modifiés.

Note : La plupart des mises en forme sont conservées lors de la synchronisation ou de l'importation, y compris les images, tableaux, listes et en-têtes. Certains éléments — comme les citations en bloc — peuvent ne pas être transférés depuis la source.


Comment synchroniser ou importer des articles internes

Pour ajouter une nouvelle source de contenu externe, allez dans Knowledge > Content, cliquez sur Ajouter du contenu, puis sélectionnez Connecter le contenu d'une application externe.

La page Knowledge > Content dans Intercom montrant le bouton Ajouter du contenu

Puis sélectionnez une source de connaissance interne, telle que :

  • Notion

  • Confluence

  • Guru

Écran de sélection de source de contenu montrant Notion, Confluence et Guru comme options d'intégration disponibles

Vous serez invité à fournir les identifiants pour accéder au compte Confluence/Guru/Notion associé.


Confluence

  1. Allez dans Knowledge > Content, cliquez sur Ajouter du contenu, puis sélectionnez Connecter le contenu d'une application externe.

  2. Sélectionnez Confluence comme source.

  3. Suivez les étapes Connecter → Métadonnées → Ciblage → Revue.

  4. Configurez les filtres de métadonnées, le ciblage d'audience et la disponibilité Fin AI Agent/Copilot.

  5. Cliquez sur Mettre à jour et synchroniser.

Note : Cela fonctionne pour les sources Confluence héritées (v1) et celles avec dossiers activés (v2). Vos identifiants OAuth existants sont conservés — vous pouvez être invité à vous réauthentifier si votre connexion a expiré. Les espaces avec des permissions restreintes peuvent ne pas se synchroniser correctement. Assurez-vous toujours que le compte utilisateur utilisé pour connecter Confluence dispose des permissions de visualisation et d'accès appropriées pour les espaces que vous souhaitez synchroniser.

L'étape Métadonnées vous permet de pré-filtrer les pages qui entrent dans Fin. Pour Confluence, les métadonnées synchronisées en tant que champs structurés incluent les étiquettes, le titre, la page parente, l'auteur, et les dates de création/modification. Vous pouvez créer des règles de pré-filtrage utilisant des conditions de chaîne (est, n'est pas, contient, commence par, finit par) et des conditions d'étiquette (est, n'est pas).

Note :

  • Cette intégration supporte actuellement Confluence Cloud uniquement. Assurez-vous de ne pas tenter d'intégrer une version on-premises de Confluence.

  • Nous n'importons que les espaces Confluence de type 'global'.

  • Assurez-vous de vous connecter avec un compte utilisateur ayant les permissions correctes pour le contenu que vous souhaitez synchroniser ou importer dans Fin.

Des dossiers peuvent maintenant être créés dans Confluence, mais ils ne sont pas encore supportés par cette synchronisation. Vous ne verrez apparaître dans le menu déroulant 'sélectionner dossiers' que ces pages et sous-pages, comme montré ci-dessous :

La configuration de la source Confluence montrant le menu déroulant Sélectionner dossiers, listant les pages et sous-pages mais pas les structures de dossiers

Note :

  • L'exclusion de dossiers est maintenant gérée via des filtres : utilisez le filtre « Page ancêtre » pour exclure des sous-arbres entiers de pages. Si vous aviez configuré des dossiers refusés auparavant, ils sont automatiquement migrés en règles de filtre lors de votre prochaine synchronisation — aucune action nécessaire.

  • Nous ne supportons pas la synchronisation de pages uniques. Seule la synchronisation complète est prise en charge.

  • Nous supportons la synchronisation des dossiers, mais pas des tableaux blancs depuis Confluence.

Dépannage des problèmes de synchronisation des espaces Confluence

Lors de l'intégration des espaces Confluence avec Fin, vous pouvez rencontrer des situations où certains espaces ne sont pas visibles ou ne se synchronisent pas correctement. Ce guide vous aide à diagnostiquer et résoudre ces problèmes courants.

Vérifiez le type de l'espace Confluence manquant

  • Dans Confluence, naviguez vers Paramètres de l'espace > Gérer l'espace > Détails de l'espace.

  • Vérifiez le « Type » de l'espace.

  • Fin ne supporte que la synchronisation des espaces de type 'global'. Les espaces marqués comme 'personal' ou 'knowledge_base' ne sont pas inclus dans la synchronisation.

Vous ne voyez pas le type d'espace ? Selon votre plan et configuration Confluence, le type d'espace peut ne pas apparaître sur la page Détails de l'espace. S'il n'est pas affiché, un administrateur Confluence peut vérifier le type d'espace avec la Confluence REST API. Ou contactez notre équipe Support et nous vous aiderons à vérifier.

Créez un nouvel espace personnalisé (si le type n'est pas supporté)

  • Si l'espace Confluence manquant est d'un type non supporté (par exemple, 'personal' ou 'knowledge_base'), vous pouvez créer un nouvel espace 'Custom' pour résoudre le problème.

  • Dans Confluence, créez un nouvel espace Custom.

  • Transférez le contenu de votre espace non pris en charge vers cet espace personnalisé nouvellement créé.

Vérifier les paramètres de visibilité

  • Dans Confluence, assurez-vous que l’espace que vous souhaitez synchroniser est défini sur un statut « actuel ».

  • Seuls les espaces avec ce statut seront pris en compte pour la synchronisation avec Fin.

Dépannage des hiérarchies de dossiers et de pages

  • Fin ne prend pas en charge directement les dossiers dans Confluence pour la synchronisation. Il synchronise plutôt en fonction des pages et sous-pages individuelles.

  • Pour garantir la bonne synchronisation de votre contenu, structurez-le en utilisant des pages et sous-pages. Si vous devez exclure un contenu spécifique, déplacez ces pages dans un espace Confluence distinct qui n’est pas destiné à la synchronisation avec Fin.

Si les étapes de dépannage ci-dessus — vérification du type d’espace, des paramètres de visibilité et de la structure des dossiers — ne résolvent pas le problème, il se peut qu’un paramètre spécifique côté serveur doive être activé pour votre espace de travail. Pour régler cela, contactez notre équipe Support. Lorsque vous le faites, informez-les que vous avez déjà suivi les étapes de dépannage. Ensuite, demandez-leur d’examiner l’activation de tout paramètre backend pouvant aider à afficher tous vos espaces Confluence non personnels, en contournant ces restrictions par défaut. Ils vous aideront à tout faire fonctionner correctement.

Note : Les espaces avec des permissions restreintes peuvent ne pas se synchroniser correctement. Assurez-vous toujours que le compte utilisateur utilisé pour connecter Confluence à Intercom dispose des permissions de visualisation et d’accès appropriées pour les espaces que vous souhaitez synchroniser.

Activez les mises à jour en temps réel pour Confluence

Par défaut, les pages Confluence se synchronisent une fois par jour. Avec les mises à jour en temps réel activées, les modifications des pages atteignent Fin en quelques minutes, et la synchronisation quotidienne continue de s’exécuter. Les mises à jour en temps réel sont désactivées par défaut, et vous les activez pour chaque source Confluence.

Avant de commencer :

  • Un administrateur du site Confluence doit installer l’application Fin for Confluence sur votre site Confluence.

  • L’application demande la permission de modifier le contenu, car Confluence n’envoie des événements pour les pages supprimées qu’aux applications disposant de cette permission. Elle ne modifie jamais vos pages.

  • L’installation de l’application couvre l’ensemble de votre site Confluence, mais chaque source Confluence reste en synchronisation quotidienne jusqu’à ce que vous la passiez en temps réel.

Pour activer les mises à jour en temps réel :

  1. Allez dans Knowledge > Content et cliquez sur Modifier la source de votre source Confluence.

  2. À l’étape Revue, ouvrez le menu déroulant de fréquence de synchronisation et choisissez Temps réel.

  3. Si l’application n’est pas encore installée, cliquez sur Installer l’application et terminez l’installation dans Atlassian. Les mises à jour en temps réel commencent une fois qu’Atlassian confirme l’installation, ce qui peut prendre quelques minutes, même si vous fermez la page.

Pour désactiver les mises à jour en temps réel, remettez la fréquence de synchronisation sur Chaque jour. Si l’application Fin for Confluence est désinstallée de votre site, la source revient à la synchronisation quotidienne.

Dépanner les mises à jour en temps réel pour Confluence

Si les mises à jour en temps réel ne s’activent pas :

  • Le menu déroulant affiche Temps réel (nécessite l’application Fin for Confluence) : l’application n’est pas encore installée sur ce site Confluence. Demandez à un administrateur du site Confluence de l’installer.

  • Vous voyez Impossible de mettre à jour la fréquence de synchronisation. Réessayez. : réessayez. Si l’erreur persiste, contactez notre équipe support.


Guru

  1. Allez dans Knowledge > Content, cliquez sur Ajouter du contenu, puis sélectionnez Connecter le contenu d’une application externe.

  2. Sélectionnez Guru comme source.

  3. Suivez les étapes Connecter → Métadonnées → Cible → Revue.

  4. Configurez les filtres de métadonnées, le ciblage d’audience et la disponibilité de Fin AI Agent/Copilot.

    L’écran de configuration des métadonnées de Guru affichant les champs de filtre pour les tags, le tableau, l’auteur, les dates, la collection, le statut de vérification et le statut de partage
  5. Cliquez sur Mettre à jour et synchroniser.

L’étape Métadonnées vous permet de pré-filtrer les cartes qui arrivent dans Fin. Pour Guru, les métadonnées synchronisées en tant que champs structurés incluent les tags, le titre, le tableau, l’auteur, les dates, la collection, le statut de vérification et le statut de partage. Vous pouvez créer des règles de pré-filtrage en utilisant des conditions de chaîne (est, n’est pas, contient, commence par, finit par) et des conditions de tag (est, n’est pas).

Astuce : Assurez-vous d’avoir les permissions correctes associées à votre compte Guru et d’avoir vos identifiants API à portée de main lors de la synchronisation ou de l’importation. Les identifiants API peuvent être obtenus en suivant les instructions indiquées ici et se trouvent dans votre page de paramètres. Assurez-vous de sélectionner le User Token.

Note : Une seule collection Guru peut être synchronisée à la fois par espace de travail. Si une deuxième collection est ajoutée pendant qu’une synchronisation est en cours, elle est mise en file d’attente et commencera à se synchroniser automatiquement une fois la synchronisation en cours terminée. Cela garantit que les synchronisations s’exécutent séquentiellement et évite les conflits.


Notion

  1. Allez dans Knowledge > Content, cliquez sur Ajouter du contenu, puis sélectionnez Connecter le contenu d’une application externe.

  2. Sélectionnez Notion comme source.

  3. Suivez les étapes Connecter → Métadonnées → Cible → Revue.

  4. Configurez les filtres de métadonnées, le ciblage d’audience et la disponibilité de Fin AI Agent/Copilot.

  5. Cliquez sur Mettre à jour et synchroniser.

Note : Aucune migration requise pour Notion — tout est géré implicitement lors de votre prochaine synchronisation. Les propriétés dynamiques sont automatiquement importées en tant que champs structurés.

Conseils :

  • Assurez-vous de vous connecter avec un compte utilisateur disposant des permissions correctes pour le contenu que vous souhaitez synchroniser ou importer dans Fin.

  • Après avoir cliqué sur Mettre à jour et synchroniser, la synchronisation démarre immédiatement. Vous recevrez une notification par e-mail une fois terminée, et le contenu apparaîtra dans Knowledge > Content sous Sources de contenu.


Comment fonctionne le flux de revue des métadonnées

Les sources Confluence, Guru et Notion utilisent un flux de configuration en quatre étapes qui rend transparent la façon dont le contenu est récupéré dans Fin, et vous donne le contrôle sur ce qui est importé et où il est utilisé.

Connecter

Authentifiez-vous auprès de la source externe. Vos identifiants OAuth (Open Authorization) existants sont conservés pour les sources Confluence — il se peut que vous soyez invité à vous réauthentifier si la connexion a expiré.

Métadonnées

Choisissez quel contenu doit être pris en compte en utilisant des règles de pré-filtrage basées sur les métadonnées de votre knowledge base externe. Les métadonnées typiques incluent :

  • Étiquettes ou tags

  • Titre

  • Page parente / page ancêtre

  • Auteur

  • Dates de création et de modification

  • Propriétés dynamiques (Notion)

  • Tableau, collection, statut de vérification et statut de partage (Guru)

Créez des règles en utilisant des conditions sur les chaînes (est, n’est pas, contient, commence par, se termine par) et des conditions sur les étiquettes (est, n’est pas) pour restreindre la tranche de contenu synchronisée — par exemple, uniquement les pages étiquetées « fin-ai », ou seulement le contenu mis à jour après une certaine date.

Astuce : Si vous passez l’étape Métadonnées, l’importateur importe par défaut tout le contenu éligible de la source.

Cible

Décidez où le contenu importé est utilisé dans Fin. Configurez :

  • Fin AI Agent — utilisez le contenu pour répondre automatiquement aux questions des clients (par défaut désactivé)

  • Copilot — mettez le contenu à disposition des coéquipiers comme réponses suggérées

  • Ciblage d’audience — définissez des règles d’audience au niveau de la source, appliquées automatiquement à l’import

Revue

Confirmez votre configuration avant le début de la synchronisation. La revue affiche :

  • Détails de la connexion (compte externe ou sous-domaine connecté)

  • Éléments concernés après application des filtres Métadonnées

  • Destinations activées dans Cible

  • Règles d’audience et de ciblage

Donnez un nom clair à la source avant de confirmer — par exemple, « Confluence – Internal Support KB » ou « Notion – Product Docs (EMEA) ». Puis cliquez sur Mettre à jour et synchroniser.

Astuce : Vous pouvez rouvrir le même flux plus tard pour ajuster les paramètres Métadonnées, Cible ou Revue sans recréer la source.


Comment gérer les articles internes synchronisés

Une fois la synchronisation ou l’import terminé, vous recevrez une notification par e-mail et les articles internes apparaîtront dans Knowledge > Content sous la section « Content sources ».

La page Knowledge > Content affichant les sources de contenu synchronisées listées sous la section Content sources après une synchronisation réussie

Configurer les paramètres des articles internes

Allez dans Knowledge > Content, sélectionnez la source de contenu, puis ouvrez l’article interne. Configurez ses paramètres dans le panneau « Détails » à droite :

  • Données : Voir le type de contenu, la langue, la date de création, l’auteur, la dernière mise à jour et le coéquipier qui l’a mise à jour en dernier.

  • Fin : Pour activer/désactiver pour Fin et Copilot. Lorsqu’il est activé, le contenu devient disponible pour les clients via Fin Agent et pour les coéquipiers via Fin Copilot, respectivement.

    • Audience : Assurez-vous que les clients ne reçoivent que des réponses et ne voient que du contenu pertinent lorsqu’ils interagissent avec Fin ou Copilot.

  • Lien : Un lien vers l’article dans votre knowledge base interne (ex. Notion/Confluence/Guru).

  • Rapports : Suit la fréquence d’utilisation de ce contenu pour résoudre des conversations par Fin Agent.

  • Tags : Ajoutez une étiquette pour regrouper les articles internes et garder le contenu organisé (inclut les tags importés).

Le panneau Détails d’un article interne synchronisé montrant les paramètres de bascule Fin AI Agent et Copilot, les règles de ciblage d’audience, les tags et un lien vers l’article source

Note :

  • Les articles internes synchronisés ne peuvent pas être modifiés. Si vous souhaitez modifier le contenu, vous devez le faire depuis la source elle-même.

  • Les articles internes importés peuvent être modifiés et gérés dans Fin. Ils ne se synchronisent pas avec la source, donc toute modification doit être faite dans votre espace Fin.

Comment resynchroniser ou supprimer une source

Les articles internes provenant de sources externes synchronisent les modifications automatiquement, généralement en quelques minutes, et une synchronisation complète s’exécute toutes les 24 heures en sauvegarde. Les sources Confluence synchronisent les modifications en quelques minutes uniquement si les mises à jour en temps réel sont activées ; sinon, elles synchronisent une fois par jour. Vous pouvez aussi resynchroniser ou supprimer une source manuellement en allant dans Knowledge > Content, sélectionnez le menu à 3 points à côté de la source puis choisissez Resynchroniser ou Supprimer cette source.

Le menu à trois points à côté d’une source synchronisée dans Knowledge > Content montrant les options Resynchroniser et Supprimer cette source

Pour vérifier l’activité en temps réel d’une source, ouvrez son historique de synchronisation et regardez le résumé Mises à jour en direct. Il montre les 7 derniers jours d’activité en temps réel : nombre d’éléments créés, mis à jour et supprimés, échecs éventuels, date de la dernière mise à jour et éléments les plus récents. Si un élément ne peut pas être lu, il est ignoré et le reste de la source continue de se synchroniser.

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