セットアップ

はじめに

To enable the Microsoft Teams activities, your app must be integrated with the Microsoft identity platform and have the correct Microsoft Graph API permissions assigned to it.

To integrate your application, assign permissions, and start building your automation project, you will first need to decide if you will create your own app or use the UiPath app (for example, UiPathStudioO365App).

重要:

If you are using the UiPath app then you will need to ensure that you add admin consent.

管理者の同意を追加しない場合は、以下のエラーが表示されます。

独自のアプリを作成する場合は、以下の手順に従う必要があります。

After registering your Microsoft Office Teams application, Azure Active Directory assigns a unique application (client) ID that you enter in the Microsoft Office Teams Scope.

注:

If you already completed the Microsoft Office 365 Activities or have an existing registered application, you can go straight to the Add API permissions section and add the necessary permissions for the Microsoft Teams activities.

After adding the permissions, you'll be able to use the same ApplicationID in both the Microsoft Office 365 Scope and Microsoft Teams Scope activities.

手順

1. アプリケーションを登録する

1. Sign in to the Azure portal using your personal, work, or school Microsoft Office 365 account.

2. 左側のナビゲーション パネルにある [Azure Active Directory] をクリックします。

3. [Azure Active Directory] のページが開いたら、[アプリの登録] をクリックします。

4. 上部のナビゲーションバーで [+ 新規登録] をクリックします。

   

5. アプリケーションの [名前] を入力します (例: "Office365App")。

6. [サポートされているアカウントの種類] のセクションで、該当するオプションを選択します。

   • 選択するオプションに関する詳細として、以下に Microsoft による推奨事項を示します。
     • この組織ディレクトリのみに含まれるアカウント - ターゲット オーディエンスが組織内のユーザーである場合、このオプションを使用します。
     • 任意の組織ディレクトリ内のアカウント (任意の Azure AD ディレクトリ - マルチテナント) - ターゲット オーディエンスが、業務または教育関連の顧客であり、マルチテナントを有効化するには、このオプションを使用します。
     • 任意の組織ディレクトリ (Azure AD ディレクトリ - マルチテナント) 内のアカウントと、個人用の Microsoft アカウント (Skype、Xbox など) - 最も広範な Microsoft ID をターゲットとし、マルチテナントを有効化するには、このオプションを使用します。
   • [リダイレクト URI] (任意) に、URI アドレスを入力します (該当する場合)。
   • Your selection is dependent on your authentication type. For more information on this topic, see the Unattended and Attended Automation in the Microsoft Teams Scope activity details page).
   • 今回の例の組織は、マルチテナントの認証をサポートし、認証の種類としてはリダイレクト URI を必要とする対話型トークンのみを使用できます。
   • 認証の種類が統合 Windows 認証またはユーザー名とパスワードの場合、アプリケーションのリダイレクト URI の登録は不要です。これらのフローでは、Microsoft ID プラットフォーム v2.0 エンドポイントまでのラウンド トリップが行われ、アプリケーションが特定の URI でコール バックされることはありません。
   • For more information, see Desktop app-registration in the Microsoft identity platform documentation.

7. [登録] をクリックします。

   

   注:

   現在、Microsoft Authentication Library (MSAL.NET) は、既定のリダイレクト URI として urn:ietf:wg:oauth:2.0:oob を使用しています。認証の種類が対話型トークンの場合、おそらくこの値で問題ありません (UiPath ではすべての例と「クイックスタート」ページでこの値を使用しています)。

   将来、Microsoft は既定のリダイレクト URI を https://login.microsoftonline.com/common/oauth2/nativeclient に変更する予定であるため、代わりにこちらを使用することを検討してももよいでしょう。

これで完了です。それでは、登録したアプリケーションに API アクセス許可を割り当てましょう。

2. API のアクセス許可を追加する

1. From your registered application page (Azure portal > Azure Active Directory > App registrations > Office365App), click API permissions in the left-hand navigation panel.

2. [API のアクセス許可] ページが開いたら、[+ アクセス許可の追加] をクリックします ([API アクセス許可の要求] ウィンドウが開きます)。

3. [API を選択します] の下の [Microsoft API] をクリックします (既定で開いている場合もあります)。

4. [よく使用される Microsoft API] の下の [Microsoft Graph] をクリックします。

   

5. Under What type of permissions does your application require?, click Delegated permissions to show the list of permissions.

   • [アプリケーションのアクセス許可] でも機能しますが、アクティビティは、Microsoft Graph API に [委任されたアクセス許可] が割り当てられたアプリ向けに設計されています。
   • For more information about permission types, see Configure a client application to access web APIs in the Microsoft Azure documentation.

6. 検索バーを使用するか、アルファベット順のリストをスクロールして、以下のアクセス許可を選択します。

   • Chat.ReadWrite
   • Group.ReadWrite.All
   • User.Read.All

7. [アクセス許可の追加] をクリックします ([API のアクセス許可] リストに戻ります)。

   

8. Verify your API permissions include your added Chat, Group, and User permissions.

   

3. プロジェクトをビルドする

1. 新しいオートメーション プロジェクトを作成します。

   1. UiPath Studio を開きます。

   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。

   3. プロジェクトの [名前]、[場所]、[説明] を入力します。

   4. [Create] をクリックします。

      

2. Install the UiPath.MicrosoftTeamsActivities package.
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [Go!] をクリックします。
   3. In the Search bar, enter Teams.
   4. Click, install and accept the license for the UiPath.Teams.Activities.

      • For more information about Uipath Studio packages, see Managing Packages in the Studio Guide.

        

完了です!

以上で設定が完了したので、プロジェクトへの Microsoft Teams アクティビティの追加を開始できます。

次のステップ

For a hands-on learning experience and to quickly start using the activities, see the Quickstart guides. These guides provide step-by-step instructions to help you create working samples of the different activities so that you can verify the connection to your registered app and get familiar with the input/output properties.

Microsoft Teams アクティビティの詳細 (プロパティの入力/出力の例を含む) については、以下のアクティビティのページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

• Channels
• Chats
• Messages
• Teams