Intégrations d'automatisation

Les intégrations donnent aux automatisations l’accès au contexte d’autres outils utilisés par votre équipe. Une fois connectées, une automatisation peut rechercher dans les fils Slack, lire des pages Notion, consulter des tickets Linear et récupérer du contexte depuis d’autres applications pour étayer ses mises à jour de contenu. Les intégrations se connectent de l’une des deux façons suivantes :

• Les intégrations partagées sont connectées une seule fois pour toute votre organisation et sont disponibles pour vos automatisations. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot et Plain se connectent toutes de cette manière.
• Les intégrations personnelles sont connectées par utilisateur. Chaque coéquipier autorise son propre compte. Google Calendar et Google Drive sont personnelles.

Les intégrations personnelles maintiennent les données propres à un utilisateur, comme les événements de calendrier, limitées à l’utilisateur qui a connecté l’intégration, plutôt que partagées à l’échelle de l’organisation. Les administrateurs et les éditeurs peuvent connecter les intégrations partagées au nom de l’organisation.

1. Accédez à la page Intégrations dans les paramètres de votre tableau de bord.
2. Repérez l’intégration que vous souhaitez connecter.
3. Cliquez sur Connect.
4. Suivez les invites OAuth pour autoriser Mintlify à accéder à votre compte.

Certaines intégrations ouvrent une étape de configuration supplémentaire avant que la connexion ne se termine. Jira, Confluence et Salesforce demandent l’URL ou le sous-domaine de votre espace de travail avant le démarrage du flux OAuth. Les fournisseurs reposant sur une clé API, comme Plain, vous invitent à coller une clé API. Les automatisations utilisent les intégrations connectées comme des outils. Lorsqu’une automatisation s’exécute, l’agent peut rechercher et récupérer du contenu depuis les applications connectées que vous avez activées pour cette automatisation afin de constituer le contexte de ses mises à jour. Pour activer des intégrations pour une automatisation, ouvrez ses paramètres et sélectionnez les intégrations que vous souhaitez que l’agent utilise dans la section Available integrations. Seules les intégrations déjà connectées pour votre organisation apparaissent dans la liste. Consultez Gérer les automatisations pour plus de détails. L’agent n’accède aux données des intégrations que lorsqu’elles sont pertinentes pour la tâche de l’automatisation. Il ne lit pas de manière proactive depuis les applications connectées. Chaque intégration demande les scopes OAuth ou les autorisations de clé API dont elle a besoin pour rechercher et récupérer du contenu depuis l’application connectée. Mintlify demande des scopes en lecture seule chaque fois que le fournisseur les propose. Vérifiez les scopes exacts sur l’écran de consentement OAuth avant d’autoriser la connexion. L’écran de consentement liste chaque autorisation reçue par l’intégration, et vous pouvez révoquer la connexion à tout moment depuis le tableau de bord ou depuis les propres paramètres d’intégration de l’application connectée. Si votre organisation restreint les applications que les utilisateurs peuvent autoriser, demandez à l’administrateur concerné (par exemple, votre administrateur Slack ou Google Workspace) d’autoriser l’intégration Mintlify avant de la connecter. L’agent hérite des accès du compte qui a autorisé la connexion. Il ne peut lire que du contenu auquel l’utilisateur qui a autorisé la connexion (pour les intégrations personnelles) ou le compte de l’espace de travail connecté (pour les intégrations partagées) a déjà accès dans l’application source. Pour limiter ce que l’agent peut voir, restreignez les autorisations du compte connecté dans l’application source. Par exemple, invitez l’app Slack de Mintlify uniquement dans des canaux spécifiques, ou partagez uniquement les pages Notion sélectionnées avec l’intégration.

​

Approuver l’app Mintlify dans Atlassian (Jira et Confluence)

Si votre organisation Atlassian restreint les apps du marketplace ou personnalisées, votre administrateur Atlassian doit approuver l’app Mintlify avant que quiconque puisse connecter Jira ou Confluence. Les utilisateurs qui tentent de se connecter sans approbation voient une erreur d’autorisation sur l’écran de consentement OAuth. Identité de l’app :

• Nom de l’app : Mintlify
• ID de l’app : 872a4b8e-9e83-474d-99f9-dc79112da145

