Microsoft Teams Graph スポーク
Microsoft Teams Graph スポーク は、 Microsoft Teams のアプリケーション、カレンダー、チーム、チャネル、チャット、通知、Webhook を管理します。ユーザーとグループを作成、管理、または削除するには、 Microsoft Entra ID スポーク (旧 Microsoft Azure Active Directory スポーク) を使用します。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
注:
- Microsoft Teams Graph スポーク のチームは、Microsoft Entra ID (旧 Microsoft Azure Active Directory) のグループから作成されます。 Microsoft Teams Graph スポークを使用してチームを作成するには、関連付けられたグループが Microsoft Entra ID に存在している必要があります。
- ユーザーとグループの管理は、Microsoft Entra ID のみを使用して行うことができ、 Microsoft Teams Graph スポークを使用することはできません。
- チームは、MicrosoftOffice 365 のグループからのみ作成できます。
- Microsoft Teams のチーム ID は、Microsoft Entra ID の関連グループのグループ ID と同じです。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Microsoft Teams Graph スポーク v4.3.0 が最新バージョンです。
サポートされているバージョン
Microsoft Graph REST API v1.0
スポークの依存関係
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
- ServiceNow 統合ハブ ランタイム (com.glide.hub.integration.runtime)
- フローデザイナーモデル (com.glide.hub.designer_backend.model)
- 複合オブジェクト (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 統合ハブアクションステップ - Get Connection Info (com.glide.hub.action_step.get_connection_info)
注:
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。
スポークのフロー
Microsoft Teams Graph スポーク では、インシデントに追加された最新作業メモに関する詳細とともに Microsoft Teams チャットメッセージをアサインされたユーザーに投稿するタスクの自動化をデモするために、サンプルフロー「ServiceNow インシデント作業メモの更新を Microsoft Teams チャットに投稿」が提供されます。
スポークのサブフロー
Microsoft Teams Graph スポーク では、タスクの自動化をデモするためのサンプルサブフローが提供されます。サンプルフローをカスタマイズするには、必要なアプリケーションスコープにコピーします。利用可能なサンプルサブフローは次のとおりです。
| サブフロー | 説明 |
|---|---|
| インシデントの詳細を投稿 | 必要なインシデントの詳細を Microsoft Teams チャネルに投稿します。 |
| 受信通知の処理 | Webhook サブスクリプションから受信した入力データに基づいて、指定されたメッセージの詳細を取得します。 |
| Webhook サブスクリプションヘルパーサブフローの更新 | 更新が必要な場合にサブスクリプションを更新します。これは入力に基づいて決定されます。 |
| Webhook サブスクリプションを更新 | すべての Webhook サブスクリプションを取得し、更新が必要な場合は更新します。 |
| Webhook を登録 | 指定されたチームのチャネルの Webhook サブスクリプションを作成します。 |
スポークのアクション
Microsoft Teams Graph スポークでは、ServiceNowインスタンスでインシデントが作成されたときに、チームとチャネルのタスクを自動化するアクションが提供されます。
一部のアクションは、Microsoft Teams スポーク接続を使用して実行でき、残りのアクションについては、Microsoft Teams Graph クライアント資格情報接続を使用して実行することができます。
次の表に示すアクションでは、Microsoft Teams スポークの接続および資格情報エイリアスレコードが使用されます。これらのアクションには、委任された権限が必要です。
| カテゴリ | アクション | 説明 | 必要な権限 (権限の低いものから順に) | |
|---|---|---|---|---|
| アプリケーション管理 | ユーザーにアプリケーションをインストール | 指定されたアプリケーションをユーザーの個人スコープにインストールします。 | 委任済み (職場または学校のアカウント) | TeamsAppInstallation.ReadWriteSelfForUser、TeamsAppInstallation.ReadWriteForUser |
| ユーザーアプリのインストールを検索 | ユーザーに対して指定されたアプリケーションのインストールの詳細を取得します。 | 委任済み (職場または学校のアカウント) | TeamsAppInstallation.ReadForUser、 TeamsAppInstallation.ReadWriteSelfForUser、 TeamsAppInstallation.ReadWriteForUser | |
| カレンダー管理 | スケジュールを検索 | 指定された期間のユーザー、配布リスト、またはリソース (ルームまたは機器) のコレクションの可用性情報 (空き/ビジー) を取得します。 | 委任済み (職場または学校のアカウント) | Calendars.Read, Calendars.ReadWrite |
| チャネル管理 | チャネルにメンバーを追加 | 指定されたメンバーを指定されたチャネルに追加します。 | 委任済み (職場または学校のアカウント) | ChannelMember.ReadWrite.All |
| チャネルを作成 | チームの新しいチャネルを作成します。 | 委任済み (職場または学校のアカウント) | Channel.Create、Group.ReadWrite.All**、Directory.ReadWrite.All** | |
| チャネルを削除 | 指定されたチームから指定されたチャネルを削除し、すべての会話を削除します。 | 委任済み (職場または学校のアカウント) | 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** | |
| 名前でチャネルを検索 | チャネル ID、およびチャネル名とチーム ID が指定されたプロパティを取得します。 | 委任済み (職場または学校のアカウント) | 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 | |
| チャネルメッセージを検索 | チームのチャネル内のメッセージのリストを取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| チャネルを検索 | 該当するチームのチャネルのリストを取得します。 | 委任済み (職場または学校のアカウント) | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All**, Group.ReadWrite.All**, Directory.Read.All**, Directory.ReadWrite.All** | |
| チャネルからメンバーを削除 | 指定されたチャネルから指定されたユーザーを削除します。 | 委任済み (職場または学校のアカウント) | ChannelMember.ReadWrite.All | |
| チャット管理 | チャットを作成 | ユーザー間のチャットを作成します。 | 委任済み (職場または学校のアカウント) | Chat.Create、Chat.ReadWrite |
| チャットメッセージデルタストリームを検索 | チームのチャネルからメッセージのリスト (返信は除外) を取得します。 | 委任済み (職場または学校のアカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |
| 委任済み (個人の Microsoft アカウント) | Mail.ReadBasic、Mail.Read、Mail.ReadWrite | |||
| チャットメッセージを検索 | チャット内のメッセージのリストを取得します。 | 委任済み (職場または学校のアカウント) | Chat.Read、Chat.ReadWrite | |
| チャットを検索 | ユーザーが参加しているチャットのリストを取得します。 | 委任済み (職場または学校のアカウント) | Chat.ReadBasic、Chat.Read、Chat.ReadWrite | |
| メッセージを検索 | 指定されたメッセージの詳細を取得します。 | 委任済み (職場または学校のアカウント) | Chat.Read、Chat.ReadWrite | |
| メッセージ返信ストリームを検索 | チームのチャネルから指定されたメッセージに対する返信のリストを取得します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Read.All | |
| チャットにメッセージを投稿 | Microsoft Teams チャットにメッセージを投稿します。 | 委任済み (職場または学校のアカウント) | ChatMessage.Send、Chat.ReadWrite、Group.ReadWrite.All | |
| 通知管理 | 変更の詳細を投稿 | 必要な変更の詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** |
| インシデントの詳細を投稿 | 必要なインシデントの詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| メッセージを投稿 | メッセージを Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| 問題の詳細を投稿 | 必要な問題の詳細を Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| メッセージに返信を投稿 | 指定されたメッセージへの返信を投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| レコードの詳細を投稿 | 指定されたレコードの詳細を、指定された Microsoft Teams チャネルに投稿します。 | 委任済み (職場または学校のアカウント) | ChannelMessage.Send, Group.ReadWrite.All** | |
| チーム管理 | チームにメンバーを追加 | 指定されたチームに指定されたユーザーを追加します。 | 委任済み (職場または学校のアカウント) | TeamMember.ReadWrite.All |
| チームをアーカイブ | チームがアーカイブされると、ユーザーはチーム内のどのチャネルでもメッセージを送信したり、いいねしたり、チーム設定を更新したりできなくなります。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
| チームを作成 | 既存の Office 365 グループからチームを作成します。 注: チーム ID はグループ ID と同じです。 | 委任済み (職場または学校のアカウント) | Group.ReadWrite.All、Directory.ReadWrite.All | |
| チームを削除 | 指定されたチームを削除します。 | 委任済み (職場または学校のアカウント) | Group.ReadWrite.All | |
| チームを検索 | チームのプロパティと関係を取得します。 | 委任済み (職場または学校のアカウント) | 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 | |
| ユーザーでチームを検索 | ID とその表示名を含め、ユーザーのチームをリストします。 | 委任済み (職場または学校のアカウント) | Team.ReadBasic.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、User.Read.All、User.ReadWrite.All、Directory.Read.All**、Directory.ReadWrite.All** | |
| チームからメンバーを削除 | 指定されたチャネルから指定されたメンバーを削除します。 | 委任済み (職場または学校のアカウント) | TeamMember.ReadWrite.All | |
| チームをアーカイブ解除 | アーカイブされたチームを復元します。メンバーは、チーム内のチャネルに投稿したり、コメントを作成したり、もう一度投稿にいいねしたりできます。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
| チームを更新 | 特定のチームのプロパティを更新します。 | 委任済み (職場または学校のアカウント) | TeamSettings.ReadWrite.All、Group.ReadWrite.All**、 Directory.ReadWrite.All** | |
次の表に示すアクションでは、Microsoft Teams Graph クライアント資格情報の接続および資格情報エイリアスレコードが使用されます。これらのアクションには、アプリケーション権限が必要です。
| カテゴリ | アクション | 説明 | 必要な権限 (権限の低いものから順に) | |
|---|---|---|---|---|
| カレンダー管理 | 会議を作成 | MS Teams カレンダーのオンライン会議イベントを作成します。 | アプリケーション | Calendars.ReadWrite |
| 会議を削除 | MS Teams カレンダーから会議イベントを削除します。 | アプリケーション | Calendars.ReadWrite | |
| 会議を検索 | MS Teams カレンダーから会議イベントの詳細を取得します。 | アプリケーション | Calendars.Read | |
| 会議を検索 | MS Teams カレンダーから繰り返し子会議 ID を取得します。 | アプリケーション | Calendars.Read | |
| 会議ストリームを検索 | MS Teams カレンダーから会議イベントの詳細を取得します。 | アプリケーション | Calendars.Read, Calendars.ReadWrite | |
| 会議を更新 | MS Teams カレンダーのオンライン会議イベントを作成します。 | アプリケーション | Calendars.ReadWrite | |
| Webhook 管理 | Webhook サブスクリプションを検索 | 必要な Webhook サブスクリプションの詳細を取得します。 | アプリケーション | ChannelMessage.Read.All、Chat.Read.All |
| Webhook サブスクリプションストリームを検索 | すべての Webhook サブスクリプションの詳細を取得します。 | アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |
| Webhook サブスクリプションを更新 | 指定された Webhook サブスクリプションを更新します。 | アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |
| Webhook を登録 | 指定されたリソースの Webhook サブスクリプションを作成します。 | アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |
| Webhook を登録解除 | 指定された Webhook サブスクリプションを削除します。 | アプリケーション | ChannelMessage.Read.All、Chat.Read.All | |
重要:
これらのデフォルトのスポーク構成を把握しておいてください。
- 権限許可タイプは、デフォルトで [認証コード] に設定されます。
- [アプリケーション管理]、[チャネル管理]、[チャット管理]、[通知管理]、[チーム管理] カテゴリのすべてのアクション、および [カレンダー管理] カテゴリの [スケジュールを検索] アクションでは、Microsoft Teams スポーク接続および資格情報エイリアスを使用します。これらのアクションには委任された権限が必要です。
- カレンダーおよび Webhook 管理スポークアクション (カレンダー管理の [スケジュールをルックアップ] アクションを除く) では、 Microsoft Teams Graph クライアント認証情報 接続および認証情報エイリアスが使用され、これらのアクションにはアプリケーション権限が必要です。
ユーザーの操作なしで Microsoft Teams Graph スポークを使用する場合は、ユーザーが関与しなくても ServiceNow アプリケーションが Microsoft Teams Graph API にアクセスできるように、権限許可タイプを [クライアント認証情報] に変更する必要があります。権限許可タイプと必要な構成を変更する方法については、ServiceNow - NOW Support のナレッジベース記事「KB1635160」を参照してください。
必要な権限の詳細については、次を参照してください。 Microsoft Teams ドキュメント.
注:
一部のスポークアクションでは、入力の 1 つとしてチャネル ID、グループ ID、またはチーム ID が必要です。これらの詳細を確認するには、 Microsoft Teamsにログインし、[チーム] に移動して、必要なチャネルの [チャネルへのリンクを取得 (Get link to channel) ] をクリックします。チャネルリンクには、必要な詳細が含まれています。たとえば、チャネルリンクが https://teams.microsoft.com/l/channel/ 19%3a1aa3730712e245a0af31e4095d66d613%40thread.skype /New%2520channel%2520in%2520team? groupId= 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId= a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f、グループ ID およびチーム ID が 7fb91938-5e8c-4968-bf7d-3987df7716f3、チャネル ID が 19:1aa3730712e245a0af31e4095d66d613@thread.skype または 1aa3730712e245a0af31e4095d66d613 などです。
Microsoft Teams を介してチャネル ID とグループ ID にアクセスする方法の詳細については、以下を参照してください。 Microsoft Teams ドキュメント.
利用可能な AI エージェント
Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。
このスポークは、人間のような知能を模倣して ServiceNow インスタンスでタスクを実行するスタンドアロンの AI エージェントを提供します。
- ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。
他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。
- 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンの作成の詳細については、 Duplicate an AI agent を参照してください。
- AI エージェントの詳細については、 Now Assist AI agents を参照してください。
利用可能な AI エージェントは次のとおりです。
| AI エージェント | 説明 |
|---|---|
| Microsoft Teams アプリケーション管理 AI エージェント | Microsoft Teamsおよび 統合ハブに関連するタスクを自動化します。アプリのインストールの検索やユーザー向けのアプリケーションのインストールなどのアクションを実行します。 |
| Microsoft Teams チャネル管理 AI エージェント | 統合ハブを介して Microsoft Teams チャネルを管理します。チャネルの作成、メンバーの管理、チャネル情報の取得などの機能を提供します。 |
| Microsoft Teams チャット管理 AI エージェント | チャットやメッセージの検索などの機能を提供することで、ServiceNow と Microsoft Teams の間のワークフローを自動化します。 |
| Microsoft Teams 通知管理 AI エージェント | メッセージ、更新、返信をMicrosoft Teamsチャネルに送信することで、ServiceNow とMicrosoft Teams間の通信を自動化します。エージェントは、「変更の詳細の投稿」、「メッセージの投稿」、「メッセージに返信を投稿」などのアクションをサポートして、変更要求の効果的な通知管理を保証します。 |
| Microsoft Teams チーム管理 AI エージェント | チームの作成と管理、メンバーの追加または削除、チーム関連情報の取得などのタスクを自動化します。組織内のチーム管理とコミュニケーションワークフローを強化します。 |
| Microsoft Teams カレンダー管理 AI エージェント | ServiceNowとMicrosoft Teamsの間のワークフローを自動化します。カレンダー管理機能を提供します。会議の詳細の削除や取得などのアクションを実行します。 |
AI エージェントをお探しですか?
- Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
- インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
注:
AI エージェントを実行しているユーザーに、AI エージェントに関連付けられたテーブル内のデータにアクセスしたり、データに対して操作を実行したりするために必要なロールと権限があることを確認します。
スポークモジュール
Microsoft Teams Graph スポーク は、Microsoft Teams Graph スポークを ServiceNow インスタンスに追加し、これらのモジュールを含みます。
| モジュール | 説明 |
|---|---|
| デルタトークン | 利用可能なデルタトークンのリストを表示します。 |
| Webhook レジストリ | 使用可能な Webhook レジストリのリストを表示します。 |
| Webhook 決定ポリシー | 決定ポリシーのリストを表示します。 |
| Webhook サブスクリプション | Webhook サブスクリプションの詳細を表示します。 |
Microsoftアカウント要件
Microsoft Teams Graph スポークで OAuth 2.0 トークンを生成するには、MicrosoftAzure ポータルを使用してアプリケーションを登録する必要があります。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
スポークの設定については、「 Microsoft Teams Graph スポークを設定。
MID サーバー の要件
Microsoft Teams Graph スポークのアクションは REST コールを使用しており、インスタンスでもMID サーバーでも実行できます。Microsoftエイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所およびMID サーバー選択属性を設定します。 詳細については「MID サーバー」を参照してください。
このスポークの MID サーバー を設定するには、「 スポークの MID サーバー の設定」を参照してください。