Connexions du compte

Une connexion est une clé de service (Resend, Stripe, OpenAI…) enregistrée dans ton compte, et non dans un seul projet. Tu la colles une fois, puis tu la relies à autant de projets que tu veux. Quand tu la remplaces, tous les projets reliés reçoivent la nouvelle clé.

La page Connecteurs (dans la barre latérale) rassemble trois sortes de services :

Sorte	Exemples	Utilisé par	Ce que tu enregistres
Connecteurs « ta propre clé »	Resend, Stripe, OpenAI, Slack…	Tes apps	Une ou plusieurs connexions (clés), reliées à tes projets
Google Sheets	Google Sheets	Tes apps	Ton compte Google, partagé par tous tes projets
Sources de contexte	Notion, Linear, Figma, Kameleoon	L’agent	Ton compte sur le service, lu par l’agent pendant ses réponses

Le filtre Utilisé par (Tous, Tes apps, L’agent) permet de n’afficher que l’une ou l’autre famille.

Enregistrer une connexion

1. Ouvre la page Connecteurs depuis la barre latérale. Depuis un projet, tu peux aussi passer par le menu + de la zone de saisie → Gérer les connecteurs (la page s’ouvre dans un nouvel onglet, ton projet reste ouvert).
2. Cherche le service (champ Rechercher un connecteur, ou /) et clique sur sa carte pour ouvrir sa fiche.
3. Dans la partie Configuration, le formulaire Nouvelle connexion s’affiche (ou clique sur Ajouter une connexion s’il y en a déjà une).
4. Donne-lui un nom si tu veux, par exemple « Stripe prod » (champ Nom (facultatif)). Sans nom, Highwind l’appelle d’après le service : « Stripe », puis « Stripe 2 », « Stripe 3 »…
5. Colle la ou les valeurs demandées. Le lien Où trouver la clé t’emmène à la bonne page chez le service. Quand une valeur commence toujours de la même façon, le libellé l’indique (« commence par … ») pour t’aider à repérer une mauvaise valeur collée.
6. Clique sur Ajouter. La clé est chiffrée, enregistrée, puis testée auprès du service (voir plus bas).

Une connexion créée depuis la carte d’un projet (L’agent a besoin de ta connexion …) est enregistrée de la même façon dans ton compte : si tu colles une clé que tu as déjà enregistrée, Highwind réutilise la connexion existante au lieu d’en créer une deuxième.

Une clé par connexion, plusieurs connexions par service

Chaque connexion garde une clé, chiffrée. Tu peux en avoir plusieurs pour un même service, par exemple une clé de test et une clé de production, et relier l’une ou l’autre selon le projet. Un compte peut garder jusqu’à 50 connexions.

Relier une connexion à un projet

Un projet utilise au plus une connexion par service. Trois façons de la relier :

• Depuis le chat : quand l’agent branche un service, la carte L’agent a besoin de ta connexion … propose Utiliser une connexion de ton compte. Un clic suffit.
• Depuis les paramètres du projet : Paramètres du projet → Connecteurs, ouvre la fiche du service. Tes connexions y sont listées (avec Utilisée par 1 projet, Reliée à aucun projet…) : clique sur Utiliser. La connexion reliée porte la mention Reliée et la phrase « Ce projet utilise la connexion « … » de ton compte ».
• Avec une nouvelle clé : dans la même fiche, Nouvelle clé crée une connexion dans ton compte et la relie au projet.

Une fois reliée, la clé apparaît aussi dans Paramètres du projet → Secrets, avec la mention Via la connexion « … ». Le serveur de l’app la lit comme n’importe quel secret (env.NOM), dans l’aperçu comme en ligne.

Pour qu’un projet n’utilise plus une connexion, clique sur Délier (dans la fiche du connecteur ou dans les secrets du projet). La connexion reste dans ton compte ; seul ce projet perd la clé.

Tester, remplacer, renommer, supprimer

Sur la page Connecteurs, la fiche d’un service liste ses connexions. Pour chacune, tu vois son nom, ses valeurs publiques éventuelles et les projets qui l’utilisent (Utilisée par … ou Reliée à aucun projet). Quatre actions :

