Поделиться через

Microsoft Teams Связи общих каналов

Microsoft Teams Связи общих каналов позволяют участникам канала сотрудничать с пользователями в других командах и организациях. Вы можете создать общий канал и предоставить общий доступ к ним:

  • Члены другой команды в той же организации.
  • Пользователи в одной организации.
  • Частные лица и другие команды других организаций.

Примечание.

Teams Связи общих каналов обеспечивают безопасную совместную работу. Разрешить внешним пользователям за пределами организации работать с внутренними пользователями в Teams без изменения их контекста пользователей. Улучшение взаимодействия с пользователем в отличие от использования гостевых учетных записей, например, участники должны выйти из Teams и снова войти с помощью гостевой учетной записи. Приложения Teams расширяют возможности совместной работы.

Схема: команда B из организации A и команда C из организации B, совместная работающая в общем канале как команда A.

Включение приложения для общих каналов

SupportedChannelTypes — это необязательное свойство, которое позволяет приложению использовать нестандартные каналы. Если приложение поддерживает командную область и свойство определено, Teams включает приложение в каждом типе канала соответствующим образом. Поддерживаются частные и общие каналы. Дополнительные сведения см. в разделе SupportedChannelTypes.

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

Примечание.

  • Если приложение поддерживает командные область, оно работает в стандартных каналах, независимо от того, какие значения определены в этом свойстве.
  • Чтобы правильно функционировать, приложению может потребоваться учет уникальных свойств каждого из этих типов каналов.

Получение контекста для общих каналов

При загрузке пользовательского интерфейса содержимого в общий канал используйте данные, полученные из getContext вызова, для изменения общего канала. getContext при вызове публикуются два новых свойства и hostTeamGroupIDhostTenantID, которые используются для получения членства в канале с помощью API Microsoft Graph. hostTeam — это команда, создающая общий канал.

Дополнительные сведения о включении вкладки см. в разделе:

Приложения и разрешения в общих каналах

Вы можете работать с внешними участниками за пределами организации с помощью общих каналов. Разрешения приложений в общих каналах соответствуют списку приложений команды узла и политике приложений клиента узла.

Примечание.

API уведомлений веб-канала действий не поддерживает уведомления между арендаторами для приложений в общем канале.

Получение членства в общем канале

Вы можете получить прямое членство в общем канале hostTeamGroupID с помощью и getContext выполните следующие действия:

  1. Получите прямых участников с помощью API API членов канала GET .

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

  2. Получение каждой общей команды с помощью GET sharedWithTeams API.

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

  3. Используйте GET членов каждой общей команды (Team X) с ПОМОЩЬЮ API GET sharedWithTeams .

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

Классифицируйте члены в общем канале как в клиенте или в out-tenant

Члены можно классифицировать как в клиенте или out-tenant путем сравнения tenantID участника или команды следующим hostTeamTenantID образом:

  1. Получите элемент, который вы хотите сравнить.

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

  2. Используйте getContext, сравните tenantID элемент со свойством hostTenantID .

Microsoft Entra собственное удостоверение

Приложения должны работать между арендаторами при установке и использовании. В следующей таблице перечислены типы каналов и соответствующие им идентификаторы групп:

Тип канала groupId hostTeamGroupId
Regular Идентификатор группы Microsoft Entra команды Идентификатор группы Microsoft Entra команды
Shared переменная Empty Идентификатор группы Microsoft Entra хост-команды

Приложения в федеративных групповых чатах с внешними пользователями

Примечание.

Teams поддерживает использование приложений в федеративных групповых чатах с внешними пользователями. Эти пользователи не могут добавлять, обновлять или удалять приложения из группового чата. Только узел группового чата может добавлять, обновлять или удалять приложения. Однако все участники чата, включая внешних пользователей, могут использовать приложения при следующих условиях:

  • Администратор клиента организации узла группового чата и администратор клиента организации внешнего пользователя должны разрешить использование приложения в федеративных групповых чатах. Дополнительные сведения см. в разделе Приложения Teams для внешних участников или гостей из-за пределов организации.
  • Приложение предоставляет доступ внешним пользователям в чатах федеративных групп.

Если вы разрабатываете приложение для использования в федеративных групповых чатах с внешними пользователями, зарегистрируйте приложение в качестве мультитенантного приложения в Microsoft Entra ID. Это действие позволяет пользователям в нескольких организациях получить доступ к вашему приложению.

Примечание.

Если вы хотите протестировать пример кода с внешним пользователем в федеративном групповом чате, сначала необходимо добавить внешнего пользователя в качестве гостя в клиент. Дополнительные сведения см. в статье Краткое руководство. Добавление гостевого пользователя и отправка приглашения. После добавления пользователя в клиент перейдите в чат федеративной группы и добавьте гостя для тестирования приложения.

Пример кода

Название примера Описание Node.js
Бот для бесед Teams В этом примере приложения отображаются имена участников в федеративном групповом чате с внешними пользователями. Просмотр

См. также