Conexão Microsoft Teams canais compartilhados

Conexão Microsoft Teams Os canais compartilhados permitem que os membros de um canal colaborem com usuários de outras equipes e organizações. Você pode criar e compartilhar um canal compartilhado com:

  • Membros de outra equipe dentro da mesma organização.
  • Indivíduos dentro da mesma organização.
  • Indivíduos e outras equipes de outras organizações.

Observação

Conexão Teams Os canais compartilhados facilitam a colaboração segura de forma integrada. Permitir que usuários externos fora da sua organização colaborem com usuários internos no Teams sem alterar o contexto de usuário. Aprimorar a experiência do usuário Ao contrário de usar contas de convidado, por exemplo, os membros devem sair do Teams e entrar novamente usando uma conta de convidado. Os aplicativos do Teams ampliam o poderoso espaço de colaboração.

O diagrama mostra a Equipe B da organização A e a Equipe C da organização B colaborando em um canal compartilhado como Equipe A.

Habilitar seu aplicativo para canais compartilhados

SupportedChannelTypes é uma propriedade opcional que habilita seu aplicativo em canais não padrão. Se o aplicativo der suporte ao escopo da equipe e a propriedade estiver definida, o Teams habilitará seu aplicativo em cada tipo de canal adequadamente. Há suporte para canais privados e compartilhados. Para obter mais informações, consulte supportedChannelTypes.

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

Observação

  • Se o aplicativo der suporte ao escopo da equipe, ele funcionará em canais padrão, independentemente dos valores definidos nessa propriedade.
  • Seu aplicativo pode precisar levar em conta as propriedades exclusivas de cada um desses tipos de canal para funcionar corretamente.
  • No momento, há suporte apenas para guias em canais privados e compartilhados no Microsoft Teams.

Obter contexto para canais compartilhados

Quando a experiência do usuário de conteúdo for carregada em um canal compartilhado, use os dados recebidos da chamada para alterações de getContext canal compartilhado. getContext publica duas novas propriedades hostTeamGroupID e hostTenantID, que são usadas para recuperar a associação ao canal usando APIs do Microsoft Graph. hostTeam é a equipe que cria o canal compartilhado.

Para obter mais informações sobre como habilitar sua guia, consulte:

Aplicativos e permissões em canais compartilhados

Você pode colaborar com membros externos fora da sua organização usando canais compartilhados. As permissões de aplicativo em canais compartilhados seguem a lista de aplicativos da equipe anfitriã e a política de aplicativo do locatário do host.

Observação

A API de notificação do feed de atividades não dá suporte a notificações entre locatários para aplicativos em um canal compartilhado.

Obter associação ao canal compartilhado

Você pode obter a associação direta ao canal compartilhado usando o hostTeamGroupID de getContext e seguindo estas etapas:

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

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

  2. Obtenha cada equipe compartilhada com a API GET sharedWithTeams .

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

  3. Use membros GET de cada equipe compartilhada (Equipe X) com a API GET sharedWithTeams .

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

Classificar membros no canal compartilhado como inquilinos ou fora do locatário

Você pode classificar membros como locatários ou locatários externos comparando tenantID o membro ou a equipe com hostTeamTenantID a seguinte maneira:

  1. Obtenha o membro que você deseja comparar.

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

  2. Use getContext, compare o tenantID do membro com a hostTenantID propriedade.

Identidade nativa do Microsoft Entra

Os aplicativos devem funcionar entre locatários na instalação e no uso. A tabela a seguir lista os tipos de canal e suas IDs de grupo correspondentes:

Tipo de canal groupId hostTeamGroupId
Regular ID do grupo Team Microsoft Entra ID do grupo Team Microsoft Entra
Compartilhados Vazio Equipe Anfitriã ID do grupo do Microsoft Entra

Aplicativos em chats em grupo federado com usuários externos

Observação

O Teams dá suporte ao uso de aplicativos em chats em grupo federados com usuários externos. Esses usuários não podem adicionar, atualizar ou remover aplicativos do chat em grupo. Somente o host do chat em grupo pode adicionar, atualizar ou remover aplicativos. No entanto, todos os membros do chat, incluindo usuários externos, podem usar aplicativos nas seguintes condições:

Se você estiver desenvolvendo um aplicativo para uso em chats de grupo federado com usuários externos, registre seu aplicativo como um aplicativo multilocatário no Microsoft Entra ID. Essa ação permite que usuários de várias organizações acessem seu aplicativo.

Observação

Se quiser testar a amostra de código com um usuário externo em um chat em grupo federado, primeiro você deverá adicionar o usuário externo como convidado ao seu locatário. Para obter mais informações, consulte Início Rápido: adicionar um usuário convidado e enviar um convite. Depois de adicionar o usuário ao locatário, vá para o chat em grupo federado e adicione o convidado para testar o aplicativo.

Exemplo de código

Nome do exemplo Descrição Node.js
Bot de Conversa do Teams Este aplicativo de exemplo exibe os nomes dos membros em um chat em grupo federado com usuários externos. Exibir

Confira também

  • Last updated on