Connecteurs et authentification
Stocker les identifiants de vos outils tiers en sécurité et les réutiliser sur plusieurs actions.
Dernière mise à jour :
C’est quoi un connecteur ?
Imaginons que vous avez trois actions qui appellent toutes votre JIRA :
- créer un ticket de support ;
- mettre à jour un ticket ;
- consulter l’état d’un ticket.
Sans connecteur, il faudrait recopier vos identifiants JIRA dans chaque action. Trois fois la même clé, trois endroits à mettre à jour si elle change.
Un connecteur, c’est une fiche centralisée qui contient les identifiants d’un outil externe. Vous le configurez une fois, puis chaque action s’y rattache — y compris les actions de vos autres agents. Si la clé change, vous la mettez à jour dans le connecteur : toutes les actions suivent.
Les connecteurs se gèrent pour tout votre compte, depuis le menu du haut Intégrations.
Les connecteurs disponibles
| Connecteur | Ce que vous renseignez |
|---|---|
| JIRA | URL JIRA, Email API et Token API (jeton Atlassian) |
| Slack | URL du Webhook (une adresse secrète fournie par Slack) |
| Email (Resend) | Clé API Resend, Nom d’expéditeur et Email d’expédition |
| Calendly | Clé API (jeton personnel Calendly) |
| Webhook générique | URL de base, Type d’authentification (none, bearer ou header), Valeur d’authentification et Nom du header |
Chaque connecteur a aussi un Nom, pour vous y retrouver (ex. : « JIRA Production »).
Telegram, l’e-mail et le téléphone ne figurent pas au catalogue : ce sont des canaux de vos agents, qui se configurent depuis Canaux, dans le menu de gauche de l’agent. Les connecteurs créés par ces canaux apparaissent quand même dans Mes connecteurs.
Bientôt disponible. Pour certains outils, un bouton « Se connecter à … » vous permettra d’autoriser Sens Ai depuis la fenêtre de connexion de l’éditeur, sans copier de clé.
Bientôt disponible. Vous pourrez créer un connecteur personnalisé pour un outil absent du catalogue.
En attendant, pour un outil absent du catalogue : passez par le Webhook générique, ou cliquez sur Contactez un spécialiste dans l’encadré Besoin d’une intégration sur mesure ? de la page Intégrations.
Créer un connecteur
Depuis la page Intégrations
- Dans le menu du haut, cliquez sur Intégrations, puis sur l’onglet Catalogue.
- Trouvez l’outil (barre Rechercher un connecteur… ou filtres par catégorie), puis cliquez sur Configurer.
- Dans la fenêtre Nouveau connecteur …, renseignez le Nom et les champs de l’outil.
- Cliquez sur Créer.
Le connecteur apparaît dans l’onglet Mes connecteurs, avec le badge Actif.
Depuis une action
Pendant la création d’une action, section Configuration :
- s’il n’existe aucun connecteur compatible, le message « Aucun connecteur compatible configuré. » s’affiche avec le bouton Créer un connecteur ;
- sinon, choisissez-le dans la liste Connecteur, ou cliquez sur Nouveau pour en créer un autre.
Le connecteur créé est aussitôt sélectionné pour l’action.
Tester un connecteur
Le badge Actif s’affiche dès la création, avant tout test : vérifiez vos identifiants.
- Dans Intégrations › Mes connecteurs, cliquez sur Tester sous le connecteur. Le message du test s’affiche quelques secondes, par exemple « Connexion réussie. ».
- Ou cliquez sur Modifier, puis Enregistrer et tester : vos changements sont enregistrés, puis testés ; le message s’affiche avec la durée du test.
Ce que vérifie le test :
| Connecteur | Test |
|---|---|
| JIRA | Sens Ai lit votre profil JIRA avec l’e-mail et le jeton. |
| Email (Resend) | Sens Ai lit la liste de vos domaines chez Resend avec la clé. Une clé limitée à l’envoi est reconnue valide : « Clé valide, limitée à l’envoi. » |
| Calendly | Sens Ai lit votre profil Calendly avec la clé. |
| Webhook générique | Sens Ai vérifie que l’URL de base répond (requête HEAD, avec l’authentification du connecteur). « Connexion réussie. » ou « Serveur joignable (HTTP …). » ne prouve pas que votre outil accepte la clé. Une réponse 401 ou 403 fait échouer le test ; si une authentification est configurée, le message vous invite à vérifier le jeton ou l’en-tête. |
| Slack | Pas de test : la carte du connecteur n’a pas de bouton Tester. Testez plutôt l’action. |
Important : un test ne change le statut du connecteur que sur un résultat certain.
- Un test réussi met le connecteur en Actif.
- Un refus certain de vos identifiants (clé ou jeton refusé par JIRA, Resend ou Calendly) le passe en Erreur, avec le message « Identifiants refusés (HTTP …). Les actions qui utilisent ce connecteur sont suspendues jusqu’au prochain test réussi. » L’agent n’utilise plus ces actions : corrigez le connecteur, puis relancez le test.
- Tout autre échec laisse le statut tel quel : panne passagère (délai dépassé, service indisponible, trop de requêtes), adresse introuvable, réponse 401 ou 403 au test du Webhook générique, adresse privée ou non HTTPS. Le message le précise en général : « … le statut du connecteur n’a pas changé ».
Lier une action à un connecteur
Le connecteur se choisit à la création de l’action, dans la section Configuration (choisi d’office s’il n’y en a qu’un de compatible). Il ne se change plus ensuite : pour utiliser un autre connecteur, créez une nouvelle action.
Mettre à jour un connecteur
Quand un identifiant change (clé régénérée, jeton expiré) :
- Intégrations › Mes connecteurs › Modifier sur le connecteur.
- Les champs secrets affichent « •••••••• » : saisissez la nouvelle valeur, ou laissez vide pour conserver la valeur actuelle.
- Cliquez sur Enregistrer et tester (pour un connecteur qui a un test), ou sur Enregistrer.
Toutes les actions liées utilisent les nouvelles valeurs, sans autre manipulation.
Supprimer un connecteur
Cliquez sur l’icône de corbeille du connecteur. La fenêtre Supprimer le connecteur demande confirmation (Supprimer).
Un connecteur encore utilisé ne peut pas être supprimé : la fenêtre indique combien d’actions et de canaux s’en servent. Supprimez-les d’abord.
Sécurité : ce qui est stocké, et comment
- Clés, jetons et adresses secrètes : chiffrés au repos, avec une clé propre à votre compte.
- Jamais réaffichés : ni la page Intégrations ni les journaux d’exécution ne montrent vos clés.
Si vous soupçonnez une fuite (ordinateur compromis, départ d’un collaborateur) : régénérez la clé chez l’éditeur (JIRA, Resend…), puis mettez à jour le connecteur dans Sens Ai.
Connecteurs et offres
Le nombre de connecteurs n’est pas limité.
Étape suivante
Tester et déboguer une action en cas de problème : Tester et déboguer.