> ## 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 de l'agent

> Connectez Slack, Notion, Linear, Jira, Confluence et d'autres apps pour que l'agent utilise le contexte en direct lors des réponses et mises à jour.

Les intégrations de l'agent donnent à l'agent l'accès au contexte d'autres outils utilisés par votre équipe. Une fois connectées, l'agent 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 réponses et 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. N'importe quel membre de l'équipe peut demander à l'agent de les utiliser. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom 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, et l'agent ne peut utiliser une intégration personnelle qu'au nom de l'utilisateur qui l'a connectée. Google Calendar est personnelle.

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>

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

Les administrateurs et les éditeurs peuvent connecter les intégrations partagées au nom de l'organisation. Chaque coéquipier connecte les intégrations personnelles individuellement : connecter Google Calendar ne l'active que pour vos propres invites, pas pour le reste de votre organisation.

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

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

<div id="how-the-agent-uses-integrations">
  ## Comment l'agent utilise les intégrations
</div>

L'agent utilise les intégrations connectées comme des outils. Lorsque vous posez une question à l'agent ou que vous lui confiez une tâche, il peut rechercher et récupérer du contenu depuis vos applications connectées pour construire le contexte.

Par exemple :

* "Résume le fil Slack sur la migration de l'API v2 et rédige-le pour la base de connaissances."
* "Consulte le ticket Linear pour cette fonctionnalité et documente son comportement."
* "Qu'a décidé l'équipe au sujet de la limitation du débit ? Vérifie Slack."

L'agent n'accède aux données des intégrations que lorsqu'elles sont pertinentes pour la demande. Il ne lit pas les applications connectées de manière proactive.

<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 en propose.

Examinez les scopes exacts sur l'écran de consentement OAuth avant d'autoriser la connexion. L'écran de consentement liste toutes les autorisations dont disposera l'agent, et vous pouvez révoquer la connexion à tout moment depuis le tableau de bord ou depuis les paramètres d'intégrations de l'application connectée elle-même.

Si votre organisation restreint les applications que les utilisateurs peuvent autoriser, demandez à l'administrateur concerné (comme votre administrateur Slack ou Google Workspace) d'autoriser l'intégration Mintlify avant de la connecter.

<div id="troubleshoot-a-failed-connection">
  ## Dépanner une connexion en échec
</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é, a été révoqué dans l'application connectée ou a vu ses scopes requis modifiés.

Pour rétablir l'accès :

1. Accédez à la page [Intégrations de l'agent](https://app.mintlify.com/settings/organization/integrations) de votre tableau de bord.
2. Repérez l'intégration concernée et cliquez sur **Configure**.
3. Cliquez sur **Disconnect**, puis sur **Connect** à nouveau, et complétez le flux OAuth.

Pour les fournisseurs reposant sur une 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 l'agent ne parvient toujours pas à accéder aux données après la reconnexion, vérifiez que l'utilisateur qui autorise dispose des autorisations nécessaires pour consulter le contenu pertinent dans l'application source.

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

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

La déconnexion d'une intégration partagée la supprime pour tous les membres de votre organisation, et l'agent perd immédiatement l'accès à cet outil.

La déconnexion d'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, et l'agent peut continuer à utiliser l'intégration en leur nom.


## Related topics

- [Intégrations d’assistance](/docs/fr/integrations/support/overview.md)
- [Intégrations de confidentialité](/docs/fr/integrations/privacy/overview.md)
- [Personnaliser le comportement de l'agent](/docs/fr/agent/customize.md)