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 アクセス許可 を割り当てて、ロボットがユーザーに代わってアクセスできるリソースを指定します。

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

これは 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 Beta を使用しています。エンドポイントは異なるため、コネクションを確立するには、パッケージごとに専用のスコープ アクティビティが必要です。

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

テクニカル リファレンス

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

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

はじめに

「セットアップ」ガイドの手順を完了しておく必要があります。

セットアップ手順が完了したら、「クイックスタート」ガイドをご覧ください。これらのガイドには、各種アクティビティの実用的なサンプルを作成するためのステップバイステップの手順が記載されており、登録済みのアプリケーションへの接続を確認したり、入/出力プロパティに習熟したりすることができます。

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

• Channels
• Chats
• Messages
• Teams