Intégrations : vue d'ensemble
Comprendre les trois familles d'intégrations Sens-AI — canaux entrants, connecteurs d'authentification, actions sortantes — et choisir la bonne pour votre besoin.
Dernière mise à jour :
À quoi sert cette page
Sens-AI propose trois familles d’intégrations qui se ressemblent au premier coup d’œil mais qui n’ont pas du tout le même rôle. Si vous hésitez entre « connecter Slack pour recevoir des messages » et « connecter Slack pour poster un message à la fin d’une conversation », vous êtes au bon endroit.
Cette page sert d’aiguillage. Lisez le tableau ci-dessous, identifiez votre besoin, puis suivez le lien vers l’article détaillé.
Les trois familles en un coup d’œil
| Famille | Sens du flux | Sert à… | Où c’est dans le dashboard |
|---|---|---|---|
| Canaux | Visiteur → bot | Recevoir des messages depuis un autre support que le widget web | Bot → onglet Canaux |
| Connecteurs | (configuration) | Stocker les identifiants d’un outil tiers, une fois, et les réutiliser | Bot → onglet Actions → sous-onglet Connecteurs |
| Actions | Bot → outil externe | Faire faire quelque chose au bot pendant ou après une conversation | Bot → onglet Actions |
Famille 1 — Les canaux (entrant)
Un canal permet à un visiteur de discuter avec votre bot sans passer par le widget web installé sur votre site. Le bot reçoit le message, génère sa réponse, et la renvoie sur le même support.
Aujourd’hui, Sens-AI prend en charge :
- Telegram — un canal par bot, déclenché via un token de bot Telegram.
- Email (transfert) — vous configurez un transfert automatique depuis votre boîte vers une adresse
[email protected]fournie par Sens-AI. - Email (OAuth Gmail / Outlook) — Sens-AI se connecte directement à votre boîte (Gmail ou Outlook) avec votre autorisation.
- Voice — un agent vocal qui parle en français via le widget vocal.
Les canaux sont décrits en détail dans la section Canaux de l’aide.
Famille 2 — Les connecteurs (authentification)
Un connecteur est une fiche centralisée qui contient les identifiants d’un outil externe (Jira, Slack, HubSpot, etc.). On le configure une seule fois, et plusieurs actions peuvent ensuite s’y rattacher.
Les types d’authentification pris en charge :
- Clé API (Bearer Token, API Key) — le cas le plus courant.
- OAuth — pour Google, Microsoft et certaines plateformes : pas de mot de passe stocké, juste un jeton d’accès révocable.
- Webhook simple — sans authentification, pour les services internes.
- Authentification basique — couple identifiant + mot de passe (HTTP Basic Auth).
Tout est chiffré au repos avec une clé spécifique à votre tenant. Voir Connecteurs et authentification pour le détail.
Famille 3 — Les actions (sortant)
Une action permet à votre bot d’exécuter une tâche dans un outil externe pendant une conversation : créer un ticket, envoyer un email, poster un message, etc.
Sept templates pré-configurés sont disponibles dans le catalogue :
| Template | Ce que ça fait |
|---|---|
| JIRA — Créer un ticket | Crée automatiquement un ticket JIRA à partir de la conversation |
| JIRA — Consulter un ticket | Récupère les détails d’un ticket JIRA existant |
| JIRA — Mettre à jour un ticket | Met à jour un ticket JIRA (priorité, labels, commentaire) |
| Slack — Envoyer un message | Envoie un message sur un canal Slack via un webhook |
| Email — Envoyer un email | Envoie un email via l’API Resend |
| Calendly — Lien de réservation | Crée un lien de réservation Calendly à usage unique |
| Webhook générique | Appelle un webhook personnalisé pour les intégrations sur mesure |
Voir Comprendre les actions pour le pipeline complet (détection → collecte → exécution → restitution).
Comment les trois familles s’articulent
Le scénario typique combine les trois :
- Un visiteur écrit au bot via un canal (par exemple Telegram).
- Le bot détecte qu’une action doit être déclenchée (créer un ticket JIRA).
- L’action utilise un connecteur Jira pour s’authentifier auprès de l’API.
- La réponse de Jira est restituée au visiteur sur le même canal (Telegram).
Vous pouvez aussi avoir un canal sans action (le bot répond juste, c’est tout), ou une action sans canal (le visiteur passe par le widget web, et le bot crée un ticket en fin de conversation).
Choisir le bon article selon votre besoin
-
« Je veux que mon bot réponde sur Telegram / par email / en vocal » → Section Canaux.
-
« J’ai une clé API Jira / HubSpot / Slack à stocker quelque part » → Connecteurs et authentification.
-
« Je veux que mon bot crée un ticket / envoie un email / poste un message à la fin d’une conversation » → Comprendre les actions, puis Créer une action personnalisée.
-
« Mon action ne marche pas, je vois une erreur 401 / 403 / 422 » → Tester et déboguer une action.
-
« Je veux contrôler quand le bot pose une question avant d’agir » → Configurer les champs à collecter.
Limites à connaître
Pour cadrer les attentes, quelques limites du catalogue actuel :
- Templates sortants : sept templates seulement à ce jour (Jira ×3, Slack, Email/Resend, Calendly, Webhook générique). Pour tout le reste, il faut passer par le Webhook générique ou un connecteur personnalisé.
- Canaux entrants : Telegram (un seul par bot), Email (transfert ou OAuth Gmail/Outlook) et Voice. WhatsApp, Messenger, Instagram, SMS ne sont pas disponibles à date.
- Authentification : OAuth limité à Google et Microsoft pour l’instant. Salesforce, HubSpot, etc. fonctionnent en clé API uniquement.
- Multi-canaux : un bot peut avoir plusieurs canaux actifs en parallèle, mais une conversation reste rattachée à un seul canal du début à la fin.
- Pas de bus d’événements sortant : Sens-AI n’envoie pas de webhooks « il s’est passé quelque chose » vers vos systèmes. Si vous voulez tracer les exécutions ailleurs, ajoutez une action de log dédiée (voir l’astuce dans Tester et déboguer).
Étape suivante
Choisissez l’article qui correspond à votre besoin dans la liste ci-dessus. Si vous démarrez à zéro, le parcours recommandé est :
- Comprendre les actions — saisir le pipeline.
- Connecteurs et authentification — préparer les identifiants.
- Créer une action personnalisée — assembler le tout.
- Tester et déboguer une action — valider avant la mise en production.