Connecteurs

Un connecteur branche un service externe à ton app : envoyer un e-mail avec Resend, encaisser un paiement avec Stripe, résumer un texte avec OpenAI, publier un message dans Slack… Tu le demandes dans le chat, l’agent écrit le code, et tu fournis ta clé une seule fois. Highwind propose plus de 50 connecteurs prêts à l’emploi, et l’agent sait aussi brancher un service qui n’est pas dans la liste.

Comment ça marche

Ta propre clé

La plupart des connecteurs utilisent ta clé d’API. Elle est chiffrée, rangée dans les secrets du projet et lue seulement par le serveur de ton app. Le service te facture directement, pas Highwind.

Google Sheets, sans clé

Google Sheets passe par la passerelle Highwind : tu connectes ton compte Google une fois et Highwind crée la feuille de ton app dans ton Drive. Aucune clé à aller chercher.

Côté serveur

Les appels partent du serveur de ton app (routes /api), jamais du navigateur des visiteurs. L’agent ajoute ce serveur tout seul s’il manque.

Une clé, tous tes projets

Une clé collée une fois est enregistrée dans ton compte : tu la relies ensuite à n’importe quel autre projet en un clic.

Connecteurs et sources de contexte

Les connecteurs servent à ton app : c’est elle qui appelle le service, dans l’aperçu comme en ligne. Les sources de contexte (Notion, Linear, Figma, Kameleoon) servent à l’agent : il les lit pour comprendre ce que tu veux construire, mais ton app ne les utilise pas.

Ajouter un connecteur à ton app

1. Mentionne le service dans ta demande. Dans la zone de saisie, tape @ ou ouvre le menu + → Connecteurs, puis choisis le service dans la liste (tu peux chercher par nom ou par catégorie). Il s’insère dans ton message sous forme de pastille. Complète ta demande :

   @Resend Ajoute un formulaire de contact qui m'envoie chaque message par e-mail.

   Tu peux aussi simplement écrire le nom du service (« envoie-moi un e-mail avec Resend ») : l’agent choisit lui-même le bon connecteur quand une fonction en a besoin.

2. L’agent branche le connecteur. Il ajoute le serveur de l’app si besoin (étape Ajoute un serveur à l’app), écrit le code qui appelle le service et suit le mode d’emploi propre à ce service (montants fixés côté serveur, destinataires vérifiés, etc.).

3. Donne ta clé dans la carte du chat. Une carte L’agent a besoin de ta connexion … apparaît sous la réponse. Deux possibilités :

   • choisir une connexion déjà enregistrée dans ton compte (Utiliser une connexion de ton compte) ;
   • ou coller une nouvelle clé (ou colle une nouvelle clé :), puis cliquer sur Ajouter. Elle est chiffrée et enregistrée dans ton compte, réutilisable dans tes autres projets.

   La carte indique à quoi sert la valeur et où la trouver chez le service (par exemple « resend.com → API Keys → Create API Key »).

4. Highwind vérifie la clé. Juste après l’ajout, la clé est testée auprès du service, sans effet de bord (aucun e-mail envoyé, aucun paiement créé). Tu vois l’un de ces messages :

   • Clé … vérifiée : elle fonctionne.
   • … a refusé cette clé. Vérifie-la, puis remplace-la ;
   • … ne répond pas : la clé est enregistrée mais n’a pas pu être vérifiée (le service est momentanément injoignable).

5. Teste dans l’aperçu. La fonction marche tout de suite dans l’aperçu, et dans ton app publiée après la prochaine publication.

Pas besoin d’attendre la clé

L’agent écrit le code sans attendre ta clé. Tant qu’elle manque, la fonction répond une erreur claire et l’agent te rappelle dans son résumé ce qu’il reste à ajouter. Tu peux coller la clé plus tard, depuis la carte ou depuis Paramètres du projet → Connecteurs.

Quand l’agent te propose un choix

Pour une liste d’attente, des inscriptions ou des commandes, l’agent peut te proposer une carte À toi de choisir avant de construire. Plusieurs options peuvent s’appuyer sur un connecteur :

• Dans une feuille Google Sheets : chaque envoi s’ajoute comme une ligne dans une feuille de ton Google Drive ;
• Par e-mail (Resend) : tu reçois chaque envoi par e-mail ;
• Dans Slack : chaque envoi est publié dans un canal Slack de ton choix.

Les autres options sont une base de données (backend) ou des données gardées dans le navigateur pour l’instant. Voir Les choix de données.

La page Connecteurs

La page Connecteurs (lien Connecteurs dans la barre latérale, ou menu + → Gérer les connecteurs depuis un projet) rassemble tous les services que tes apps et l’agent utilisent.

