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 a mostrar 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.
  • Atualmente, apenas os separadores são suportados em canais privados e partilhados no Microsoft Teams.

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

Aplicações em conversas de grupo federadas com utilizadores externos

Observação

O Teams suporta a utilização de aplicações em conversas de grupo federadas com utilizadores externos. Estes utilizadores não podem adicionar, atualizar ou remover aplicações do chat de grupo. Apenas o anfitrião do chat de grupo pode adicionar, atualizar ou remover aplicações. No entanto, todos os membros do chat, incluindo utilizadores externos, podem utilizar aplicações nas seguintes condições:

Se estiver a desenvolver uma aplicação para utilização em conversas de grupo federadas com utilizadores externos, registe a sua aplicação como uma aplicação multi-inquilino no Microsoft Entra ID. Esta ação permite que os utilizadores de várias organizações acedam à sua aplicação.

Observação

Se quiser testar o exemplo de código com um utilizador externo numa conversa de grupo federada, primeiro tem de adicionar o utilizador externo como convidado ao seu inquilino. Para obter mais informações, consulte Início Rápido: Adicionar um utilizador convidado e enviar um convite. Depois de adicionar o utilizador ao inquilino, aceda ao chat do grupo federado e adicione o convidado para testar a aplicação.

Exemplo de código

Nome do exemplo Descrição Node.js
Bot de Conversação do Teams Esta aplicação de exemplo apresenta os nomes dos membros numa conversa de grupo federada com utilizadores externos. Exibir

Confira também