Microsoft Teams 用の Rovo を設定する

Rovo for Microsoft Teams works in 1:1 direct messages, group chats and channels without any admin setup. By default, Rovo replies ephemerally in group chats and channels: only the person who asked sees the answer, and they choose whether to post it to the chat.

Admin setup is only needed if a team wants Rovo to reply publicly using a shared account. This option appears as Shared account in Microsoft Teams and uses a service account in your Atlassian organization. Configuring it is a one-time task with three steps: connecting your Atlassian site to a Microsoft tenant, granting Microsoft Teams permissions, and installing the app from the Microsoft Marketplace.

More about how the two reply modes differ

はじめる前に

開始する前に、次の前提条件を確認してください。

• Atlassian 組織管理者としてのアクセス権

• アトラシアン サイトでの Rovo の有効化

• Access to admin.atlassian.com

• テナントの接続に使用する Microsoft 365 アカウント (Microsoft Entra 管理者権限が必要)

• A Microsoft Teams admin available to grant consent in Step 2 of Rovo configuration (this can be you, or a separate person)

ユーザーからの Rovo のセットアップ依頼の通知方法

When someone @mentions Rovo in a group chat or channel for the first time, they choose the Atlassian site and reply mode on a private setup card. If they select Shared account and nothing has been configured, Rovo tells them the option is unavailable and offers two options:

• Notify Admin (管理者に通知) — Rovo は、ユーザーが所属するすべての組織のすべての Atlassian 組織管理者にメールを送信します。ユーザーにはメールの送信後に確認画面が表示されます。

• Admin Setup (管理者によるセットアップ) — 管理者同意フローを直接開始します (ユーザーと管理者を兼ねている場合に便利です)。

The admin notification email

The email you receive has the subject: "Admin setup required - Enable Rovo for Microsoft Teams". It contains two links:

• Configure (設定) — Microsoft Teams の管理者同意フローに直接移動します。

• Install for myself (自分用にインストール) — Teams で自身の個人利用のために Rovo アプリをインストールします。

Rovo を設定する

メール内の [Configure (設定)] (または Teams の会話内の [Admin Setup (管理者によるセットアップ)] ボタン) を選択して、管理者同意フローを開始します。自身が管理者であるすべての Atlassian 組織がリストされたホームページが表示されます。設定する組織を選択します。

セットアップ ページが表示され、完了すべき 3 つのステップが示されます。

ステップ 1: アトラシアン サイトを Microsoft テナントに接続する (必須)

This step links your Microsoft 365 tenant to your Atlassian organization and sets up the service account Rovo uses to read Jira and Confluence data when replying with a shared account.

1a. Microsoft テナントを接続する

1. ステップ 1 で [Start (開始)] を選択します。導入画面には、必要な権限の概要とこのサポート ドキュメントへのリンクが記載されています。

2. [Next (次へ)] を選択します。Microsoft テナントへのサインインを求められます。

   • すでにサインインしている場合は、必要に応じて別のアカウントに切り替えることができます。

   • [Sign in to connect (サインインして接続)] を選択し、 Microsoft のログイン フローを完了して、[Accept (承認)] を選択して接続を承認します。

3. サインインが正常に完了したら、[Next (次へ)] を選択します。

4. 接続するアトラシアン サイトを選択します。Rovo が有効化されているサイトでのみ続行できます。[Next (次へ)] を選択します。

1b. サービス アカウントを作成する

Rovo は、チームに代わって Jira や Confluence から情報を検索して提示するために、チャンネルやグループ チャットでサービス アカウントを使用します。Atlassian 組織でこのアカウントを作成し、その OAuth 認証情報を生成する必要があります。

1. admin.atlassian.com に移動し、組織を選択します。

2. 左側のナビゲーションで、[ディレクトリ] を選択し、[サービス アカウント] を選択します。

3. [サービス アカウントを作成] を選択し、わかりやすい名前を付けます (例:「Rovo Teams Bot」)。

4. [アプリ ロールを選択] で、Rovo にアクセスさせる各 Atlassian アプリについて、サービス アカウントにユーザー ロールを割り当てます (例:Jira、Confluence)。

1c. OAuth 認証情報を作成する

1. [サービス アカウント] から、作成したばかりのサービス アカウントを開きます。

2. [認証情報を作成] を選択し、[OAuth 2.0] を選択します。

3. 認証情報に名前を付けます (例:「rovo-teams」)。

4. [スコープを選択] で、[スコープ タイプ: クラシック] フィルターを選択します。

5. 少なくとも次の 14 個のスコープを有効化する必要があります。

   • read:account

   • read:confluence-content.all

   • read:confluence-content.permission

   • read:confluence-content.summary

   • read:confluence-groups

   • read:confluence-props

   • read:confluence-space.summary

   • read:confluence-user

   • read:jira-user

   • read:jira-work

   • read:me

   • read:servicedesk-request

   • readonly:content.attachment:confluence

   • search:confluence

