Conexão Microsoft Teams canais compartilhados

  • Artigo

Conexão Microsoft Teams canais compartilhados permitem que membros de um canal colaborem com usuários em 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

Aplicativos de guia em canais compartilhados estão disponíveis em ambientes de GCC (Government Community Cloud), GCC-High e Departamento de Defesa (DOD ).

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

Diagrama que 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 de acordo. No momento, 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 contabilizar as propriedades exclusivas de cada um desses tipos de canal para funcionar corretamente.

Obter contexto para canais compartilhados

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

Para obter mais informações para habilitar sua guia, confira:

Aplicativos e permissões em canais compartilhados

Você pode colaborar com membros externos fora de sua organização usando canais compartilhados. As permissões de aplicativo em canais compartilhados seguem a lista de aplicativos da equipe de host 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 de canal compartilhado

Você pode obter associação direta de canal compartilhado usando as hostTeamGroupIDgetContext seguintes etapas:

  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 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 (Team X) com a API GET sharedWithTeams .

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

Classificar membros no canal compartilhado como locatário ou locatário

Você pode classificar os membros como in-tenant ou out-tenant comparando tenantID o membro ou a equipe com hostTeamTenantID o seguinte:

  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.

Microsoft Entra identidade nativa

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 Microsoft Entra equipe ID do grupo Microsoft Entra equipe
Compartilhados Vazio ID do grupo do Host Team Microsoft Entra

Confira também