Microsoft Teams を Teamwork Graph に接続する
企業のナレッジとともに、すべてのメッセージを検索可能にします。
はじめる前に
この設定では、インデックス化と検索のために Microsoft Teams から Atlassian に同期するデータを制御します。Rovo で実行時に Microsoft Teams のデータにアクセスする際は、ご自身の Microsoft Teams アクセス権が使用されます。
Teams を Teamwork Graph に接続するには、Microsoft Entra の管理者権限が必要です。
We encourage you to review your permissions in Microsoft Teams. By default, the Microsoft Teams connector will index every message in Teams, including private chats and private channels.
何がインデックス化されますか?
Microsoft Teams コネクタは、次のオブジェクトをインデックス化します。
Chats (group chats, meeting chats, direct 1:1 chats)
Channels (public, private, and shared)
Meeting transcripts (additional setup required)
Team and channel membership
Metadata of file and link attachments shared in channels
Metadata of tabs
The full content of file attachments uploaded through Teams is indexed through the SharePoint connector.
必要な権限
Connecting Teams requires the Microsoft Graph API permissions listed in the table that follows. Your Microsoft Entra admin will be asked to grant these during connector setup.
Permission name | タイプ | 説明 | Admin consent required |
|---|---|---|---|
Calendars.Read | Delegated | Read user calendars | いいえ |
Calendars.Read | アプリケーション | Read calendars in all mailboxes | はい |
Channel.ReadBasic.All | Delegated | Read the names and descriptions of channels | いいえ |
Channel.ReadBasic.All | アプリケーション | Read the names and descriptions of all channels | はい |
ChannelMember.Read.All | アプリケーション | Read the members of all channels | はい |
ChannelMessage.Read.All | Delegated | Read user channel messages | はい |
ChannelMessage.Read.All | アプリケーション | Read all channel messages | はい |
ChannelSettings.Read.All | アプリケーション | Read the names, descriptions, and settings of all channels | はい |
Chat.Read | Delegated | Read user chat messages | いいえ |
Chat.Read.All | アプリケーション | Read all chat messages | はい |
Chat.ReadBasic | Delegated | Read names and members of user chat threads | いいえ |
Chat.ReadBasic.All | アプリケーション | Read names and members of all chat threads | はい |
Chat.ReadWrite | Delegated | Read and write user chat messages | いいえ |
ChatMember.Read.All | アプリケーション | Read the members of all chats | はい |
ChatMessage.Read.All | アプリケーション | Read all chat messages | はい |
Directory.Read.All | Delegated | Read directory data | はい |
Group.Read.All | アプリケーション | Read all groups | はい |
GroupMember.Read.All | Delegated | Read group memberships | はい |
OnlineMeetings.Read | Delegated | Read user's online meetings | いいえ |
OnlineMeetings.Read.All | アプリケーション | Read online meeting details | はい |
OnlineMeetingTranscript.Read.All | アプリケーション | Read all transcripts of online meetings | はい |
Team.ReadBasic.All | アプリケーション | Get a list of all teams | はい |
TeamMember.Read.All | アプリケーション | Read the members of all teams | はい |
TeamsTab.Read.All | Delegated | Read tabs in Microsoft Teams | はい |
User.Read | Delegated | Sign in and read user profile | いいえ |
User.Read.All | アプリケーション | Read all users' full profiles | はい |
Connecting Teams to Team work Graph
操作できるユーザー ロール: 組織管理者 Atlassian Cloud: Standard、Premium、Enterprise アトラシアン ガバメント クラウド: 利用不可 |
To connect Teams to Teamwork graph:
移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
[アプリ] > [コネクタ] の順に選択します。
複数のサイトがある場合は、接続するサイトを選択してから [コネクタを追加] を選択します。
Select Microsoft Teams, then select Next.
Get your Tenant ID from your Microsoft Entra account.
In a new browser tab, log in to your Microsoft account at Entra at entra.microsoft.com.
サイド ナビゲーションの [Entra ID] で、[概要] を選択します。
Copy the Tenant ID to your clipboard.
Go back to Atlassian Administration, paste the copied tenant ID into the Microsoft Tenant ID field.
(Optional, but recommended) Enable meeting transcripts to configure your application access policy in Entra. See the “Enable meeting transcripts” section below on this page for detailed steps.
[Authorize Microsoft Teams (Microsoft Teams を承認)] を選択します。
Rovo アプリに必要な権限を受け入れるように Microsoft に誘導されます。
Complete the steps in the authorization flow.
Microsoft Teams should now be connected to Teamwork Graph.
Enable meeting transcripts
Meeting transcripts are not ingested by default, even if API permissions have been granted. To enable them, your Microsoft admin must configure an application access policy in Microsoft Entra. This lets Rovo crawl specific users' meeting transcripts.
Log into your Azure portal.
Open the Terminal.
Connect to Microsoft Teams:
Connect-MicrosoftTeamsCreate an application access policy. Run the following command, replacing the
AppIdsargument with your Rovo application ID for Microsoft Teams. Optionally, you can replace theDescriptionargument.New-CsApplicationAccessPolicy -Identity Transcripts-rovo-policy -AppIds "<rovo_application_id>" -Description "Enabling Transcripts Globally"Enable the policy globally (for the whole tenant). The
PolicyNameargument must be the same as theIdentityargument from Step 4.Grant-CsApplicationAccessPolicy -PolicyName Transcripts-rovo-policy -Global
Rovo ingests a user's transcripts only after the user has authorized themselves.
If a user authenticated to the Teams connector before the Microsoft admin enabled transcripts through the access policy, they must authenticate again.
The meeting organizer and all invitees (even if they did not attend) on the Microsoft Outlook calendar event can search for the transcript in Rovo.
Rovo only indexes meetings on the Outlook calendar. Rovo doesn’t index meetings created in Teams channels.
Required scopes for transcripts
権限 | タイプ | Admin consent required |
|---|---|---|
Calendars.Read | Delegated | いいえ |
Calendars.Read | アプリケーション | はい |
OnlineMeetings.Read | Delegated | いいえ |
OnlineMeetings.Read.All | アプリケーション | はい |
OnlineMeetingTranscript.Read.All | アプリケーション | はい |
Adminstrator controls
When you initially set up the Teams connector, you can manage the following in Atlassian Administration:
Allowlist and blocklist — restrict which specific Teams and Channels are ingested through the connector.
This configuration can be modified after initial setup.
Limit by date — set a time window for how far back content is ingested.
This configuration can’t be modified after initial setup.
次のステップ
Teams との接続が完了したら、次の手順に従います。
Messages, channels, and transcripts (if the administrator configured the application access policy) will start to show in Search incrementally over the next few hours.
チーム メンバーには、検索のフィルター オプションとして Teams が表示されます。Atlassian アカウントから Teams に接続していない場合は、結果を確認する前に接続を求められることがあります。これは、Teamwork Graph においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するために必要となります。
Depending on the number of objects in Teams, it may take some time for all your objects to be indexed and appear in Search.
この内容はお役に立ちましたか?