6. 確認して、[作成] を選択します。

7. クライアント ID とクライアント シークレットを保存します。いずれの値も次のステップで必要になります。これらは一度だけ表示されます。

1d. 同意フローで認証情報を入力する

1. Microsoft Teams の Rovo 管理者同意フローに戻ります。

2. サービス アカウントのメール アドレス、クライアント ID、クライアント シークレットをそれぞれ所定のフィールドに貼り付けます。

3. [完了] を選択します。

認証情報が承認されると、Microsoft テナントとアトラシアン サイトの間のマッピングが作成されます。

ステップ 2: Microsoft Teams の権限を付与する (必須)

For Rovo to summarize chats and perform actions in channels and group chats, it requires additional permissions from Microsoft. The app requires the following Microsoft Teams permissions:

• email

• offline_access

• openid

• profile

• User.Read

• ChannelMessage.Read.All

• Chat.Read

これらはユーザーの委任権限であり、テナント全体に対して Microsoft Teams 管理者が承認する必要があります。

1. ステップ 2 で [Start (開始)] を選択します。Rovo に必要な権限を説明するモーダルが表示されます (例:要約にはチャット メッセージの読み取り権限が必要)。

2. 自身のロールに応じて、適切なオプションを選択します。

Once permissions are granted, Rovo can summarize conversations and reply with a shared account.

ステップ 3: インストールする (必須)

The final step in the setup makes Rovo available for users across your Microsoft Teams organization. This applies to everyone using Rovo in Microsoft Teams, including direct messages and ephemeral replies. It is required even if your team doesn't use a shared account.

オプション A: 組織全体/グループを対象としたインストール (推奨)

Rovo を組織全体にインストールすると、ユーザーはすぐにアクセスできるようになり、個別のセットアップが不要になり、さらに管理者のサポート負担が軽減されます。セットアップするには、次の手順に従います。

1. Microsoft Teams 管理センターで、[Teams アプリ] に移動し、[アプリの管理] を選択します。

2. [Rovo] を選択し、[ユーザーとグループ] を選択します。

3. [Select to manage who this app... (このアプリが...ユーザーを管理します)] の下で [インストール] を選択します。

4. [アプリのインストール] ボタンを選択します。

5. 表示されるサイド メニューで、インストールの対象として [すべてのユーザー)] (または特定のユーザー/グループ) を選択します。

オプション B: ユーザーごとのインストール

ユーザーによるアプリの個別インストールを希望する場合は、まず Rovo のブロックが解除されていることを確認する必要があります。これを行うには、次の手順に従います。

1. Microsoft Teams 管理センターで、[Teams アプリ] に移動し、[アプリの管理] を選択します。

2. [Rovo] を選択し、[ユーザーとグループ] を選択します。

3. [可用性の編集] を選択します。

4. 可用性を [すべてのユーザー] に変更し、[適用] を選択します。Teams 用 Rovo を特定のユーザーまたはグループのみが利用できるようにする場合は、[特定のユーザーまたはグループ] を選択します。

5. Rovo の可用性が [すべてのユーザーが使用可能] に設定されていることを確認します。

ステップ 4: アプリを固定する (任意)

セットアップに必須ではありませんが、ユーザーが簡単に見つけられるように Rovo をアプリ バーに固定することをお勧めします。これにより、混乱を減らし、ロールアウト後の管理者へのサポート リクエストを最小限に抑えることができます。

ユーザーのアプリ バーに Rovo アプリを固定するには、次の手順に従います。

1. Microsoft Teams 管理センターにログインします。

2. [Teams アプリ] を選択し、[セットアップ ポリシー] を選択します。

3. [グローバル (組織全体の既定値)] を選択してポリシーを編集します。

4. [ピン留めされたアプリ] セクションまでスクロールし、[アプリの追加] を選択します。

5. Rovo を検索し、[追加] を選択します。

6. Rovo アプリを希望の位置にドラッグします。

7. 画面の下部で、[保存] を選択します。

Rovo が機能していることを確認する

After completing all three steps, go to any group chat or channel in Microsoft Teams and mention @Rovo configure, then select Shared account and save. Send a message mentioning @Rovo. Rovo should reply publicly within a few seconds.

If the shared account option is unavailable, or you still see a "not configured" message, check the following:

• ステップ 1 で選択したアトラシアン サイトで Rovo が有効化されていること。

• クライアント ID とクライアント シークレットが正しく入力されていること (不確かな場合は再入力する)。

• Step 2 is marked as complete: Microsoft Teams permissions were successfully granted.

Ephemeral replies don't depend on any of this setup, so your users can keep working with Rovo while you complete it.