Aller à la documentation
Base de connaissances

Connecteurs

Connectez les applications avec lesquelles vous travaillez, pour que l'assistant puisse y chercher des informations et y agir.

Détails

  • Un connecteur relie une application externe à l'assistant, pour qu'il puisse y chercher des informations et y agir. Slack, Notion, Google Drive, HubSpot et environ un millier d'autres peuvent être connectées. « Trouve la proposition dans Drive et dis-moi ce qu'elle dit sur les tarifs. » « Publie cette mise à jour dans le canal des ventes. » Les connecteurs se trouvent sous Connecteurs dans la barre latérale.
  • Pour connecter une application, choisissez-la dans la liste, choisissez pour qui elle est et ce que l'assistant peut faire, puis terminez sur la page de connexion de l'application elle-même, ou collez-y une clé de l'application. Le mot de passe ou la clé ne passe jamais par le chat d'OpenEmail, par son API ni par l'assistant. Le connecteur est en attente tant que vous n'avez pas terminé, puis actif.
  • Un connecteur est pour vous seul ou pour tout l'espace de travail, et l'assistant peut soit seulement chercher des informations par son intermédiaire, soit aussi faire des modifications. Vous pouvez changer cela plus tard, et mettre un connecteur en pause puis le reprendre. Déconnecter abandonne aussi l'accès dans l'application externe. Si l'application cesse d'accepter la connexion, le connecteur demande à être reconnecté, et un nouveau lien le rétablit comme le même connecteur.
  • Dans une discussion, l'assistant voit ce qui est connecté, trouve la bonne action dans l'application et lit tout de suite. Pour tout ce qui modifie quelque chose dans l'application, comme envoyer un message, créer ou mettre à jour un enregistrement ou supprimer, il affiche d'abord une carte à approuver, même si vous l'avez demandé directement. Un connecteur qui ne fait que chercher des informations refuse les modifications, et ce qu'une application renvoie est traité comme une information, jamais comme des consignes.
  • Une tâche n'utilise des connecteurs que si Connecteurs est activé dans ses Outils supplémentaires, et seulement ceux qui sont connectés pour l'espace de travail, jamais un connecteur qui appartient à une seule personne. Elle lit seule. Chaque modification dans une application attend dans En attente de vous, quoi que la tâche puisse faire seule par ailleurs, et une tâche qui utilise des connecteurs ne répond jamais seule au courrier : chaque réponse attend votre approbation.
  • Chaque appel passé par un connecteur est enregistré pendant 90 jours : quand, quelle application et quelle action, s'il a lu ou modifié quelque chose, s'il a réussi, et s'il venait d'une discussion, d'une tâche, de l'API ou d'un agent. Ce qui a été envoyé à l'application et ce qui en est revenu ne sont jamais conservés par OpenEmail.
  • Trois permissions décident de qui fait quoi : une pour voir les connecteurs et ce qui a été fait par leur intermédiaire, une pour les faire utiliser par l'assistant, et une pour connecter, mettre en pause et déconnecter des applications et définir ce que l'assistant peut faire. Les propriétaires et les administrateurs ont les trois, Member a les deux premières et Viewer la première. Quiconque peut connecter une application peut la connecter pour lui-même ou pour l'espace de travail.
  • Une offre couvre 2 connecteurs en Free, 10 en Starter et 50 en Business pour un compte, et autant encore pour un espace de travail. Enterprise ne fixe pas de limite propre, et rien n'en contient plus de 200. Quand un espace de travail passe à une offre inférieure, les connecteurs les plus récents au-delà de la limite sont mis en pause, pas supprimés.
  • Les connexions sont détenues par un prestataire externe, qui conserve aussi une trace de ce que l'assistant envoie à une application et de ce que l'application répond, pendant un an au maximum. La Politique de confidentialité le cite.
  • Les connecteurs sont dans l'API REST sous /connectors, /connector-apps, /connector-categories et /connector-calls, dans chaque SDK avec connectors, en ligne de commande avec openemail connectors, et sur le serveur MCP. Via l'API, une modification s'exécute aussitôt sans que personne soit consulté, c'est donc l'appelant qui décide. Trois événements webhook informent vos systèmes quand un connecteur de l'espace de travail est connecté, est déconnecté ou doit être reconnecté.

Connecter une application

Connecter une application prend une minute, et vous vous y connectez sur la page de l'application elle-même.

  1. Ouvrez Connecteurs dans la barre latérale et trouvez l'application sous Parcourir, par son nom ou par une catégorie.
  2. Choisissez pour qui est le connecteur : vous uniquement, ou tout l'espace de travail.
  3. Choisissez ce que l'assistant peut faire par son intermédiaire : seulement chercher des informations, ou aussi faire des modifications.
  4. Terminez sur la page de connexion de l'application, ou collez-y une clé de l'application. Le connecteur est en attente tant que vous n'avez pas terminé, puis actif.
  • Votre mot de passe ou votre clé pour l'application ne passe jamais par le chat d'OpenEmail, par son API ni par l'assistant.
  • Quand une application cesse d'accepter la connexion, le connecteur indique qu'il doit être reconnecté. Un nouveau lien le rétablit comme le même connecteur, les tâches qui l'utilisent continuent donc.
  • Mettez un connecteur en pause pour empêcher l'assistant de l'utiliser, et reprenez-le quand vous voulez le retrouver.
  • Déconnecter supprime le connecteur et abandonne aussi l'accès qu'il détenait dans l'application externe.
  • Les connecteurs peuvent être désactivés pour tout le service. La page est alors masquée.

Qui peut faire quoi

PermissionCe qu'elle permet
connectors:readVoir les connecteurs et ce qui a été fait par leur intermédiaire
connectors:useLaisser l'assistant faire des recherches et des modifications par leur intermédiaire
connectors:writeConnecter, mettre en pause et déconnecter des applications, et définir ce que l'assistant peut y faire
  • Les propriétaires et les administrateurs ont les trois. Le rôle intégré Member a connectors:read et connectors:use, et Viewer a connectors:read.
  • La même permission couvre les deux types de connecteur : quiconque peut connecter une application peut la connecter pour lui-même ou pour l'espace de travail.

Depuis le code, le terminal et les agents

Les connecteurs se trouvent dans l'API REST sous /connectors, /connector-apps, /connector-categories et /connector-calls, dans chaque SDK et dans la CLI sous connectors, et dans les outils MCP, que l'assistant utilise aussi.