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:

  1. 移動 アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。

  2. [アプリ] > [コネクタ] の順に選択します。

  3. 複数のサイトがある場合は、接続するサイトを選択してから [コネクタを追加] を選択します。

  4. Select Microsoft Teams, then select Next.

  5. Get your Tenant ID from your Microsoft Entra account.

    1. In a new browser tab, log in to your Microsoft account at Entra at entra.microsoft.com.

    2. サイド ナビゲーションの [Entra ID] で、[概要] を選択します。

    3. Copy the Tenant ID to your clipboard.

  6. Go back to Atlassian Administration, paste the copied tenant ID into the Microsoft Tenant ID field.

  7. (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.

  8. [Authorize Microsoft Teams (Microsoft Teams を承認)] を選択します。

  9. Rovo アプリに必要な権限を受け入れるように Microsoft に誘導されます。

  10. 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.

  1. Log into your Azure portal.

  2. Open the Terminal.

  3. Connect to Microsoft Teams:

    Connect-MicrosoftTeams
  4. Create an application access policy. Run the following command, replacing the AppIds argument with your Rovo application ID for Microsoft Teams. Optionally, you can replace the Description argument.

    New-CsApplicationAccessPolicy -Identity Transcripts-rovo-policy -AppIds "<rovo_application_id>" -Description "Enabling Transcripts Globally"
  5. Enable the policy globally (for the whole tenant). The PolicyName argument must be the same as the Identity argument 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 との接続が完了したら、次の手順に従います。

  1. Messages, channels, and transcripts (if the administrator configured the application access policy) will start to show in Search incrementally over the next few hours.

  2. チーム メンバーには、検索のフィルター オプションとして Teams が表示されます。Atlassian アカウントから Teams に接続していない場合は、結果を確認する前に接続を求められることがあります。これは、Teamwork Graph においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するために必要となります。

  3. Depending on the number of objects in Teams, it may take some time for all your objects to be indexed and appear in Search.

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。