---
title: Intégrations personnalisées
summary: Définissez votre propre intégration pour une API interne ou tout fournisseur absent du catalogue intégré, avec les mêmes garanties de sécurité que les 90 intégrations livrées par défaut.
date: 2026-09-09
---

# Intégrations personnalisées

Définissez votre propre intégration pour une API interne ou tout fournisseur absent du catalogue intégré, avec les mêmes garanties de sécurité que les 90 intégrations livrées par défaut.

## Quand utiliser ceci

Le catalogue intégré couvre 90 services (voir le [Guide des intégrations](/fr/docs/guides/integrations-guide)). Pour tout le reste, une API interne, un fournisseur de niche, un fournisseur que personne n'a encore construit, définissez une intégration personnalisée plutôt que d'attendre qu'elle soit livrée. Activez la fonctionnalité pour votre organisation depuis **Paramètres → Intégrations personnalisées** ; elle est désactivée par défaut.

## Importer depuis une commande curl

Le chemin le plus rapide : collez une commande curl fonctionnelle directement depuis la documentation du fournisseur. L'assistant détecte la forme d'authentification, les en-têtes et l'URL de base pour vous, afin que vous le vérifiiez plutôt que de le ressaisir.

## La construire à la main

- **Bases** : un identifiant, un nom d'affichage, une catégorie, une description, et les capacités qu'elle déclare, afin qu'un agent puisse raisonner sur quand y recourir.
- **Authentification** : une clé API (en tant que jeton Bearer, en-tête personnalisé, paramètre de requête, ou HTTP Basic) ou OAuth 2.0, y compris PKCE pour les fournisseurs qui l'exigent (style Twitter/X) et des paramètres d'autorisation supplémentaires pour les fournisseurs qui conditionnent les jetons de rafraîchissement (le `access_type=offline` de Google, le `duration=permanent` de Reddit).
- **Champs** : les identifiants que le membre qui se connecte fournit. Chaque champ est chiffré au repos par défaut ; marquer un champ comme non secret (un ID de compte ou une région en clair, par exemple) n'est autorisé que pour les champs qui ne sont clairement pas des identifiants. Un champ nommé quelque chose comme token, secret, key, password ou credential est bloqué pour cette classification sauf remplacement explicite.
- **Hôtes API** : les noms d'hôte que cette intégration est autorisée à joindre, avec caractères génériques pris en charge, le même modèle de sortie que chaque intégration intégrée.
- **Vérification** : un point de terminaison sollicité au moment de la connexion, pour confirmer que les identifiants d'un membre fonctionnent réellement avant que l'intégration ne soit considérée comme connectée.

## Brouillons et publication

Une nouvelle intégration s'enregistre comme brouillon, invisible à tout agent, jusqu'à ce que vous la publiiez. Publier est ce qui la fait apparaître sous **Paramètres → Intégrations** pour que les membres connectent leurs propres identifiants, et ce qui donne l'accès aux agents liés. Dépublier la masque à nouveau sans rien supprimer : les identifiants chiffrés déjà connectés sont conservés, donc republier restaure l'accès plutôt que de repartir de zéro.

## Les mêmes garanties de sécurité

Une intégration personnalisée hérite de tout ce qu'obtient une intégration intégrée : identifiants chiffrés par ligne, courtier d'identifiants, liste d'autorisation de sortie, liaison par agent, et le même journal d'audit. Définir votre propre intégration ne signifie pas sortir du modèle de sécurité de la plateforme, cela signifie l'étendre à un service de plus.

## À voir aussi

- [Guide des intégrations](/fr/docs/guides/integrations-guide) : les 90 intégrations intégrées que ceci étend
- [Sécurité](/fr/docs/guides/security) : les limites dans lesquelles chaque intégration, intégrée ou personnalisée, opère