• Recherche : le champ Rechercher un connecteur filtre par nom, catégorie ou description. Raccourci : appuie sur / pour y aller directement.
• Filtres (à gauche, combinables, avec le nombre de résultats de chaque option) :
  • Statut : Tous, Connectés, Disponibles ;
  • Utilisé par : Tes apps (les connecteurs) ou L’agent (les sources de contexte) ;
  • Catégorie : Données, E-mails, Paiements, IA, Web, Notifications, Messagerie, Cartes, Analytics, CRM et ventes, Productivité, Contenu et boutique, Banque et compta, Contexte pour l’agent.
• Fiche d’un connecteur : clique sur une carte (Voir la fiche) pour voir sa présentation, ce que ton app peut en faire, ses Permissions (Autorisé et Jamais), sa Configuration et ses Détails (clés attendues, type d’accès, facturation, site du service).

Une connexion enregistrée ici est réutilisable dans tous tes projets : c’est le détail de Connexions du compte.

Valeurs secrètes et valeurs publiques

Chaque connecteur attend une ou plusieurs valeurs (une clé d’API, parfois un identifiant ou une adresse). Elles sont de deux sortes :

	Secrète (la plupart)	Publique (marquée public)
Exemples	Clé API Resend, clé secrète Stripe, jeton Slack	Identifiant de mesure Google Analytics, jeton public Mapbox restreint à ton domaine
Stockage	Chiffrée dans les secrets du projet	Dans les secrets du projet
Affichage	Jamais réaffichée après l’enregistrement	Affichée en clair sur la page Connecteurs
Qui la lit	Seulement le serveur de ton app	Le serveur, et l’agent peut l’écrire dans le code du navigateur

Pour une valeur secrète, l’agent voit seulement si elle est présente, jamais sa valeur. Elle n’est jamais envoyée au navigateur des visiteurs, ni utilisée dans un autre projet que ceux auxquels tu la relies.

Attention

Ne colle jamais une clé secrète directement dans le chat : l’agent n’en a pas besoin, et ton message serait gardé dans l’historique du projet. Utilise toujours la carte ou les paramètres du projet.

Tous les connecteurs

Clique sur un nom pour ouvrir sa fiche : à quoi il sert, ce que l’agent peut faire et ne fait jamais, les valeurs à renseigner et où les trouver.

Données

Connecteur	À quoi il sert
Google Sheets	Enregistrer des données dans une feuille de ton Google Drive (inscriptions, commandes…). Voir aussi le guide Google Sheets.
Airtable	Une base Airtable comme données de ton app, modifiable comme un tableur.
Notion	Tes pages et bases Notion comme contenu de ton app.
Neon	Ta base Postgres Neon, interrogée par le serveur de ton app.

E-mails

Connecteur	À quoi il sert
Resend	Envoyer des e-mails : formulaires de contact, confirmations, notifications.
Brevo	E-mails, SMS et listes de contacts, avec un service français.
Mailchimp	Newsletter : inscrire tes visiteurs à ton audience Mailchimp.
Mailgun	E-mails transactionnels depuis ton domaine, avec Mailgun.
Loops	E-mails pour applications : contacts, automatisations, transactionnels.
Klaviyo	Marketing e-commerce : profils, inscriptions, scénarios.
beehiiv	Ta newsletter beehiiv : inscriptions et derniers articles sur ton site.

Notifications et messagerie

Connecteur	Catégorie	À quoi il sert
Slack	Notifications	Publier des messages dans un canal Slack.
Discord	Notifications	Publier des messages dans un salon Discord.
Telegram	Messagerie	Un bot Telegram : notifications et réponses automatiques.
Twilio	Messagerie	SMS, WhatsApp et vérification des numéros par code.
WhatsApp Business	Messagerie	Envoie des messages WhatsApp depuis ton app.

Paiements

Connecteur	À quoi il sert
Stripe	Encaisser des paiements avec la page de paiement Stripe.
Mollie	Paiements européens : carte, Bancontact, iDEAL, Apple Pay…
PayPlug	Paiement en ligne français, avec page de paiement hébergée.
SumUp	Paiement en ligne pour les commerçants SumUp.
HelloAsso	Dons, adhésions et billetterie pour les associations.

IA

Connecteur	À quoi il sert
OpenAI	Fonctions d’IA : résumés, réponses, génération de texte.
Anthropic (Claude)	Les modèles Claude pour les fonctions d’IA de ton app.
Mistral AI	IA française : résumés, réponses, extraction, recherche.
Perplexity	Recherche web et réponses de l’IA avec leurs sources.
ElevenLabs	Voix naturelles : lecture de texte et transcription audio.
Replicate	Modèles d’IA ouverts : images, vidéo et audio générés.
LlamaParse	Lire des PDF et documents : texte propre, tableaux, champs.

Web

Connecteur	À quoi il sert
Firecrawl	Lire le contenu de pages web (veille, import, résumé d’un lien).
Apify	Robots de collecte prêts à l’emploi : Google Maps, sites, réseaux…
Algolia	Recherche instantanée dans ton app, avec Algolia.

Productivité

