API Confluence : possibilités et usage avec des agents IA
L'API REST de Confluence, éditée par Atlassian, permet de lire, créer et mettre à jour des pages, des espaces, des commentaires et des pièces jointes, et de faire des recherches. Les équipes qui tiennent leur base de connaissances dans Confluence et veulent l'utiliser dans d'autres systèmes l'utilisent. Sur Confluence Cloud, l'accès se fait par jeton d'API ou OAuth 2.0.
Ce que propose l’API Confluence
Pages
Lecture, création, mise à jour et historique des versions des pages.
Espaces
Consultation et organisation des espaces.
Recherche (CQL)
Recherche de contenu avec le langage de requête de Confluence.
Commentaires
Lecture et création de commentaires sur les pages.
Pièces jointes
Téléversement et téléchargement des fichiers joints.
Libellés
Étiquettes pour organiser et filtrer le contenu.
Comment accéder à l’API Confluence
- Avec les identifiants de votre entrepriseSur Confluence Cloud, l'API utilise l'e-mail de l'utilisateur avec un jeton d'API (authentification basique) ou OAuth 2.0 avec une application Atlassian. Les versions installées sur serveur utilisent des jetons personnels.
- L'agent hérite des permissions de l'utilisateur : les espaces restreints doivent le rester.
- Des limites de débit s'appliquent sur Confluence Cloud.
- Les pages peuvent contenir des données personnelles : évitez d'indexer les espaces RH sans nécessité.
Documentation officielle: developer.atlassian.com/cloud/confluence
Ce qu’un agent iTeam fait avec l’API Confluence
Des réponses avec leur source
L'agent répond aux questions sur les processus et le produit en citant la page Confluence d'où vient l'information.
Page de compte rendu et de décisions
Après une réunion, l'agent crée la page de compte rendu dans l'espace du projet, avec les décisions et les responsables.
Documentation périmée
L'agent signale les pages très consultées mais non mises à jour depuis longtemps, et prévient leur propriétaire.
Intégration guidée des nouveaux
Les nouveaux collaborateurs interrogent l'agent et reçoivent le bon parcours de pages pour leur équipe.
De l’identifiant à l’agent au travail, avec validation
Créez l'identifiant
Générez un jeton d'API pour un utilisateur d'intégration, ou configurez une application OAuth avec des périmètres de lecture et, si besoin, d'écriture.
Définissez les espaces dans iTeam
Dans le coffre d'iTeam, enregistrez l'identifiant et choisissez les espaces que chaque agent peut lire ou modifier.
Testez avec de vraies questions
Posez des questions du quotidien, vérifiez les sources citées, et n'autorisez la création de pages qu'ensuite.
Équipes IA prêtes à l’emploi qui utilisent Confluence
Support client et SAV
Chaque ticket reçoit une réponse fondée sur votre base Confluence, et les cas délicats arrivent chez la bonne personne avec un brouillon prêt.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Confluence
L'API Confluence est-elle gratuite ?
L'API n'est pas facturée à part : elle est disponible dans les offres Confluence, avec des limites qui varient selon l'offre.
Faut-il savoir programmer pour utiliser l'API Confluence avec iTeam ?
Non. iTeam se connecte à Confluence, et l'équipe de déploiement vous aide à choisir les espaces et les permissions.
Cela fonctionne-t-il avec Confluence Data Center ?
En général oui, tant que l'API est accessible depuis le réseau de l'intégration. Cela est vérifié lors du diagnostic.
