Intégrations
Connecter n'importe quelle API
Utilisez des services absents du catalogue Connecteurs, des API publiques à celles qui demandent une clé, ou ajoutez votre propre connecteur avec lequel l'IA pourra créer.
Le catalogue Connecteurs couvre plus de 100 services, mais votre app peut fonctionner avec presque tous les services qui ont une API (un moyen pour d'autres logiciels de communiquer avec eux). Cette page vous présente les trois façons de faire, de la plus rapide à la plus réutilisable.
| Votre situation | Ce qu'il faut faire |
|---|---|
| L'API est publique et n'a pas besoin de clé | Demandez-la dans le chat |
| L'API demande une clé, et vous n'en avez besoin que dans une seule app | Laissez l'IA vous demander la clé : elle est enregistrée comme un secret pour cette app |
| Vous utiliserez le service dans plusieurs apps, ou vous voulez que l'IA le comprenne bien | Créez votre propre connecteur sur la page Connecteurs |
Quel que soit votre choix, les clés ne sont utilisées que dans le code serveur de votre app. Elles ne se retrouvent donc pas dans le navigateur de vos visiteurs.
Utiliser une API publique
Beaucoup de services, comme la météo, les jours fériés ou les données ouvertes, n'ont pas besoin de clé. Nommez le service et dites ce que vous voulez en obtenir.
Affiche sur la page d'accueil les prévisions météo à 5 jours pour la ville du visiteur, avec l'API Open-Meteo.
Si l'IA a besoin de détails sur une API qu'elle connaît mal, collez dans le chat la partie utile de sa documentation, par exemple un exemple de requête et la réponse obtenue, ou joignez la documentation sous forme de fichier. Consultez Ajouter des images et des fichiers.
Utiliser une API qui demande une clé
Quand une fonctionnalité a besoin d'une clé pour un service absent du catalogue, l'IA affiche dans le chat une carte de clé avec le nom qu'elle utilisera, par exemple ACME_API_KEY. Collez la clé et cliquez sur Enregistrer, ou cliquez sur Passer pour continuer sans elle.
La carte le dit clairement : la clé est enregistrée de façon sécurisée et chiffrée, elle n'apparaît jamais dans le chat ni dans le code de votre app, et vous pourrez la changer plus tard dans Gérer → Secrets (les coéquipiers sont informés que le propriétaire du projet peut la changer).
Ajoute un formulaire de contact qui crée un nouveau prospect dans notre CRM via son API. Demande-moi la clé API.
Vous pouvez aussi ajouter vous-même des clés avant de le demander : ouvrez l'onglet Gérer, choisissez Secrets et ajoutez-en une avec Ajouter un secret. Votre aperçu prend en compte les changements automatiquement ; votre app publiée les reçoit à la prochaine publication. Consultez Secrets et clés API.
Ne tapez pas de clés dans un message du chat. Les messages du chat sont enregistrés avec votre projet. Utilisez plutôt la carte de clé ou Gérer → Secrets.
Créer votre propre connecteur
Si vous utiliserez un service dans plusieurs apps, ou si vous voulez que l'IA comprenne bien son API, ajoutez-le comme connecteur personnel. Vous décrivez l'API une seule fois ; ensuite, il fonctionne comme n'importe quel connecteur du catalogue : vous le connectez avec votre clé, vous l'activez ou le désactivez pour chaque app, et l'IA peut créer avec lui et lire ses informations pendant la création.
Sur la page Connecteurs, descendez jusqu'à Vos propres connecteurs et cliquez sur Créer un connecteur. Gardez la documentation de l'API du service sous la main, car vous aurez besoin de son adresse d'API et de la façon dont elle reçoit une clé. Aucune clé ne se met dans la description elle-même : vous vous connectez avec la vôtre à la fin.
Détails
Donnez-lui un Nom. Si vous le souhaitez, ajoutez une Description courte pour la carte et À quoi il sert (cela aide l'IA à savoir quand l'utiliser). Choisissez ensuite une Catégorie, ajoutez si vous le voulez un Lien vers la documentation de l'API et choisissez une Couleur. Le Nom de code détermine le nom des paramètres que vos apps lisent, comme
ACME_CRM_API_KEY. Il ne pourra plus être modifié ensuite.Comment il se connecte
Saisissez l'Adresse de l'API par laquelle commence chaque requête (elle doit commencer par
https://). Répondez ensuite à Comment le service vérifie-t-il votre identité ? : Jeton Bearer, Clé API dans un en-tête, Clé API dans l'adresse ou Nom d'utilisateur et mot de passe. Si le service a besoin de plus d'une valeur, comme un identifiant de compte, ajoutez-les sous Besoin de plus d'une valeur ?. Un aperçu affiche À quoi ressemble une requête.Requête de test
Choisissez une requête qui se contente de lire et qui a besoin de la clé, comme « qui suis-je » ou « liste mes éléments ». Buildliy l'exécute pour vérifier chaque clé avant de l'enregistrer : elle ne doit donc rien modifier. Sous Essayer (facultatif), vous pouvez coller une clé et cliquer sur Lancer la requête de test pour voir la réponse ; cette clé ne sert que pour le test et n'est pas enregistrée, sauf si vous vous connectez ensuite avec elle.
Qui voit les données
Choisissez Seulement moi : c'est personnel pour des données de compte privées (votre boîte de réception, vos notes ou votre banque), ou Tous ceux qui utilisent mon app : c'est partagé pour des données destinées à tout le monde, comme une liste de produits ou des annonces publiques.
Notes pour l'IA
Si vous le souhaitez, collez les parties de la documentation de l'API que l'IA doit connaître : points d'accès, exemples de requêtes et de réponses. Donnez à chaque note un Nom du fichier et, si vous le voulez, précisez Quand l'IA doit-elle le lire ? Vous pouvez ajouter jusqu'à 10 notes de 20 000 caractères chacune. L'IA voit le début de chaque note et lit la suite quand elle en a besoin. Ne collez jamais de clés ici.
Cliquez sur Créer un connecteur. La fenêtre de connexion s'ouvre ensuite, avec déjà remplie la clé que vous avez éventuellement saisie sous Essayer (facultatif) : saisissez votre clé si besoin et cliquez sur Connecter. Buildliy exécute votre requête de test avec la clé avant de l'enregistrer, puis la conserve chiffrée. Elle n'est utilisée que dans le code serveur de vos apps.
Utilise mon connecteur Acme CRM pour afficher mes 20 contacts les plus récents sur une page de tableau de bord, avec une barre de recherche.
Chacun de vos connecteurs personnels a sa carte, avec Connecter (Gérer une fois connecté, ou Reconnecter si la clé ne fonctionne plus), Modifier et un bouton de suppression. Supprimer un connecteur supprime aussi la clé que vous avez enregistrée pour lui, et les apps qui l'utilisent ne peuvent plus joindre le service tant que vous ne l'avez pas rajouté. Vous pouvez avoir jusqu'à 25 connecteurs personnels.
Si vous avez choisi Seulement moi : c'est personnel, l'IA place tout ce qui vient de ce service derrière la connexion de votre app. Une fois le connecteur connecté, la liste de contrôle avant lancement bloque la publication si le code de votre app l'utilise et que l'app n'a pas de connexion. Si l'app a bien une connexion, la liste vous rappelle de vérifier que vous seul (ou les personnes que vous choisissez) pouvez vous connecter, car une inscription libre permettrait à n'importe qui de voir les données.
Recevoir des événements d'un service
Certains services peuvent envoyer un message à votre app quand il se passe quelque chose, comme une nouvelle commande ou un paiement terminé. On appelle souvent ces messages des webhooks. Demandez à l'IA d'ajouter à votre app un endroit pour les recevoir. Si le service vous donne un secret de signature pour vérifier que les messages sont authentiques, l'IA vous le demande avec une carte de clé.
Ajoute un point de réception webhook qui reçoit les événements de nouvelle commande de notre système d'entrepôt et enregistre chaque commande dans la base de données.
Donnez au service l'adresse de votre app publiée, pas celle de l'aperçu, car l'aperçu ne fonctionne pas toujours. Consultez Publier votre app.
À lire aussi
Toujours bloqué ? Consultez la FAQ ou contactez-nous.