Confluence

Synchronisez vos pages Confluence pour que l’assistant dispose des politiques et procédures à jour.

Prérequis

• Accès Site Admin sur votre instance Atlassian Cloud.
• Un API token personnel (généré sur https://id.atlassian.com/manage-profile/security/api-tokens).
• L’URL Confluence (format https://entreprise.atlassian.net/wiki).
• L’adresse email liée au token.

Étapes côté Atlassian

1. Connectez-vous avec votre compte.
2. Ouvrez la page des API tokens et cliquez sur Create API token.
3. Donnez un nom (ex. Hestyna Confluence) et copiez le token.
4. Vérifiez que les espaces à synchroniser sont partagés avec votre compte.

Configuration dans Hestyna

1. Allez dans Catalogue → Intégrations → Confluence.
2. Renseignez :
   • URL de base (ex. https://entreprise.atlassian.net/wiki),
   • Email,
   • API token.
3. Testez la connexion, puis enregistrez.

Créer un index Confluence

1. Ouvrez Connaissance → Indexes et sélectionnez Confluence.
2. Cliquez sur Nouvel index.
3. Ajoutez les espaces (HR, IT) ou les IDs de pages.
4. Validez et lancez une synchronisation.

Bonnes pratiques

• Limitez-vous aux espaces nécessaires (les permissions suivront ceux disponibles pour votre compte).
• Nettoyez les macros obsolètes pour éviter les textes inutilisables.
• Utilisez les labels Confluence pour filtrer les contenus d’index.

Maintenance

• Les tokens API n’expirent pas mais renouvelez-les tous les 12 mois par sécurité.
• Activez les alertes Slack pour être prévenu des échecs d’ingestion.
• Surveillez la taille des espaces (les très gros espaces peuvent être découpés en plusieurs indexes).

Dépannage

Erreur	Explication	Solution
Unauthorized	Email/token incorrects ou espace non partagé.	Revérifiez les informations, partagez l’espace.
Rate limit	Trop de synchronisations simultanées.	Espacez les syncs, planifiez-les.
Page manquante	ID non valide ou permissions insuffisantes.	Copiez l’ID à partir de l’URL pageId=....

Étapes suivantes : Publier la connaissance