Partilhar via


Conexão Microsoft Teams canais partilhados

Conexão Microsoft Teams canais partilhados permitem que os membros de um canal colaborem com utilizadores de outras equipas e organizações. Pode criar e partilhar um canal partilhado com:

  • Membros de outra equipa na mesma organização.
  • Indivíduos na mesma organização.
  • Indivíduos e outras equipas de outras organizações.

Observação

Conexão Teams canais partilhados facilitam a colaboração segura de forma totalmente integrada. Permitir que utilizadores externos fora da sua organização colaborem com utilizadores internos no Teams sem alterar o contexto de utilizador. Melhore a experiência do utilizador ao contrário da utilização de contas de convidado, por exemplo, os membros têm de terminar sessão no Teams e iniciar sessão novamente com uma conta de convidado. As aplicações do Teams expandem o poderoso espaço de colaboração.

Diagrama que mostra a Equipa B da organização A e a Equipa C da organização B a colaborar num Canal partilhado como Equipa A.

Ativar a sua aplicação para canais partilhados

SupportedChannelTypes é uma propriedade opcional que permite a sua aplicação em canais não padrão. Se a sua aplicação suportar o âmbito da equipa e a propriedade estiver definida, o Teams ativa a sua aplicação em cada tipo de canal em conformidade. Os canais privados e partilhados são suportados. Para obter mais informações, veja supportedChannelTypes.

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

Observação

  • Se a sua aplicação suportar o âmbito da equipa, funciona em canais padrão, independentemente dos valores definidos nesta propriedade.
  • A sua aplicação poderá ter de ter em conta as propriedades exclusivas de cada um destes tipos de canal para funcionar corretamente.

Obter contexto para canais partilhados

Quando a EXPERIÊNCIA de conteúdo é carregada num canal partilhado, utilize os dados recebidos da getContext chamada para alterações de canais partilhados. getContext A chamada publica duas novas propriedades, hostTeamGroupID e hostTenantID, que são utilizadas para obter a associação a canais com as APIs do Microsoft Graph. hostTeam é a equipa que cria o canal partilhado.

Para obter mais informações sobre como ativar o separador, consulte:

Aplicações e permissões em canais partilhados

Pode colaborar com membros externos fora da sua organização através de canais partilhados. As permissões de aplicações em canais partilhados seguem a lista de aplicações da equipa anfitriã e a política de aplicações do inquilino anfitrião.

Observação

A API de notificação do feed de atividades não suporta notificações entre inquilinos para aplicações num canal partilhado.

Obter associação a canais partilhados

Pode obter a associação direta a canais partilhados ao utilizar e hostTeamGroupIDgetContext seguir estes passos:

  1. Obtenha membros diretos com a API de API de membros do canal GET .

    GET /teams/{host-team-group-id}/channels/{channel-id}/members
    
  2. Obtenha cada equipa partilhada com a API GET sharedWithTeams .

    GET /teams/{host-team-group-id}/channels/{channel-id}/sharedWithTeams
    
  3. Utilize os membros GET de cada equipa partilhada (Equipa X) com a API GET sharedWithTeams .

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

Classificar membros no canal partilhado como no inquilino ou fora do inquilino

Pode classificar os membros como no inquilino ou fora do inquilino ao comparar tenantID o membro ou a equipa com hostTeamTenantID o seguinte:

  1. Obtenha o membro que pretende comparar.

    GET /teams/{host-team-group-id}/channels/{channel-id}/members
    
  2. Utilize getContext, compare o tenantID membro com a hostTenantID propriedade .

Microsoft Entra identidade nativa

As aplicações têm de funcionar entre inquilinos na instalação e utilização. A tabela seguinte lista os tipos de canal e os respetivos IDs de grupo correspondentes:

Tipo de canal groupId hostTeamGroupId
Regular ID do grupo de Microsoft Entra de equipa ID do grupo de Microsoft Entra de equipa
Compartilhados Vazio ID do grupo de Microsoft Entra da Equipa de Anfitriões

Confira também