> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Identifiants et intégrations

> Gérez vos connexions et vos secrets, puis accordez-les aux applications et aux automatisations qui en ont besoin.

<Note>Disponible avec tous les forfaits Cloud ; l’auto-hébergement nécessite Business ou une offre supérieure.</Note>

Lorsqu’une application ou une automatisation appelle un service externe, elle utilise **vos identifiants**. Ceux-ci vous appartiennent et non à l’application ou à l’automatisation, et se déclinent en deux types :

* **Connexions** : comptes tiers que vous autorisez auprès de Teable via OAuth, par exemple Google, Slack ou Feishu.
* **Secrets** : chaînes que vous enregistrez vous-même, par exemple une clé API ou un jeton d’accès.

Les identifiants se gèrent dans **Paramètres** → **Intégrations**, d’où vous les accordez à telle application ou telle automatisation. Une fois l’autorisation accordée, toute personne qui exécute cette application ou cette automatisation utilise les identifiants de la personne qui les a accordés. La valeur n’est montrée à personne, et les résultats de test d’une automatisation la masquent.

## Gérer vos connexions et vos secrets

Cliquez sur votre avatar en bas à gauche, puis ouvrez **Paramètres** → **Intégrations**. La page comporte trois sections : **Mes connexions**, **Mes secrets** et **Applications tierces que vous avez autorisées**.

**Ajouter un secret** demande :

| Champ           | Description                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Clé**         | Commence par une majuscule ; majuscules, chiffres et traits de soulignement uniquement                |
| **Valeur**      | Accessible en écriture seule après l’enregistrement ; saisissez une nouvelle valeur pour la remplacer |
| **Description** | Facultative, pour noter à quoi sert le secret                                                         |

Une connexion s’ajoute avec **Connecter un nouveau compte**. Quand une autorisation expire, la connexion propose **Reconnecter**.

Chaque identifiant indique combien de ressources l’utilisent actuellement. **Afficher** ouvre la liste des applications et automatisations concernées, où vous pouvez **Retirer l’autorisation** pour l’une d’elles.

## Accorder un identifiant à une application ou une automatisation

Ouvrez le panneau d’identifiants de la ressource :

* **Applications** : dans le panneau de chat de l’App Builder, ouvrez **+** → **Plus** → **Identifiants et configuration**.
* **Automatisations** : ouvrez le workflow et cliquez sur **Identifiants et configuration** dans l’onglet **Édition**.

**Accorder** propose trois voies : **Accorder un secret existant** choisit l’un de vos secrets ou l’une de vos connexions ; **Ajouter un secret** en crée un et l’accorde aussitôt ; vous pouvez aussi choisir un service dans la liste **Services**, ce qui lance un parcours OAuth pour un service non connecté et accorde directement celui marqué **Connecté**.

Chaque autorisation demande un **Nom de la variable**, l’alias de cet identifiant dans cette application ou automatisation. Les règles de nommage sont celles d’une clé de secret, et c’est ce nom que lit le code.

Le panneau peut aussi afficher des emplacements **Pas encore lié**. Copier une application, dupliquer un workflow, importer ou dupliquer une base reprend les alias attendus par le code, mais aucun identifiant. **Lier le mien** fournit les vôtres pour que l’application ou l’automatisation fonctionne.

Quand un alias porte les identifiants de quelqu’un d’autre, **Remplacer par le mien** les reprend. **Retirer seulement l’autorisation (garder l’emplacement)** rompt le lien et conserve l’emplacement, sans toucher au code.

<Info>Modifier les autorisations d’une ressource demande le droit de modification sur cette application ou cette automatisation. Vous ne pouvez accorder que vos propres identifiants.</Info>

## Lire un identifiant dans le code

| Contexte                              | Comment le lire                                                                          |
| ------------------------------------- | ---------------------------------------------------------------------------------------- |
| Scripts d’automatisation              | Variable d’environnement, par exemple `process.env.EXTERNAL_API_KEY`                     |
| Champs de saisie d’une automatisation | Cliquez sur **Insérer un secret** à côté du champ et choisissez un secret accordé        |
| Secrets dans une application          | Le code côté serveur lit `process.env.MY_API_KEY`                                        |
| Connexions dans une application       | Le code côté serveur appelle `getConnectionToken('ALIAS')` pour obtenir un jeton d’accès |

Si vous collez dans un champ d’automatisation une valeur qui ressemble à une clé, Teable l’enregistre comme votre secret et laisse une référence à la place, de sorte que le texte en clair n’entre pas dans la configuration du workflow. Pour conserver le texte tel quel, cliquez sur **Annuler** dans la notification.

## Demandes d’identifiants dans le Chat IA

Quand l’IA a besoin d’un compte externe, elle épingle dans la conversation une carte de demande d’identifiant qui précise le service pour lequel elle veut une connexion, ou l’alias pour lequel elle veut un secret. Vous pouvez :

* **Connecter mon compte** : lancer un parcours OAuth ; la nouvelle connexion est accordée automatiquement à la ressource.
* **Accorder mon…** : utiliser une connexion ou un secret que vous possédez déjà.
* **Ignorer** : ne pas fournir l’identifiant. L’IA poursuit les parties qui n’en dépendent pas.

## Remplacer, supprimer et quitter un espace

Avant que vous remplaciez la valeur d’un secret, supprimiez un secret ou déconnectiez une connexion, Teable liste les applications et automatisations qui l’utilisent encore. La suppression et la déconnexion les mettent aussitôt hors service : accordez-leur d’abord un autre identifiant si elles doivent continuer à tourner. L’ancienne valeur d’un secret est irrécupérable.

Une fois la nouvelle valeur enregistrée, une automatisation la prend à sa prochaine exécution ; une application la prend au redémarrage de son environnement de prévisualisation, et une application publiée seulement après une nouvelle publication.

Si vous quittez un espace où une application ou une automatisation utilise encore vos identifiants, la page **Intégrations** le signale avec **Vous avez quitté cet espace**. Cliquez sur **Retirer l’autorisation** pour cesser de les fournir.