Passer au contenu principal
Les intégrations d’automatisation nécessitent un plan Enterprise.
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.

​
Portée de la connexion

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.

​
Connecter une intégration

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, et les fournisseurs reposant sur une clé API, comme Plain, vous invitent à coller une clé API.

​
Intégrations prises en charge

​
Comment les automatisations utilisent les intégrations

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.

​
Autorisations et accès

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.

​
Ce que l’agent peut lire dans chaque application

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.

​
Conservation des données après déconnexion

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.

​
Résoudre les problèmes de connexion

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.

​
Déconnecter une intégration

  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.