> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégrations d'automatisation

> Connectez Slack, Notion, Linear, Jira, Confluence et d'autres apps pour que les automatisations récupèrent du contexte en direct depuis les outils utilisés par votre équipe.

<Info>
  Les intégrations d'automatisation nécessitent un [plan Enterprise](https://mintlify.com/pricing?ref=automation-integrations).
</Info>

Les intégrations donnent aux [automatisations](/fr/automations/index) 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.

<div id="connection-scope">
  ## Portée de la connexion
</div>

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.

<div id="connect-an-integration">
  ## Connecter une intégration
</div>

Les administrateurs et les éditeurs peuvent connecter les intégrations partagées au nom de l'organisation.

1. Accédez à la page [Intégrations](https://app.mintlify.com/settings/organization/integrations) 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.

<div id="supported-integrations">
  ## Intégrations prises en charge
</div>

| Intégration     | Portée      |
| --------------- | ----------- |
| Confluence      | Partagée    |
| Google Calendar | Personnelle |
| Google Drive    | Personnelle |
| HubSpot         | Partagée    |
| Intercom        | Partagée    |
| Jira            | Partagée    |
| Linear          | Partagée    |
| Notion          | Partagée    |
| Plain           | Partagée    |
| Salesforce      | Partagée    |
| Slack           | Partagée    |

<div id="how-automations-use-integrations">
  ## Comment les automatisations utilisent les intégrations
</div>

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](/fr/automations/manage#integrations) 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.

<div id="permissions-and-access">
  ## Autorisations et accès
</div>

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.

<div id="what-the-agent-can-read-from-each-app">
  ### Ce que l'agent peut lire dans chaque application
</div>

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.

| Intégration     | Contenu auquel l'agent peut accéder                                                                                       |
| --------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Confluence      | Pages et pièces jointes dans les espaces que le compte connecté peut lire                                                 |
| Google Calendar | Événements des calendriers que l'utilisateur connecté peut consulter                                                      |
| Google Drive    | Fichiers et dossiers que l'utilisateur connecté peut consulter, y compris les Drive partagés                              |
| HubSpot         | Enregistrements CRM (contacts, entreprises, transactions, tickets) que le compte connecté peut lire                       |
| Intercom        | Conversations, contacts et articles du centre d'aide que le compte connecté peut lire                                     |
| Jira            | Tickets et commentaires des projets que le compte connecté peut lire                                                      |
| Linear          | Tickets, projets et commentaires des équipes que le compte connecté peut lire                                             |
| Notion          | Pages et bases de données explicitement partagées avec l'intégration Mintlify                                             |
| Plain           | Fils et enregistrements clients accessibles avec la clé API fournie                                                       |
| Salesforce      | Objets standard et personnalisés que le compte connecté peut lire                                                         |
| Slack           | Canaux publics auxquels l'espace de travail donne accès, ainsi que les canaux privés auxquels vous ajoutez l'app Mintlify |

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.

<div id="data-retention-after-disconnect">
  ## Conservation des données après déconnexion
</div>

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.

<div id="troubleshoot-a-failed-connection">
  ## Résoudre les problèmes de connexion
</div>

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](https://app.mintlify.com/settings/organization/integrations) 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.

<div id="disconnect-an-integration">
  ## Déconnecter une intégration
</div>

1. Accédez à la page [Intégrations](https://app.mintlify.com/settings/organization/integrations) 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.


## Related topics

- [Vue d'ensemble des automatisations](/docs/fr/automations/index.md)
- [Gérer les automatisations](/docs/fr/automations/manage.md)
- [Automatisations prédéfinies](/docs/fr/automations/reference.md)