Microsoft Teams Graph Spoke
Microsoft Teams Graph スポーク は、 Microsoft Teams のアプリケーション、カレンダー、チーム、チャネル、チャット、通知、Webhook を管理します。ユーザーとグループを作成、管理、または削除するには、Entra ID スポーク (旧称 Microsoft Azure Active Directory スポーク) を使用しますMicrosoft。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
- Microsoft Teams Graph スポーク のチームは、Microsoft Azure Active Directory のグループから作成されます。 Microsoft Teams Graph スポーク を使用してチームを作成するには、関連付けられたグループが Microsoft AzureActive Directory に存在する必要があります。
- ユーザーとグループの管理は、Microsoft AzureActive Directory のみを使用して行うことができ、 Microsoft Teams Graph スポーク は使用できません。
- チームは、MicrosoftOffice 365 のグループからのみ作成できます。
- Microsoft Teams のチーム ID は、Microsoft Azure Active Directory の関連グループのグループ ID と同じです。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。
スポークバージョン
Microsoft Teams Graph スポーク v4.0.0 が最新バージョンです。
サポートされているバージョン
Microsoft Graph REST API v1.0
スポークの依存関係
- ServiceNow 統合ハブ Runtime (com.glide.hub.integration.runtime)
- Flow Designer Designer Model (com.glide.hub.designer_backend.model)
- Complex Object (com.glide.cobject)
- ServiceNow 統合ハブ Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow 統合ハブ Action Template - Data Stream (com.glide.hub.action_type.datastream)
- Remote Tables (com.glide.script.vtable)
- ServiceNow IntegrationHub Action Step - Get Connection Info (com.glide.hub.action_step.get_connection_info)
スポークのフロー
Microsoft Teams Graph スポーク では、インシデントに追加された最新作業メモに関する詳細とともに Microsoft Teams チャットメッセージをアサインされたユーザーに投稿するタスクの自動化をデモするために、サンプルフロー「ServiceNow インシデント作業メモの更新を Microsoft Teams チャットに投稿」が提供されます。
スポークのサブフロー
| サブフロー | 説明 |
|---|---|
| インシデントの詳細を投稿 | 必要なインシデントの詳細を Microsoft Teams チャネルに投稿します。 |
| 受信通知の処理 | Webhook サブスクリプションから受信した入力データに基づいて、指定されたメッセージの詳細を取得します。 |
| Webhook サブスクリプションヘルパーサブフローの更新 | 更新が必要な場合にサブスクリプションを更新します。これは入力に基づいて決定されます。 |
| Webhook サブスクリプションを更新 | すべての Webhook サブスクリプションを取得し、更新が必要な場合は更新します。 |
| Webhook を登録 | 指定されたチームのチャネルの Webhook サブスクリプションを作成します。 |
スポークのアクション
| カテゴリ | アクション | 説明 | 必要な権限 (権限の低いものから順に) | |
|---|---|---|---|---|
| アプリケーション管理 | ユーザーにアプリケーションをインストール | 指定されたアプリケーションをユーザーの個人スコープにインストールします。 | 委任済み (職場または学校のアカウント) | TeamsAppInstallation.ReadWriteSelfForUser、TeamsAppInstallation.ReadWriteForUser |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamsAppInstallation.ReadWriteSelfForUser.All, TeamsAppInstallation.ReadWriteForUser.All | |||
| ユーザーアプリのインストールを検索 | ユーザーに対して指定されたアプリケーションのインストールの詳細を取得します。 | 委任済み (職場または学校のアカウント) | TeamsAppInstallation.ReadForUser、 TeamsAppInstallation.ReadWriteSelfForUser、 TeamsAppInstallation.ReadWriteForUser | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamsAppInstallation.ReadForUser.All、 TeamsAppInstallation.ReadWriteSelfForUser.All、 TeamsAppInstallation.ReadWriteForUser.All | |||
| カレンダー管理 | 会議を作成 | MS Teams カレンダーのオンライン会議イベントを作成します。 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | |||
| アプリケーション | Calendars.ReadWrite | |||
| 会議を削除 | MS Teams カレンダーから会議イベントを削除します。 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | |||
| アプリケーション | Calendars.ReadWrite | |||
| 会議を検索 | MS Teams カレンダーから会議イベントの詳細を取得します。 | 委任済み (職場または学校のアカウント) | Calendars.Read | |
| 委任済み (個人の Microsoft アカウント) | Calendars.Read | |||
| アプリケーション | Calendars.Read | |||
| 会議を検索 | MS Teams カレンダーから繰り返し子会議 ID を取得します。 | 委任済み (職場または学校のアカウント) | Calendars.Read | |
| 委任済み (個人の Microsoft アカウント) | Calendars.Read | |||
| アプリケーション | Calendars.Read | |||
| 会議ストリームを検索 | MS Teams カレンダーから会議イベントの詳細を取得します。 | 委任済み (職場または学校のアカウント) | Calendars.Read, Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.Read, Calendars.ReadWrite | |||
| アプリケーション | Calendars.Read, Calendars.ReadWrite | |||
| スケジュールを検索 | 指定された期間のユーザー、配布リスト、またはリソース (ルームまたは機器) のコレクションの可用性情報 (空き/ビジー) を取得します。 | 委任済み (職場または学校のアカウント) | Calendars.Read, Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Calendars.Read, Calendars.ReadWrite | |||
| 会議を更新 | MS Teams カレンダーのオンライン会議イベントを作成します。 | 委任済み (職場または学校のアカウント) | Calendars.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Calendars.ReadWrite | |||
| アプリケーション | Calendars.ReadWrite | |||
| Channel Management | チャネルにメンバーを追加 | 指定されたメンバーを指定されたチャネルに追加します。 | 委任済み (職場または学校のアカウント) | ChannelMember.ReadWrite.All |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMember.ReadWrite.All | |||
| チャネルを作成 | チームの新しいチャネルを作成します。 | 委任済み (職場または学校のアカウント) | Channel.Create、Group.ReadWrite.All**、Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Channel.Create.Group*、Channel.Create、Teamwork.Migrate.All、 Group.ReadWrite.All**、Directory.ReadWrite.All** | |||
| チャネルを削除 | 指定されたチームから指定されたチャネルを削除し、すべての会話を削除します。 | 委任済み (職場または学校のアカウント) | Channel.Delete.All、Group.ReadWrite.All**、Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Channel.Delete.Group*、Channel.Delete.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |||
| チャネルを検索 | チャネルのプロパティと関係を取得します。 | 委任済み (職場または学校のアカウント) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelSettings.Read.Group*、ChannelSettings.ReadWrite.Group*、 Channel.ReadBasic.All、ChannelSettings.Read.All、 ChannelSettings.ReadWrite.All、Group.Read.All**、Group.ReadWrite.All**、 Directory.Read.All**、Directory.ReadWrite.All** | |||
| 名前でチャネルを検索 | チャネル ID、およびチャネル名とチーム ID が指定されたプロパティを取得します。 | 委任済み (職場または学校のアカウント) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelSettings.Read.Group*、ChannelSettings.ReadWrite.Group*、Channel.ReadBasic.All、ChannelSettings.Read.All、ChannelSettings.ReadWrite.All、Group.Read.All**、Group.ReadWrite.All**、Directory.Read.All**、Directory.ReadWrite.All** | |||
| チャネルメンバーを検索 | チャネルメンバーのリストを取得します。 | 委任済み (職場または学校のアカウント) | ChannelMember.Read.All、ChannelMember.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMember.Read.All、ChannelMember.ReadWrite.All | |||
| チャネルメッセージを検索 | チームのチャネル内のメッセージのリストを取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.Group*、ChannelMessage.Read.All | |||
| チャネルを検索 | 該当するチームのチャネルのリストを取得します。 | 委任済み (職場または学校のアカウント) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelSettings.Read.Group*、ChannelSettings.ReadWrite.Group*、 Channel.ReadBasic.All、ChannelSettings.Read.All、 ChannelSettings.ReadWrite.All、Group.Read.All**、Group.ReadWrite.All**、 Directory.Read.All**、Directory.ReadWrite.All** | |||
| チャネルからメンバーを削除 | 指定されたチャネルから指定されたユーザーを削除します。 | 委任済み (職場または学校のアカウント) | ChannelMember.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMember.ReadWrite.All | |||
| チャット管理 | チャットを作成 | ユーザー間のチャットを作成します。 | 委任済み (職場または学校のアカウント) | Chat.Create、Chat.ReadWrite |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Chat.Create | |||
| チャットメッセージデルタストリームを検索 | チームのチャネルからメッセージのリスト (返信は除外) を取得します。 | 委任済み (職場または学校のアカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |||
| アプリケーション | Mail.ReadBasic.All、Mail.Read、Mail.ReadWrite | |||
| チャットメッセージを検索 | チャット内のメッセージのリストを取得します。 | 委任済み (職場または学校のアカウント) | Chat.Read、Chat.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Chat.Read.All, Chat.ReadWrite.All | |||
| チャットを検索 | ユーザーが参加しているチャットのリストを取得します。 | 委任済み (職場または学校のアカウント) | Chat.ReadBasic、Chat.Read、Chat.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Chat.ReadBasic.All*、Chat.Read.All*、Chat.ReadWrite.All* | |||
| メッセージを検索 | 指定されたメッセージの詳細を取得します。 | 委任済み (職場または学校のアカウント) | Chat.Read、Chat.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Chat.Read.All, Chat.ReadWrite.All | |||
| メッセージ返信ストリームを検索 | チームのチャネルから指定されたメッセージに対する返信のリストを取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.Group*、ChannelMessage.Read.All | |||
| チャットにメッセージを投稿 | Microsoft Teams チャットにメッセージを投稿します。 | 委任済み (職場または学校のアカウント) | ChatMessage.Send、Chat.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | サポート対象外 | |||
| 通知管理 | 変更の詳細を投稿 | 必要な変更の詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Teamwork.Migrate.All | |||
| インシデントの詳細を投稿 | 必要なインシデントの詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Teamwork.Migrate.All | |||
| メッセージを投稿 | メッセージを Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Teamwork.Migrate.All | |||
| 問題の詳細を投稿 | 必要な問題の詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Teamwork.Migrate.All | |||
| メッセージに返信を投稿 | 指定されたメッセージへの返信を投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Teamwork.Migrate.All | |||
| チーム管理 | チームにメンバーを追加 | 指定されたチームに指定されたユーザーを追加します。 | 委任済み (職場または学校のアカウント) | TeamMember.ReadWrite.All |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamMember.ReadWrite.All | |||
| チームをアーカイブ | チームがアーカイブされると、ユーザーはチーム内のどのチャネルでもメッセージを送信したり、いいねしたり、チーム設定を更新したりできなくなります。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamSettings.ReadWrite.Group*、TeamSettings.ReadWrite.All、 Group.ReadWrite.All**、Directory.ReadWrite.All** | |||
| チームを作成 | 既存の Office 365 グループからチームを作成します。 注: チーム ID はグループ ID と同じです。 |
委任済み (職場または学校のアカウント) | Group.ReadWrite.All、Directory.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Group.ReadWrite.All, Directory.ReadWrite.All | |||
| チームを削除 | 指定されたチームを削除します。 | 委任済み (職場または学校のアカウント) | Group.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Group.ReadWrite.All | |||
| チームを検索 | チームのプロパティと関係を取得します。 | 委任済み (職場または学校のアカウント) | Team.ReadBasic.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、Group.Read.All**、Group.ReadWrite.All**、Directory.Read.All**、Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamSettings.Read.Group*、TeamSettings.ReadWrite.Group*、Team.ReadBasic.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、Group.Read.All**、Group.ReadWrite.All**、Directory.Read.All**、Directory.ReadWrite.All** | |||
| チームメンバーのストリームを検索 | チームメンバーのリストを取得します。 | 委任済み (職場または学校のアカウント) | TeamMember.Read.All、TeamMember.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamMember.Read.Group*、TeamMember.Read.All、TeamMember.ReadWrite.All | |||
| ユーザーでチームを検索 | ID とその表示名を含め、ユーザーのチームをリストします。 | 委任済み (職場または学校のアカウント) | Team.ReadBasic.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、User.Read.All、User.ReadWrite.All、Directory.Read.All**、Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | Team.ReadBasic.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、User.Read.All、User.ReadWrite.All、Directory.Read.All**、Directory.ReadWrite.All** | |||
| チームからメンバーを削除 | 指定されたチャネルから指定されたメンバーを削除します。 | 委任済み (職場または学校のアカウント) | TeamMember.ReadWrite.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamMember.ReadWrite.All | |||
| チームをアーカイブ解除 | アーカイブされたチームを復元します。メンバーは、チーム内のチャネルに投稿したり、コメントを作成したり、もう一度投稿にいいねしたりできます。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamSettings.ReadWrite.Group*、TeamSettings.ReadWrite.All、 Group.ReadWrite.All**、Directory.ReadWrite.All** | |||
| チームを更新 | 特定のチームのプロパティを更新します。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | TeamSettings.ReadWrite.Group*、TeamSettings.ReadWrite.All、 Group.ReadWrite.All**、Directory.ReadWrite.All** | |||
| Webhook 管理 | Webhook サブスクリプションを検索 | 必要な Webhook サブスクリプションの詳細を取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |||
| Webhook サブスクリプションストリームを検索 | すべての Webhook サブスクリプションの詳細を取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |||
| Webhook サブスクリプションを更新 | 指定された Webhook サブスクリプションを更新します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |||
| Webhook を登録 | 指定されたリソースの Webhook サブスクリプションを作成します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |||
| Webhook を登録解除 | 指定された Webhook サブスクリプションを削除します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| 委任済み (個人の Microsoft アカウント) | サポート対象外 | |||
| アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |||
必要なアクセス許可の詳細については、次を参照してください。 Microsoft Teams ドキュメント.
チャネル Microsoft TeamsID とグループ ID にアクセスする方法の詳細については、「」を参照してください。 Microsoft Teams ドキュメント.
スポークモジュール
| モジュール | 説明 |
|---|---|
| デルタトークン | 利用可能なデルタトークンのリストを表示します。 |
| Webhook レジストリ | 使用可能な Webhook レジストリのリストを表示します。 |
| Webhook 決定ポリシー | 決定ポリシーのリストを表示します。 |
| Webhook サブスクリプション | Webhook サブスクリプションの詳細を表示します。 |
Microsoftアカウント要件
Microsoft Teams Graph スポークで OAuth 2.0 トークンを生成するには、MicrosoftAzure ポータルを使用してアプリケーションを登録する必要があります。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「資格情報と接続情報」を参照してください。
スポークの設定については、「 Microsoft Teams Graph スポーク のセットアップ。
MID サーバー の要件
Microsoft Teams Graph スポークのアクションは REST コールを使用しており、インスタンスでもMID サーバーでも実行できます。Microsoftエイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所およびMID サーバー選択属性を設定します。 詳細については「MID Server」を参照してください。