Partager via


Microsoft Teams Connect canaux partagés

Microsoft Teams Connect canaux partagés permettent aux membres d’un canal de collaborer avec des utilisateurs d’autres équipes et organisations. Vous pouvez créer et partager un canal partagé avec :

  • Membres d’une autre équipe au sein de la même organization.
  • Des individus appartenant à la même organization.
  • Individus et autres équipes d’autres organisations.

Remarque

Teams Connect canaux partagés facilitent la collaboration sécurisée en toute transparence. Autoriser les utilisateurs externes en dehors de votre organization à collaborer avec des utilisateurs internes dans Teams sans modifier leur contexte utilisateur. Améliorez l’expérience utilisateur contrairement à l’utilisation de comptes invités, par exemple, les membres doivent se déconnecter de Teams et se reconnecter à l’aide d’un compte invité. Les applications Teams étendent le puissant espace de collaboration.

Le diagramme montre l’équipe B de organization A et l’équipe C de organization B qui collaborent dans un canal partagé en tant qu’équipe A.

Activer votre application pour les canaux partagés

SupportedChannelTypes est une propriété facultative qui active votre application dans des canaux non standard. Si votre application prend en charge l’étendue de l’équipe et que la propriété est définie, Teams active votre application dans chaque type de canal en conséquence. Les canaux privés et partagés sont pris en charge. Pour plus d’informations, consultez supportedChannelTypes.

    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ]

Remarque

  • Si votre application prend en charge l’étendue de l’équipe, elle fonctionne dans des canaux standard, quelles que soient les valeurs définies dans cette propriété.
  • Votre application peut avoir besoin de tenir compte des propriétés uniques de chacun de ces types de canaux afin de fonctionner correctement.

Obtenir le contexte des canaux partagés

Lorsque l’expérience utilisateur du contenu est chargée dans un canal partagé, utilisez les données reçues de l’appel pour les modifications de getContext canal partagé. getContext l’appel publie deux nouvelles propriétés, hostTeamGroupID et hostTenantID, qui sont utilisées pour récupérer l’appartenance au canal à l’aide des API Microsoft Graph. hostTeam est l’équipe qui crée le canal partagé.

Pour plus d’informations sur l’activation de votre onglet, consultez :

Applications et autorisations dans les canaux partagés

Vous pouvez collaborer avec des membres externes en dehors de votre organization à l’aide de canaux partagés. Les autorisations d’application dans les canaux partagés suivent la liste des applications de l’équipe hôte et la stratégie d’application du locataire hôte.

Remarque

L’API de notification de flux d’activité ne prend pas en charge les notifications interlocataires pour les applications dans un canal partagé.

Obtenir l’appartenance au canal partagé

Vous pouvez obtenir l’appartenance directe au canal partagé en utilisant le hostTeamGroupID à partir de getContext et en suivant ces étapes :

  1. Obtenir des membres directs avec l’API DES membres du canal GET .

    GET /teams/{host-team-group-id}/channels/{channel-id}/members
    
  2. Obtenez chaque équipe partagée avec l’API GET sharedWithTeams .

    GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams
    
  3. Utilisez les membres GET de chaque équipe partagée (Team X) avec l’API GET sharedWithTeams .

    GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams/{teamX}/members
    

Classifier les membres du canal partagé comme étant in-tenant ou out-tenant

Vous pouvez classifier les membres comme in-tenant ou out-tenant en comparant tenantID le membre ou l’équipe comme hostTeamTenantID suit :

  1. Obtenez le membre que vous souhaitez comparer.

    GET /teams/{host-team-group-id}/channels/{channel-id}/members
    
  2. Utilisez getContext, comparez le tenantID du membre à la hostTenantID propriété .

identité native Microsoft Entra

Les applications doivent fonctionner entre locataires lors de l’installation et de l’utilisation. Le tableau suivant répertorie les types de canaux et leurs ID de groupe correspondants :

Type de canal groupId hostTeamGroupId
Regular ID de groupe Microsoft Entra d’équipe ID de groupe Microsoft Entra d’équipe
Shared Empty ID de groupe de l’équipe hôte Microsoft Entra

Applications dans les conversations de groupe fédérées avec des utilisateurs externes

Remarque

Teams prend en charge l’utilisation d’applications dans les conversations de groupe fédérées avec des utilisateurs externes. Ces utilisateurs ne peuvent pas ajouter, mettre à jour ou supprimer des applications de la conversation de groupe. Seul l’hôte de la conversation de groupe peut ajouter, mettre à jour ou supprimer des applications. Toutefois, tous les membres de la conversation, y compris les utilisateurs externes, peuvent utiliser des applications dans les conditions suivantes :

  • L’administrateur locataire de l’organization de l’hôte de conversation de groupe et l’administrateur locataire de la organization de l’utilisateur externe doivent autoriser l’utilisation de l’application dans les conversations de groupe fédérées. Pour plus d’informations, consultez Applications Teams pour les participants externes ou les invités en dehors d’un organization.
  • L’application permet d’accéder aux utilisateurs externes dans les conversations de groupe fédérées.

Si vous développez une application à utiliser dans des conversations de groupe fédérées avec des utilisateurs externes, inscrivez votre application en tant qu’application multilocataire dans Microsoft Entra ID. Cette action permet aux utilisateurs de plusieurs organisations d’accéder à votre application.

Remarque

Si vous souhaitez tester l’exemple de code avec un utilisateur externe dans une conversation de groupe fédéré, vous devez d’abord ajouter l’utilisateur externe en tant qu’invité à votre locataire. Pour plus d’informations, consultez Démarrage rapide : Ajouter un utilisateur invité et envoyer une invitation. Après avoir ajouté l’utilisateur au locataire, accédez à la conversation de groupe fédérée et ajoutez l’invité pour tester l’application.

Exemple de code

Exemple de nom Description Node.js
Teams Conversation Bot Cet exemple d’application affiche les noms des membres dans une conversation de groupe fédérée avec des utilisateurs externes. View

Voir aussi