Centre d'aide RandomCoffee
EnglishFrançais
Saisissez un mot-clé pour rechercher dans la documentation.

Intégration Microsoft Teams

Installez l'application RandomCoffee dans Microsoft Teams, reliez-la à un programme et comprenez son SSO, son provisionnement et ses permissions.

Voir en MarkdownOuvrir dans ChatGPTOuvrir dans ClaudeOuvrir dans GrokOuvrir dans Perplexity

L’intégration Microsoft Teams associe un programme RandomCoffee à une ou plusieurs équipes Microsoft Teams. Le bot RandomCoffee envoie ensuite les invitations et les binômes du programme aux membres de ces équipes, directement dans Teams. L’intégration est disponible sur tous les plans.

Cette page couvre la partie technique : installation, authentification unique (SSO), provisionnement et permissions. Elle renvoie aussi à des protocoles de Microsoft, que Microsoft peut faire évoluer. Pour toute question liée à la mise en place d’un contrat, contactez support@random-coffee.com.

Ce que l’application ajoute à Teams

L’application RandomCoffee pour Microsoft Teams contient :

  • Un bot, disponible dans les équipes et en conversation privée. Il envoie les cartes d’opt-in et de mise en relation, et répond à trois commandes : “Aide”, “Commentaires” et “Faire une pause” (“Help”, “Feedback” et “Snooze” quand Teams est en anglais).
  • Un onglet de canal, ajouté à l’équipe quand vous reliez un programme. Il présente le contexte, le calendrier et l’activité du programme.
  • Trois onglets personnels : “Mon Activité”, “Mon Réseau” et “Mes Programmes” (“My Activity”, “My Network” et “My Programs” quand Teams est en anglais).

Ce que les membres voient dans Teams est décrit dans Comment fonctionne RandomCoffee.

Avant de commencer

  • Un programme à relier. Nous vous conseillons de créer au moins un programme dans votre espace de travail RandomCoffee avant d’installer l’application. Si votre espace de travail n’a encore aucun programme, la fenêtre d’installation vous permet d’en créer un à partir d’un modèle (“Créer un nouveau programme”). Si vous n’avez pas encore d’espace de travail RandomCoffee, elle propose “Créer un programme sur RandomCoffee”, et vous continuez une fois le programme créé.
  • Des droits dans Microsoft Teams. Vous devez avoir le droit d’ajouter des applications à une équipe dans votre environnement Microsoft Teams (selon la politique de votre organisation). Si l’application RandomCoffee est bloquée ou indisponible dans votre tenant, votre équipe IT peut l’autoriser en suivant Configurer RandomCoffee dans le centre d’administration Teams.

Installer l’application RandomCoffee

  1. Partez de RandomCoffee.

    Ouvrez “Paramètres”, allez dans “Configuration”, sélectionnez la carte “Intégration Microsoft Teams” et cliquez sur “Installer”.

  2. Ajoutez l’application à une équipe.

    Microsoft Teams s’ouvre sur l’application RandomCoffee. Ouvrez le menu à côté de “Add” et choisissez “Add to a team”.

    L'application RandomCoffee dans Microsoft Teams, avec l'option Add to a team

  3. Choisissez l’équipe.

    L’application s’installe dans une équipe, à partir de l’un de ses canaux. Sélectionnez votre équipe (et le canal), puis cliquez sur “Set up”.

    La fenêtre Add RandomCoffee to a team, avec une équipe et un canal sélectionnés et le bouton Set up

    Choisissez un canal standard. RandomCoffee ne fonctionne pas dans un canal privé pour le moment.

  4. Sélectionnez le programme à associer.

    Dans la fenêtre RandomCoffee, sélectionnez le programme à relier à l’équipe, puis cliquez sur “Enregistrer”.

    Si vous sélectionnez un programme existant déjà en cours, ses modèles de communication sont réinitialisés pour être compatibles avec les cartes Microsoft Teams. Adaptez vos modèles de messages une fois l’installation terminée : voir Personnaliser les messages.

  5. Vérifiez la confirmation.

    Votre programme est maintenant associé à l’équipe. Le bot RandomCoffee vous envoie, en privé, une carte “Nouveau programme RandomCoffee pour l’équipe !”.

  6. Terminez la configuration du programme.

    Cliquez sur “⚙️ Configurez votre programme” dans la carte, ou allez dans votre espace de travail RandomCoffee, pour choisir vos règles de matching, personnaliser vos messages et planifier les prochaines sessions.

Dans RandomCoffee, la section “Communication” des “Paramètres” du programme indique désormais “Microsoft Teams” comme canal, et l’équipe apparaît dans “Microsoft Teams”, dans la section “Inscription”.

Vous pouvez associer plusieurs équipes à un même programme : le programme sélectionne alors les participants dans toutes ces équipes.

