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.

権限名

タイプ

説明

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. Select Connectors, then All connectors.

  3. Select Add connector, then, if you have more than one site, choose the site you want to connect to.

  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.

Optional: turn on Allow users to see results without connecting their account for supported Microsoft Teams content.

When this setting is on, users may see public and private Teams channel messages and conversations in Rovo Search, Chat, and Agents without connecting their Microsoft Teams account. Access permissions are still respected through synced Teams permissions. Permission changes may take up to 48 hours to be reflected.

Direct messages, group direct messages, and meeting transcripts are not covered by this setting. Users still need to connect their account to see those results.

When the setting is off, users must connect Microsoft Teams to see Teams results.

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 meeting 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. If users haven't connected Microsoft Teams from their Atlassian account, they may be asked to connect before they can see results. This helps Teamwork Graph make sure users only see results they have access to.

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

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