Action	Ce qui se passe
Tester la clé	Highwind appelle le service avec la clé, sans effet de bord, et affiche le résultat.
Nouvelle clé	Tu colles la nouvelle valeur. Elle remplace l’ancienne dans tous les projets reliés (« La nouvelle clé remplacera l’ancienne dans les … projets reliés »), dans l’aperçu et dans les apps en ligne. Pour un service à plusieurs champs, un champ laissé vide reste inchangé.
Renommer	Change seulement le nom affiché (60 caractères au plus).
Supprimer	La clé est effacée définitivement. Si des projets l’utilisent : « Les … projets reliés n’auront plus cette clé : les fonctions qui l’utilisent s’arrêteront. »

Avant de supprimer une connexion

Supprimer une connexion retire la clé de tous les projets reliés, y compris de leurs apps en ligne : les formulaires, paiements ou envois qui en dépendent s’arrêtent aussitôt. Relie d’abord une autre connexion à ces projets si tu veux qu’ils continuent de fonctionner.

Le test des clés

Chaque fois qu’une clé est ajoutée ou remplacée, et quand tu cliques sur Tester la clé, Highwind fait un petit appel au service pour vérifier qu’elle fonctionne. Ce test n’a aucun effet de bord : il lit une information anodine (par exemple la liste de tes domaines chez Resend), sans envoyer d’e-mail, créer de paiement ni publier de message. La fiche de chaque connecteur précise ce que fait son test.

Trois résultats possibles :

• La clé fonctionne ;
• Clé refusée par le service : vérifie que tu as copié la bonne valeur, en entier, et qu’elle a les droits nécessaires ; puis utilise Nouvelle clé ;
• Service injoignable, réessaie plus tard : le service n’a pas répondu. La clé est quand même enregistrée ; ce n’est pas un refus.

Astuce

Si une fonction de ton app qui marchait s’arrête (plus d’e-mails, paiements refusés), commence par Tester la clé : une clé révoquée ou expirée chez le service est la cause la plus fréquente.

Google Sheets : un compte pour tous tes projets

Google Sheets ne fonctionne pas avec une clé mais avec ton compte Google, connecté une fois pour tout Highwind. Chaque projet a ensuite sa propre feuille. Sur la page Connecteurs, la fiche Google Sheets indique Connecté avec suivi de l’adresse du compte, et un bouton Déconnecter.

Le compte Google se connecte depuis un projet, quand une app enregistre dans Google Sheets (carte Connecte ton compte Google dans le chat, ou Paramètres du projet → Connecteurs). Tout le détail est dans Google Sheets.

Sources de contexte : pour l’agent, pas pour tes apps

Les sources de contexte (Notion, Linear, Figma, Kameleoon) apparaissent sur la même page, avec la mention Contexte pour l’agent et le filtre Utilisé par → L’agent. La différence est importante :

	Connecteurs (Tes apps)	Sources de contexte (L’agent)
Qui s’en sert	Le serveur de ton app, pour ses visiteurs	L’agent, pendant qu’il te répond
Quand	En permanence, dans l’aperçu et en ligne	Seulement quand ta demande y fait référence
Ce qui est enregistré	Une clé par connexion, reliée à des projets	Ton compte sur le service, pour tous tes projets
Droits	Ceux de la clé, côté serveur de l’app	Lecture seule (Kameleoon : modifications possibles si tu les autorises)

Une source se connecte depuis sa fiche avec le bouton Connecter, et se retire avec Déconnecter. Voir Sources de contexte.

Bon à savoir

• Les clés ne sont jamais réaffichées. Une fois enregistrée, une valeur secrète n’est plus visible, ni pour toi ni pour l’agent : pour la changer, remplace-la. Seules les valeurs publiques (par exemple un identifiant de mesure) sont affichées en clair sous le nom de la connexion.
• L’agent ne voit jamais tes clés. Il sait seulement si une clé est présente, et il peut te proposer de relier une connexion déjà enregistrée.
• Supprimer ton compte efface toutes tes connexions. Les clés restent valables chez les services eux-mêmes : révoque-les aussi chez eux si tu ne t’en sers plus.

Voir aussi

ConnecteursAjouter un service à ton app et la liste complète.

Secrets de l'appLes clés lues par le serveur de ton app.

Paramètres du projetConnecteurs, secrets et backend d'un projet.

Sources de contexteNotion, Linear, Figma et Kameleoon pour l'agent.