Les connexions permettent à un expert Kapsule Agents de travailler à l'intérieur des applications que vous utilisez déjà, avec votre permission, et elles sont entièrement séparées de ce qu'un expert peut faire sur votre compte KapsuleHost.
Qu'est-ce qu'une connexion
Une connexion est un lien authentifié entre l'un de vos experts et une application externe. Une fois connecté, cet expert peut utiliser les outils de l'application dans une conversation : lire un document, rédiger un message, vérifier un enregistrement. Sans connexion, l'expert n'a aucun accès.
Deux points méritent d'être précisés :
- Une connexion donne accès à cette application, pas à votre compte KapsuleHost. Les deux ensembles de permissions ne se mélangent jamais.
- Tout ce qui modifie quelque chose dans l'application connectée passe quand même par la même carte de confirmation qu'une modification sur votre compte KapsuleHost. La lecture est immédiate ; l'écriture demande d'abord votre approbation.
Les connexions se trouvent à Agents, puis Gérer les Connexions, ou allez directement sur /agents/connections. La page d'accueil Agents affiche également une carte Connexions avec quelques applications exemple.
Quels experts peuvent utiliser quelles applications
La liste est délibérément conservatrice, et chaque expert ne voit que les applications dont son rôle a besoin. Certaines sont limitées aux outils de lecture seule, même quand l'application elle-même peut faire plus :
| Expert | Applications externes qu'il peut atteindre |
|---|---|
| Mara, Business Advisor | Stripe (lecture seule) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (lecture seule) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (lecture seule) |
| Pip, Policy and Docs | Aucune |
Connecter une application ne la remet pas à toute l'équipe. Elle devient disponible uniquement pour les experts de la ligne ci-dessus.
Connecter une application
- Ouvrez Agents, puis Gérer les Connexions.
- Parcourez l'onglet Populaire, passez à Toutes les Apps, ou tapez dans la boîte de recherche. Chaque carte affiche le nom de l'application et le nombre d'outils qu'elle expose.
- Cliquez sur Connecter sur l'application que vous souhaitez. Le bouton devient Ouverture en cours... tandis que la fenêtre de connexion est préparée.
- Connectez-vous à l'application elle-même et approuvez l'accès qu'elle demande.
- Vous revenez à la page Connexions avec une confirmation [app] Connectée.
Une fois connectée, la carte affiche un badge Connectée, le libellé du compte avec lequel vous vous êtes connecté, et quand la connexion a été utilisée pour la dernière fois, ou Pas encore utilisé.
Statuts de connexion
| Statut | Ce qu'il signifie | Que faire |
|---|---|---|
| Connectée | Fonctionne. Vos experts peuvent l'utiliser. | Rien |
| En attente | La connexion a été lancée mais n'a jamais été terminée. | Cliquez sur Terminer la connexion |
| Reconnexion Nécessaire | L'accès a expiré ou a été retiré du côté de l'application. | Cliquez sur Se reconnecter |
L'état Reconnexion Nécessaire est normal au fil du temps : la plupart des applications font expirer l'accès qu'elles accordent selon un calendrier. Se reconnecter le rétablit sans rien perdre.
Comment cela reste sûr
La page Connexions énonce le modèle de sécurité en trois points, et il vaut la peine de les comprendre plutôt que de les parcourir rapidement :
- Géré par un partenaire certifié. La connexion à une application est gérée par notre partenaire d'intégration certifié, qui détient la subvention. Votre mot de passe d'application ne touche jamais KapsuleHost.
- Confirmation avant action. Les Agents demandent avant d'agir. Tout ce qui modifie quelque chose a besoin de votre approbation d'abord.
- Révocation instantanée. Se déconnecter coupe l'accès immédiatement, ici et auprès de l'application.
Traitez une connexion comme une clé que vous avez fait faire pour quelqu'un. Connectez les comptes dans lesquels vous voulez que vos experts travaillent, pas tous les comptes que vous possédez. Si vous n'êtes pas sûr qu'un expert a besoin d'une application pour faire le travail que vous avez en tête, ne la connectez pas : demandez d'abord, puis connectez.
Déconnecter une application
- Ouvrez Agents, puis Gérer les Connexions.
- Cliquez sur Déconnecter sur l'application connectée.
- Une confirmation apparaît : Votre équipe perd accès à [app] immédiatement. Tout ce qu'elle a déjà utilisé reste dans vos chats passés.
- Cliquez sur Déconnecter pour confirmer.
L'accès se termine immédiatement. Ce que cela ne fait pas, c'est effacer le contenu de l'application de vos conversations antérieures : si un expert a cité un document dans un chat la semaine dernière, ce texte est toujours dans la transcription du chat. Se déconnecter concerne l'accès futur, pas l'effacement rétroactif.
Quand les connexions ne sont pas disponibles sur votre compte
Si la page Connexions affiche une seule carte calme lisant Les connexions ne sont pas encore disponibles, la connexion d'applications externes n'a pas été activée pour votre compte. La carte est explicite : rien n'est connecté et rien n'a accès, ce qui est exactement la vérité dans cet état. Vos experts travaillent toujours ; ils ne peuvent simplement pas accéder à l'extérieur de KapsuleHost.
Le reste d'Agents n'est pas affecté. Les chats, Compétences et les lectures de compte fonctionnent tous normalement.
Que faire en cas d'échec
"La permission n'a pas été accordée, alors rien n'a été connecté." Vous avez annulé ou refusé à l'écran d'approbation de l'application elle-même. Rien n'a été créé. Cliquez sur Connecter à nouveau et approuvez l'accès.
"Les connexions ne sont pas disponibles en ce moment. Réessayez dans un instant." Le service d'intégration n'a pas pu être atteint. C'est délibérément à fermeture : plutôt que d'afficher une liste à moitié construite, la page n'affiche rien. Attendez une minute et rechargez.
"Les connexions n'ont pas pu être chargées." Vos paramètres sont sûrs. Actualisez la page. Si cela persiste, ouvrez un ticket de support.
Un expert dit qu'il ne peut pas accéder à une application connectée. Vérifiez le tableau ci-dessus. Tous les experts ne sont pas autorisés à accéder à chaque application, et une application connectée pour Iris n'est pas automatiquement disponible pour Mara.
Une connexion reste en Attente. La fenêtre de connexion a été fermée avant qu'elle soit terminée. Cliquez sur Terminer la connexion et complétez-la.
Ce que les connexions coûtent
L'utilisation d'une application connectée dans une conversation est mesurée comme n'importe quel autre travail. Chaque appel qu'un expert fait à une application externe est facturé au poids d'appel de connexion, qui est une fraction de ce qu'un long texte coûte. Les lectures sur votre compte KapsuleHost restent gratuites. La pondération complète est dans Comment fonctionnent les crédits d'agent.