Marketplace ユーザーガイド

最終更新日時 2024年9月5日

Microsoft Teams

概要

Microsoft Teams は、チームが 1 か所で整理され会話を行えるコラボレーションアプリです。

Microsoft Teams アクティビティを使用すると、Microsoft Teams アプリケーションの操作を自動化できます。このアクティビティパッケージは Microsoft Graph API Beta と連携して、ロボットがチャンネルとチームの管理、チャットの取得、メッセージの取得と送信を行うことができます。

Microsoft Teams アクティビティを使用する準備が整っている場合は、ページ下部の「はじめに」のセクションをご覧ください。パッケージの詳細を確認する場合は、続いて以下の「動作のしくみ」と「テクニカルリファレンス」のセクションをご覧ください。

大事な：このアクティビティパッケージは、Windows - レガシプロジェクトと Windows プロジェクトに対応しています。クロスプラットフォームプロジェクトには対応していません。 Integration Service の Microsoft Teams アクティビティパッケージを使用することをお勧めします。

注:

UiPath Studio のバージョンの互換性とサポートについては、「プロダクトライフサイクル」のページをご覧ください。

動作のしくみ

UiPath と Microsoft Teams 間の発信業務の自動化を実現するため、Microsoft Teams アクティビティは[Microsoft Teams スコープ] アクティビティを介して、Microsoft Teams アプリケーションへの認証された接続を確立します。

接続が確立されると、他の Microsoft Teams アクティビティを追加して新しいオートメーションプロジェクトを作成したり、それらを既存のプロジェクトに追加して、Microsoft Teams アプリケーションを含むように自動化機能を拡張したりすることができます。

接続方法

最初のプロジェクトを構築する前に、事前準備が必要です。

認証された接続を確立するために、Microsoft Teams アクティビティは Microsoft ID プラットフォームからの認可を必要とします。

認可を有効化するには、まず Microsoft Teams アプリケーションを Azure Active Directory に登録します (個人、仕事、学校などの Microsoft Office 365 アカウントを使用します)。アプリケーションを登録するときに、[ Microsoft Graph API アクセス許可](https ://cloud.microsoft.microsoft.高値表示書)を割り当てて、ロボットがユーザーに代わってアクセスできるリソースを指定します。

Microsoft Teams アプリケーションの登録後、Azure Active Directory は、[ Microsoft Teams スコープ] アクティビティに入力した一意のアプリケーション (クライアント) ID を Azure Active Directory に割り当てます。 ApplicationID は、認証を開始し、アクセストークンを取得して接続を確立するために必要な情報を収集するために使用されます。

これは Microsoft Office 365 アクティビティとは異なる方法ですか?

Microsoft Office 365 と Microsoft Teams の両方のアクティビティパッケージのセットアップと技術要件は同じです。ただし、アプリケーションの登録時に割り当てる Microsoft Graph API アクセス許可は同じです。

Microsoft Office 365 と Microsoft Teams の両方のアクティビティは、登録アプリケーション情報 ([アプリケーション ID]) を収集するスコープアクティビティを使用します。実際、登録済みアプリケーションには、Microsoft Teams と他の Microsoft Office 365 アプリケーションの両方と対話するために必要なアクセス許可が含まれている可能性があります。その結果、自動化するすべてのアプリケーションに対する権限を持つ単一の アプリケーション ID が生成されます。

2 つのスコープアクティビティ ([Microsoft Office 365 スコープ] と [Microsoft Teams スコープ] ) が存在する違い、および理由は、使用されている Microsoft Graph API エンドポイントです。現在、Microsoft Office 365 アクティビティでは Microsoft Graph API が使用されていますが、Microsoft Teams アクティビティでは Microsoft Graph API ベータが使用 されています。これらの異なるエンドポイントにより、各パッケージは個別のスコープアクティビティを使用して接続を確立する必要があります。

今後は、両方のパッケージで [Microsoft Office 365 スコープ] アクティビティを [サービス ] プロパティオプションとして追加する チーム (既存の メール、 ファイル、 予定表に加えて) と共有します。

テクニカルリファレンス

各 Microsoft Teams アクティビティは、アクティビティの入力プロパティとして入力した要求パラメーターを使用して、 Microsoft Graph API を呼び出します。呼び出しに成功すると、アクティビティは関連する応答要素 (出力プロパティ) を出力します。この出力は、後続のアクティビティや既存のキュー内のキューアイテムなどの入力プロパティ値として使用できます。

各アクティビティで使用する Microsoft Graph API の全リストと、関連する API ドキュメントへのリンクについては、このページをご覧ください。Microsoft Graph API に精通していなくても、アクティビティは使用できます。これらのリンクは、「背後」で実行されている処理について詳細を知りたくなった場合の、情報提供のみを目的としたものです。