Étapes pour l’administrateur :

1. Accédez à admin.atlassian.com et ouvrez votre organisation.
2. Accédez à Security > Data protection > Data security policy.
3. Vérifiez le paramètre Marketplace and custom app access control. S’il affiche Blocked ou Custom, l’app Mintlify doit être autorisée.
4. Modifiez la politique et définissez le contrôle sur Allowed, ou ajoutez une exception pour l’app Mintlify en utilisant l’ID de l’app ci-dessus.
5. Cliquez sur Activate pour appliquer la politique.

Une fois la politique active, un administrateur ou un éditeur peut finaliser la connexion Jira ou Confluence depuis la page Intégrations.

​

Scopes OAuth demandés par Mintlify

Mintlify utilise le flux OAuth 2.0 (3LO) d’Atlassian et demande des scopes en lecture seule afin que l’agent d’automatisation puisse rechercher et lire les tickets ou pages nécessaires pour étayer ses mises à jour. Mintlify ne demande pas de scopes d’écriture, de suppression ni d’administration. Scopes Jira : Scopes Confluence : La liste complète des scopes accordés à la connexion s’affiche sur l’écran de consentement OAuth d’Atlassian lorsqu’un utilisateur autorise l’intégration pour la première fois, et peut être consultée à tout moment dans votre console d’administration Atlassian sous Connected apps.

​

Ce que Mintlify fait avec les données

• L’accès est en lecture seule. Mintlify ne crée, ne modifie, ne fait pas transitionner et ne supprime jamais de tickets, commentaires, pages ou pièces jointes.
• L’accès est hérité de l’utilisateur autorisant. L’agent ne peut voir que les projets et espaces auxquels le compte Atlassian connecté a déjà accès. Pour restreindre la visibilité, limitez les autorisations de projet et d’espace du compte connecté dans Atlassian.
• L’accès est à la demande. L’agent ne lit depuis Atlassian que lorsqu’une exécution d’automatisation nécessite ce contexte. Mintlify ne parcourt pas et ne réplique pas Jira ou Confluence dans une copie durable.
• La révocation est immédiate. Déconnecter l’intégration dans le tableau de bord Mintlify, ou révoquer l’app dans l’administration Atlassian, coupe immédiatement tout accès futur.

Lorsque vous déconnectez une intégration, les automatisations perdent immédiatement la capacité de lire depuis cette application. Mintlify ne conserve pas de copie durable du contenu des intégrations. L’agent récupère les données à chaque exécution via le jeton OAuth actif ou la clé API, si bien que la déconnexion coupe l’accès futur. Le contenu qui est apparu dans des exécutions d’automatisation passées ou dans des pull requests reste en place (pages publiées, historique des PR). Modifiez ou supprimez directement les pages si vous souhaitez également supprimer ce contenu. Si une intégration cesse de fonctionner ou affiche une erreur dans le tableau de bord, le jeton OAuth sous-jacent a généralement expiré, l’application connectée l’a révoqué, ou ses scopes requis ont changé. Pour restaurer l’accès :

1. Accédez à la page Intégrations dans les paramètres de votre tableau de bord.
2. Repérez l’intégration concernée et cliquez sur Configure.
3. Cliquez sur Disconnect.
4. Cliquez sur Connect.
5. Terminez le flux OAuth.

Pour les fournisseurs à clé API comme Plain, générez une nouvelle clé API dans l’application source et collez-la dans la configuration de l’intégration. Si les automatisations ne peuvent toujours pas accéder aux données après la reconnexion, vérifiez que l’utilisateur autorisant a l’autorisation de consulter le contenu concerné dans l’application source.

1. Accédez à la page Intégrations dans les paramètres de votre tableau de bord.
2. Repérez l’intégration connectée que vous souhaitez déconnecter.
3. Cliquez sur Configure.
4. Cliquez sur Disconnect.

Déconnecter une intégration partagée la supprime pour tous les membres de votre organisation, et les automatisations perdent immédiatement l’accès à cet outil. Déconnecter une intégration personnelle ne supprime que votre propre connexion. Les autres coéquipiers qui ont connecté la même intégration conservent leur accès.