Connecteurs et authentification

C’est quoi un connecteur ?

Imaginons que vous avez trois actions qui appellent toutes la même API Jira :

• Créer un ticket de support.
• Mettre à jour un ticket.
• Chercher l’état d’un ticket.

Sans connecteur, vous devriez recopier vos identifiants Jira dans chaque action. Trois fois la même clé. Trois endroits à mettre à jour si la clé 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. Si la clé change, vous la mettez à jour dans le connecteur — toutes les actions sont à jour automatiquement.

Les types d’authentification supportés

Clé API (le plus courant)

Vous renseignez une clé fournie par votre outil (ex. : Jira, HubSpot, SendGrid). Sens-AI l’inclut dans chaque appel sous forme d’en-tête HTTP.

OAuth (pour Google, Microsoft, et certaines plateformes)

Vous autorisez Sens-AI à accéder à votre compte en passant par la fenêtre de connexion officielle de l’éditeur (Google, Microsoft, Salesforce, HubSpot…). Pas de mot de passe stocké chez nous — un jeton d’accès révocable.

Webhook simple (sans authentification)

Pour les webhooks publics ou les services qui acceptent des appels anonymes (vos propres serveurs internes derrière un VPN par exemple).

Authentification basique (HTTP Basic Auth)

Couple identifiant + mot de passe envoyé à chaque appel. Plus rare aujourd’hui, mais encore utilisé par certaines APIs anciennes.

Créer un connecteur

Étape 1 — Démarrer

Votre bot → Actions → onglet Connecteurs → Ajouter un connecteur.

Étape 2 — Choisir le modèle

Si l’outil que vous voulez connecter est dans la liste (Jira, HubSpot, Slack, Notion, Airtable, Google Sheets, Mailchimp, etc.) : choisissez-le. La configuration est pré-remplie au maximum.

Si votre outil n’y est pas : cliquez sur Connecteur personnalisé.

Étape 3 — Remplir les identifiants

Pour une clé API typique :

• URL de base — la racine de l’API (ex. : https://votre-domaine.atlassian.net/rest/api/3).
• Type d’authentification — Bearer Token, API Key, etc.
• Valeur du token — collez votre clé.

Pour OAuth :

• Cliquez sur Se connecter à [outil].
• Une fenêtre s’ouvre, vous vous authentifiez chez l’éditeur.
• Vous autorisez Sens-AI.
• Le connecteur est actif.

Étape 4 — Donner un nom et tester

• Nom du connecteur : ex. « Jira Production » (utile si vous avez un Jira de test et un Jira de production).
• Cliquez sur Tester la connexion. Sens-AI envoie une requête de vérification (ex. : GET /myself pour Jira) et vous dit si tout va bien.
• Si OK : Enregistrer.

Lier une action à un connecteur

Quand vous créez ou modifiez une action :

• Section Authentification → Utiliser un connecteur existant → choisissez votre connecteur.
• Le champ URL de l’action est désormais relatif au connecteur (vous écrivez /issue et Sens-AI complète avec l’URL de base du connecteur).
• L’authentification est gérée automatiquement.

Mettre à jour un connecteur

Quand un identifiant change (clé API régénérée, OAuth qui doit être réautorisé) :

1. Actions → Connecteurs → cliquez sur le connecteur.
2. Modifier.
3. Mettez la nouvelle valeur.
4. Tester la connexion pour vérifier.
5. Enregistrer.

Toutes les actions liées sont automatiquement à jour. Aucune interruption de service.

Sécurité : ce qui est stocké comment

• Tokens et mots de passe : chiffrés au repos avec une clé spécifique à votre tenant. Personne (ni nous, ni un autre client) ne peut y accéder.
• Pas de logs avec les valeurs claires : si vous regardez les logs d’exécution, les en-têtes contenant une authentification sont remplacés par *** à l’affichage.
• Pas dans les exports : un export de vos données n’inclut pas les valeurs chiffrées.

Si vous suspectez une fuite (ordinateur compromis, ancien employé…) : la bonne réaction est de régénérer la clé chez l’éditeur (Jira, HubSpot, etc.) puis de mettre à jour le connecteur dans Sens-AI. C’est plus radical et plus sûr que de tenter de la « cacher » davantage chez nous.

Connecteurs et plans

Pas de limite sur le nombre de connecteurs, sur tous les plans. Le coût est porté par les exécutions d’actions, pas par leur configuration.

Étape suivante

Tester et déboguer une action en cas de problème : Tester et déboguer.