Connecteur	À quoi il sert
Calendly	Prise de rendez-vous en ligne avec ton agenda Calendly.
Tally	Formulaires Tally : intégrés au site, réponses dans l’app.
Typeform	Formulaires Typeform : intégrés au site, réponses dans l’app.
Yousign	Signature électronique française : faire signer un document en ligne.
Asana	Gestion de projet Asana : tâches créées depuis ton app.
GitHub	API GitHub : issues, releases et fichiers de tes dépôts.
n8n	Déclenche tes automatisations n8n depuis ton app.

Analytics

Connecteur	À quoi il sert
Google Analytics	Statistiques de visite avec Google Analytics, après consentement.
PostHog	Analytics produit et feature flags, en Europe si tu veux.
Kameleoon	A/B tests, personnalisation et feature flags avec Kameleoon. Voir aussi la section Kameleoon.

CRM et ventes

Connecteur	À quoi il sert
ActiveCampaign	Automatisation marketing et CRM : contacts, listes, tags.
HubSpot	CRM HubSpot : contacts et affaires alimentés par ton app.
Pipedrive	CRM commercial Pipedrive : contacts, prospects et affaires.
Zendesk	Support client Zendesk : tickets créés depuis ton app.

Contenu et boutique

Connecteur	À quoi il sert
WordPress	Ton WordPress comme contenu de ton app (articles, pages, images).
Contentful	Ton contenu Contentful (articles, pages, médias) affiché dans ton app.
WooCommerce	Ta boutique WooCommerce : produits et commandes dans ton app.
PrestaShop	Ta boutique PrestaShop : produits, stock et commandes dans ton app.

Banque et compta

Connecteur	À quoi il sert
Qonto	Ton compte pro Qonto en lecture : soldes et transactions.
Pennylane	Comptabilité française : créer et suivre tes factures Pennylane.

Cartes

Connecteur	À quoi il sert
Google Maps	Cartes, recherche de lieux et adresses avec Google Maps.
Mapbox	Cartes personnalisées, géocodage et images de cartes avec Mapbox.

Contexte pour l’agent

Ces quatre services apparaissent aussi sur la page Connecteurs et dans le menu +, mais ce sont des sources de contexte : l’agent les lit, ton app ne les appelle pas.

Source	Ce que l’agent lit
Notion	La page ou la spec que tu cites.
Linear	Le ticket ou le projet que tu cites.
Figma	La maquette dont tu colles le lien.
Kameleoon	Tes expériences, feature flags et objectifs Kameleoon.

Deux Notion et deux Kameleoon

Le menu des connecteurs propose deux entrées Notion et deux entrées Kameleoon. Celle de la catégorie Données (Notion) ou Analytics (Kameleoon) est le connecteur de ton app ; celle de la catégorie Contexte pour l’agent est la source de contexte. Choisis selon ce que tu veux : afficher ton contenu Notion dans ton app, ou faire lire une spec Notion à l’agent.

Un service qui n’est pas dans la liste

L’agent peut brancher n’importe quel service qui a une API, même absent du catalogue. Demande-le simplement :

Quand quelqu'un s'inscrit, ajoute-le à ma liste sur Systeme.io avec leur API.

L’agent ajoute alors le serveur de l’app (étape Ajoute un serveur à l’app), puis te demande la clé avec une carte L’agent a besoin d’une clé (étape Demande la clé …). Colle la valeur et clique sur Ajouter : elle est chiffrée, jamais montrée à l’agent, et rangée dans Paramètres du projet → Secrets.

Différences avec un connecteur du catalogue :

• la clé est enregistrée dans ce projet seulement, pas dans ton compte ;
• il n’y a pas de test automatique de la clé : vérifie dans l’aperçu que la fonction marche ;
• l’agent n’a pas de mode d’emploi tout prêt : donne-lui le lien de la documentation de l’API si tu l’as.

Voir Secrets de l’app et Le serveur de l’app.

Bon à savoir

• Facturation : les connecteurs « ta propre clé » sont facturés par le service, sur ton compte chez lui, pas par Highwind. Les crédits Highwind ne servent qu’au travail de l’agent. Le coût de chaque service est indiqué dans sa fiche (Facturation).
• Aperçu et app en ligne : une clé ajoutée ou remplacée est prise en compte tout de suite dans l’aperçu, et aussi dans l’app publiée si elle a déjà un serveur en ligne.
• Retrouver l’état des connecteurs d’un projet : Paramètres du projet → Connecteurs montre chaque service avec Clé ajoutée ou Pas encore de clé, et un bouton Tester la clé.

Une clé de test, une clé de production

Tu peux enregistrer plusieurs connexions pour un même service, par exemple « Stripe test » et « Stripe prod ». Relie la clé de test pendant que tu construis, puis passe à la clé de production avant de partager ton app.

Voir aussi

Connexions du compteEnregistrer une clé une fois et la relier à plusieurs projets.

Google SheetsEnregistrer les données de ton app dans une feuille de ton Drive.

Secrets de l'appOù sont rangées les clés et qui peut les lire.

Sources de contexteFaire lire Notion, Linear, Figma ou Kameleoon à l'agent.