Connecteurs

Les connecteurs relient Teloneum aux outils où travaille votre équipe. Ils sont à vous seul : l’outil vous voit, avec vos propres droits, et personne d’autre dans votre organisation n’utilise votre connexion.

Pour les trouver, cliquez sur votre nom au pied de la barre latérale, choisissez Paramètres, puis Connecteurs.

Tous les connecteurs que propose Teloneum y figurent, chacun sur une ligne de même forme : sous Connectés, ceux que vous avez connectés, avec leur adresse et leur interrupteur ; sous Disponibles, les autres, avec un bouton Connecter.

Connecter BookStack

Dans BookStack, ouvrez votre profil, puis la section des jetons d’API, et créez un jeton. BookStack affiche son identifiant et son secret une seule fois : gardez la page ouverte. Votre compte doit avoir la permission d’accéder à l’API du système ; demandez-la à l’administrateur du wiki si la section manque.
Dans Teloneum, cliquez sur Connecter sur la ligne BookStack : sa page s’ouvre, avec le formulaire.
Saisissez l’Adresse du wiki (celle où vous ouvrez BookStack, commençant par https://), l’ID du jeton et le Secret du jeton, puis cliquez sur Connecter.

Teloneum essaie le jeton sur votre wiki avant de le garder. Quand le wiki le refuse, le formulaire dit pourquoi et ne garde rien :

Le wiki a refusé ce jeton. L’identifiant ou le secret est faux, le jeton a expiré, ou votre compte ne peut pas utiliser l’API.
Cette adresse ne répond pas comme BookStack. Vérifiez l’adresse : c’est celle du wiki, pas d’une de ses pages.
Ce wiki est sur un réseau privé que Teloneum ne peut pas joindre. Teloneum ne joint qu’un wiki accessible sur internet.

Une fois connecté, BookStack passe sous Connectés, avec l’adresse de votre wiki et Activé. Le secret n’est plus jamais affiché : pour changer de jeton, ouvrez BookStack et cliquez sur Changer de jeton : le formulaire revient dans la page, avec Annuler pour garder l’ancien.

Connecter HubSpot

Dans le navigateur, cliquez sur Connecter sur la ligne HubSpot, puis, dans sa page, sur Se connecter avec HubSpot. HubSpot s’ouvre : choisissez votre compte, vérifiez ce que Teloneum pourra lire, et autorisez-le. Vous revenez dans Teloneum, connecté avec votre propre compte HubSpot : le chat ne voit que ce que vous pouvez voir dans HubSpot, avec vos droits, et ne fait que le lire.

Une fois connecté, HubSpot passe sous Connectés, avec l’adresse de votre compte HubSpot, et sa page affiche Votre compte HubSpot. Le bouton n’est disponible que dans le navigateur pour l’instant.

Teloneum ne fait que lire votre CRM : il ne modifie jamais un contact, une entreprise ni une transaction.

Connecter Google

Dans le navigateur, cliquez sur Connecter sur la ligne Google, puis, dans sa page, sur Se connecter avec Google. Google s’ouvre : choisissez votre compte - un compte Gmail ou celui de votre entreprise -, vérifiez ce que Teloneum pourra lire, et autorisez-le. Vous revenez dans Teloneum, connecté avec votre propre compte : le chat ne voit que ce que vous voyez dans Google.

Google demande séparément l’accès aux fichiers de votre Drive que vous choisirez et à votre agenda. Vous pouvez décocher ce que vous ne voulez pas partager : Teloneum ne lira que ce que vous avez laissé coché. Si vous décochez tout, Teloneum ne garde rien et vous demande de vous reconnecter en laissant au moins un service coché.

Une fois connecté, la page Google affiche, sous Connexion, le Compte et ce que Teloneum peut lire (Lecture), par exemple Drive, Agenda.

Choisir les fichiers du Drive

Teloneum ne lit que les fichiers de votre Drive que vous lui donnez. Dans la page Google, cliquez sur Choisir des fichiers : la fenêtre de Google s’ouvre sur votre Drive. Sélectionnez un ou plusieurs fichiers, puis validez. Un message confirme combien de fichiers vous avez donnés. Recommencez quand vous voulez en ajouter. Les dossiers ne peuvent pas être donnés : choisissez les fichiers qu’ils contiennent.

Teloneum ne fait que lire : il ne modifie aucun fichier et ne crée aucun événement. Il ne lit pas vos mails. Le bouton n’est disponible que dans le navigateur pour l’instant.

Si votre entreprise limite les applications tierces dans Google Workspace, son administrateur doit d’abord autoriser Teloneum dans la console d’administration de Google.

Connecter Notion

Dans le navigateur, cliquez sur Connecter sur la ligne Notion, puis, dans sa page, sur Se connecter avec Notion. Notion s’ouvre : connectez-vous, choisissez votre espace de travail, vérifiez ce que Teloneum pourra faire, et autorisez-le. Vous revenez dans Teloneum, connecté avec votre propre compte Notion : le chat voit les pages et bases de données que vous voyez dans Notion, et ne fait que les lire.

Une fois connecté, Notion passe sous Connectés, et sa page affiche Votre compte Notion. Le bouton n’est disponible que dans le navigateur pour l’instant.

Notion vous demande de vous reconnecter de temps en temps, au plus tard tous les six mois. Si l’administrateur de votre espace Notion limite les outils connectés, il doit d’abord y autoriser Teloneum.

Connecter Jira et Confluence

Dans le navigateur, cliquez sur Connecter sur la ligne Jira & Confluence, puis, dans sa page, sur Se connecter avec Atlassian. Atlassian s’ouvre : connectez-vous, choisissez le site de votre entreprise, vérifiez ce que Teloneum pourra faire, et autorisez-le. Vous revenez dans Teloneum, connecté avec votre propre compte Atlassian : le chat voit les tickets Jira et les pages Confluence que vous voyez, et ne fait que les lire.

Une fois connecté, Jira & Confluence passe sous Connectés, et sa page affiche Votre compte Jira & Confluence. Le bouton n’est disponible que dans le navigateur pour l’instant. Si l’administrateur de votre site Atlassian limite les applications connectées, il doit d’abord y autoriser Teloneum.

Connecter votre kDrive Infomaniak

Dans le Manager d’Infomaniak, ouvrez Développeur, puis Tokens API, et créez un jeton en cochant les scopes accounts et drive. Infomaniak n’affiche le jeton qu’une seule fois : copiez-le.
Dans Teloneum, cliquez sur Connecter sur la ligne Infomaniak kDrive.
Collez le jeton dans Jeton d’API, puis cliquez sur Connecter.

Teloneum essaie le jeton avant de le garder, et le formulaire dit pourquoi il ne le garde pas :

Infomaniak a refusé ce jeton. Le jeton est faux, supprimé ou expiré.
Ce jeton n’ouvre aucun kDrive : créez-le avec les scopes accounts et drive. Un scope manque, ou votre compte n’a aucun kDrive.

Un kDrive ajouté ensuite est lu une fois que vous vous reconnectez.

Connecter votre messagerie Infomaniak

Dans les paramètres de sécurité de votre compte Infomaniak, créez un mot de passe d’application pour Teloneum, et copiez-le. N’utilisez pas le mot de passe de votre compte : avec la double authentification, il ne passe pas.
Dans Teloneum, cliquez sur Connecter sur la ligne Infomaniak Mail.
Saisissez votre Adresse mail, collez le Mot de passe d’application, puis cliquez sur Connecter.

Teloneum se connecte à votre boîte pour essayer le mot de passe avant de le garder. Quand Infomaniak le refuse, le formulaire le dit : Infomaniak a refusé cette adresse et ce mot de passe : vérifiez l’adresse, et utilisez un mot de passe d’application. Une fois connectée, sa page affiche votre Adresse mail.

Régler un connecteur

Cliquez sur un connecteur connecté pour ouvrir sa page. Chacune a la même forme :

l’interrupteur Activé en haut. Désactivé, le connecteur garde votre jeton, mais les modèles du chat ne reçoivent plus aucun de ses outils ; réactivez-le quand vous voulez, sans vous reconnecter. L’interrupteur de la ligne, dans la liste, fait de même ;
Connexion : ce qui est propre au connecteur. Pour BookStack, l’Adresse du wiki et l’ID du jeton, et Changer de jeton ; pour HubSpot, le Compte et la Méthode - Votre compte HubSpot -, et Reconnecter ; pour Google, le Compte, la Lecture et Choisir des fichiers ; pour Notion et Jira & Confluence, la Méthode, et Reconnecter ; pour Infomaniak kDrive, le nombre de kDrives, et Changer de jeton ; pour Infomaniak Mail, l’Adresse mail, et Changer le mot de passe ;
Outils donnés aux modèles : ce que le connecteur permet au chat, chacun avec son interrupteur. Pour BookStack, Chercher dans le wiki et Lire une page du wiki ; pour HubSpot, chercher et lire des fiches. Un outil désactivé n’est plus proposé aux modèles ;
Déconnecter, en bas.

Ce que vous réglez est gardé quand vous changez de jeton ou vous reconnectez.

Se déconnecter

Ouvrez le connecteur, cliquez sur Déconnecter, puis confirmez. Teloneum oublie votre jeton ; vous pouvez vous reconnecter à tout moment. Pour arrêter le jeton lui-même, supprimez-le aussi dans BookStack. Pour Notion, retirez aussi Teloneum des connexions de votre compte, dans les paramètres de Notion. Pour Jira et Confluence, retirez-le des applications connectées de votre profil Atlassian. Pour Infomaniak, supprimez aussi le jeton dans le Manager, et le mot de passe d’application dans les paramètres de sécurité de votre compte.

Interroger le chat sur votre Drive et votre agenda

Une fois Google connecté, les modèles du chat peuvent chercher parmi les fichiers que vous avez donnés et lire vos documents, vos feuilles de calcul et vos présentations Google ainsi que vos fichiers texte, et lister les événements de votre agenda. Demandez par exemple de retrouver un document, de résumer une présentation ou quand vous êtes libre la semaine prochaine. Les étapes affichent Recherche effectuée dans votre Drive avec ce que le modèle a cherché, Fichier de votre Drive lu et Agenda lu ; la réponse donne le lien des fichiers sur lesquels elle s’appuie. Les PDF du Drive ne sont pas encore lus. Quand le fichier qui répondrait n’a pas été donné, le modèle vous le dit : donnez-le avec Choisir des fichiers.

Vos fichiers et votre agenda parviennent au modèle qui répond, comme tout ce que vous écrivez dans le chat. Quand Google a été consulté, il figure parmi ceux qui ont traité le message.

Interroger le chat sur votre espace Notion

Une fois Notion connecté, les modèles du chat peuvent chercher dans votre espace, lire une page ou une base de données entière, et ses commentaires. Demandez par exemple de retrouver le compte rendu d’une réunion, de résumer la page d’un projet ou de lister les tâches d’une base. Les étapes affichent Lecture de votre espace Notion, puis Espace Notion lu ; la réponse donne le lien des pages sur lesquelles elle s’appuie.

Teloneum ne fait que lire : il ne crée, ne modifie ni ne supprime aucune page, et n’écrit aucun commentaire. Ce que contiennent vos pages parvient au modèle qui répond, comme tout ce que vous écrivez dans le chat. Quand Notion a été consulté, il figure parmi ceux qui ont traité le message.

Interroger le chat sur Jira et Confluence

Une fois Jira et Confluence connectés, les modèles du chat peuvent chercher dans vos tickets et vos pages, lire un ticket ou une page entière, avec ses commentaires, et parcourir vos projets et vos espaces. Demandez par exemple où en sont les tickets d’un projet, ce qui bloque une version, ou de résumer une page de documentation. Les étapes affichent Lecture de votre Jira et de votre Confluence, puis Jira et Confluence lus ; la réponse donne le lien des tickets et des pages sur lesquels elle s’appuie.

Teloneum ne fait que lire : il ne crée, ne modifie ni ne déplace aucun ticket ou page, et n’écrit aucun commentaire. Ce que contiennent vos tickets et vos pages parvient au modèle qui répond, comme tout ce que vous écrivez dans le chat. Quand Atlassian a été consulté, il figure parmi ceux qui ont traité le message.

Interroger le chat sur votre kDrive

Une fois kDrive connecté, les modèles du chat peuvent chercher dans vos fichiers, par leur nom et leur contenu, et lire un fichier entier : un fichier texte tel quel, un document, un tableur, une présentation ou un PDF une fois converti en texte par kDrive. Demandez par exemple de retrouver un contrat ou de résumer un compte rendu. Les étapes affichent Recherche effectuée dans votre kDrive avec ce que le modèle a cherché, puis Fichier de votre kDrive lu ; la réponse donne le lien du dossier des fichiers sur lesquels elle s’appuie. Un PDF scanné ne se lit pas.

Teloneum ne fait que lire : il ne crée, ne modifie, ne déplace ni ne partage aucun fichier. Ce que contiennent vos fichiers parvient au modèle qui répond, comme tout ce que vous écrivez dans le chat. Quand Infomaniak a été consulté, il figure parmi ceux qui ont traité le message.

Interroger le chat sur vos mails

Une fois votre messagerie connectée, les modèles du chat peuvent chercher dans vos mails, par les mots qu’ils contiennent, lister les derniers reçus et lire un message entier. Ils cherchent dans la boîte de réception, ou dans le dossier que vous nommez. Demandez par exemple ce qu’un client vous a écrit la semaine dernière, ou de résumer un échange. Les étapes affichent Recherche effectuée dans votre messagerie avec ce que le modèle a cherché, puis Message de votre messagerie lu. Les pièces jointes ne sont pas lues.

Teloneum ne fait que lire : il n’envoie, ne répond, ne déplace ni ne supprime aucun message, et ne marque rien comme lu. Ce que contiennent vos mails, y compris ce qu’ils disent des personnes qui vous écrivent, parvient au modèle qui répond, comme tout ce que vous écrivez dans le chat. Quand votre messagerie a été consultée, Infomaniak Mail figure parmi ceux qui ont traité le message.

Interroger le chat sur votre CRM

Une fois HubSpot connecté, les modèles du chat peuvent chercher dans vos contacts, entreprises et transactions, et lire une fiche entière avec ce qui lui est associé. Posez une question sur un client, une entreprise ou l’avancement d’une transaction. Les étapes affichent Recherche effectuée dans votre CRM avec ce que le modèle a cherché, et Fiche de votre CRM lue, avec le lien de la fiche dans HubSpot.

Ce que le CRM contient sur des personnes - noms, e-mails, téléphones - parvient au modèle qui répond, comme tout ce que vous écrivez dans le chat : les modèles que propose votre projet sont ceux que vos administrateurs ont choisis.

Interroger le chat sur votre wiki

Une fois votre wiki connecté, les modèles du chat peuvent y chercher et en lire les pages, avec vos propres droits : ils ne voient que ce que vous voyez dans BookStack. Posez une question sur les procédures ou la documentation de votre entreprise, et le modèle regarde d’abord dans le wiki. Ses étapes affichent Recherche effectuée dans votre wiki avec ce qu’il a cherché, et Page de votre wiki lue, avec la page en dessous ; la réponse donne le lien des pages sur lesquelles elle s’appuie.

Un modèle qui ne sait pas utiliser d’outils ne lit pas le wiki. Quand le wiki a été consulté, BookStack figure parmi ceux qui ont traité le message.