Qui participe au programme, et ce qui se passe quand une personne rejoint ou quitte une équipe, est expliqué dans Synchroniser les membres depuis Slack ou Microsoft Teams.

Authentification unique (SSO)

Fonctionnement

RandomCoffee utilise un protocole de SSO discret dans Microsoft Teams. Une personne qui a un compte RandomCoffee est reconnue automatiquement grâce à son adresse email et reliée à son compte Microsoft Teams. Cette étape est invisible pour elle.

C’est ce qui permet à un admin, quand il ajoute l’application à une équipe, de retrouver directement dans Teams les données de son compte RandomCoffee (comme ses programmes existants). Un admin qui n’a pas encore d’espace de travail RandomCoffee est invité à en créer un, avec un premier programme, avant de continuer.

Pour les utilisateurs de l’application, cela signifie :

  • Teams obtient le jeton d’accès de l’utilisateur auprès de Microsoft Entra ID (anciennement Azure AD), sans que l’utilisateur quitte Teams.
  • Le consentement n’est demandé qu’une fois. Si l’application et l’utilisateur sont dans le même tenant, aucun consentement n’est nécessaire.
  • Un administrateur du tenant peut donner son consentement pour tous les utilisateurs : personne ne voit alors de fenêtre de consentement.
  • Teams récupère le jeton à l’avance, ce qui accélère le chargement, et les utilisateurs n’ont pas de mot de passe supplémentaire à retenir.

Quand le consentement manque, l’application affiche “Accorder le consentement de l’utilisateur ou de l’administrateur” avec un bouton “Donner son consentement”.

Déroulé à l’exécution

#InteractionCe qui se passe
1Onglet vers client TeamsL’onglet appelle getAuthToken() pour demander un jeton d’accès à Teams.
2Client Teams vers Microsoft Entra IDTeams demande un jeton d’accès pour l’utilisateur, à partir de son identité Teams.
3Microsoft Entra ID vers demande de consentementÀ la première utilisation, si l’application a besoin de données protégées, l’utilisateur (ou l’administrateur) doit donner son consentement. Une authentification renforcée, comme l’authentification à deux facteurs, peut aussi être demandée.
4Microsoft Entra ID vers client TeamsMicrosoft Entra ID renvoie le jeton d’accès, un JSON Web Token (JWT). Teams le met en cache pour les appels suivants.
5Client Teams vers ongletTeams renvoie le jeton dans le résultat de getAuthToken().
6Onglet (client et serveur)Le serveur RandomCoffee échange le jeton (flux on-behalf-of) contre un jeton Microsoft Graph avec le scope User.Read et identifie l’utilisateur.

Pour aller plus loin, consultez la documentation de Microsoft : Overview of authentication for tabs using SSO in Teams with Microsoft Entra ID.

Provisionnement des utilisateurs

Une fois le bot RandomCoffee installé dans votre équipe, RandomCoffee récupère auprès de Microsoft Teams la liste des membres de l’équipe. Il ne lit que les informations de base dont il a besoin pour chaque membre : prénom, nom et adresse email. RandomCoffee génère ensuite les binômes et les publie dans Teams.

Flux de données entre Microsoft Teams et RandomCoffee : RandomCoffee récupère le prénom, le nom et l'email de chaque utilisateur, ajoute ses propres catégories, génère les binômes et les publie dans Teams

Permissions de l’application

L’application RandomCoffee peut appeler les API de Microsoft une fois que les utilisateurs ou les admins ont donné leur consentement.

Permissions du manifeste de l’application Teams

  • identity
  • messageTeamMembers

Permissions déléguées Microsoft Entra ID

  • User.Read (Microsoft Graph)
  • email
  • openid
  • profile
  • offline_access

Désinstaller l’application

  1. Dans Microsoft Teams, faites un clic droit sur l’application RandomCoffee dans la barre de gauche, puis choisissez “Uninstall”.
  2. Confirmez avec “Remove”.

FAQ

L'intégration Microsoft Teams et l'intégration SIRH peuvent-elles fonctionner ensemble ?

Oui. Les utilisateurs provisionnés depuis Microsoft Teams qui existent aussi dans votre SIRH sont reconnus grâce à leur adresse email et complétés avec les données de votre SIRH, que vous pouvez utiliser dans vos règles de matching. Voir Intégration SIRH.

Les membres ont une erreur quand ils cliquent sur un bouton d'une carte RandomCoffee

L’application est probablement bloquée ou indisponible pour eux dans votre tenant. Voir Configurer RandomCoffee dans le centre d’administration Teams.

Configurer RandomCoffee dans le centre d'administration Teams

Rendez l'app RandomCoffee disponible dans le Teams de votre organisation.

Authentification unique (SSO)

Laissez votre équipe se connecter avec votre fournisseur d'identité.

Intégration Slack

Installez RandomCoffee dans votre espace de travail Slack.