Microsoft Teams Graph Spoke

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む26読むのに数分
  • 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 Graph スポーク では、タスクの自動化をデモするためのサンプルサブフローが提供されます。サンプルフローをカスタマイズするには、必要なアプリケーションスコープにコピーします。利用可能なサンプルサブフローは次のとおりです。
    表 : 1. Microsoft Teams Graph スポーク サブフロー
    サブフロー 説明
    インシデントの詳細を投稿 必要なインシデントの詳細を Microsoft Teams チャネルに投稿します。
    受信通知の処理 Webhook サブスクリプションから受信した入力データに基づいて、指定されたメッセージの詳細を取得します。
    Webhook サブスクリプションヘルパーサブフローの更新 更新が必要な場合にサブスクリプションを更新します。これは入力に基づいて決定されます。
    Webhook サブスクリプションを更新 すべての Webhook サブスクリプションを取得し、更新が必要な場合は更新します。
    Webhook を登録 指定されたチームのチャネルの Webhook サブスクリプションを作成します。

    スポークのアクション

    Microsoft Teams Graph スポークでは、ServiceNowインスタンスでインシデントが作成されたときに、チームとチャネルのタスクを自動化するアクションが提供されます。
    表 : 2. Microsoft Teams Graph スポーク アクション
    カテゴリ アクション 説明 必要な権限 (権限の低いものから順に)
    アプリケーション管理 ユーザーにアプリケーションをインストール 指定されたアプリケーションをユーザーの個人スコープにインストールします。 委任済み (職場または学校のアカウント) 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 ドキュメント.

    注:
    一部のスポークアクションでは、入力の 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 TeamsID とグループ ID にアクセスする方法の詳細については、「」を参照してください。 Microsoft Teams ドキュメント.

    スポークモジュール

    Microsoft Teams Graph スポーク は、Microsoft Teams Graph スポークを ServiceNow インスタンスに追加し、これらのモジュールを含みます。
    表 : 3. Microsoft Teams Graph スポークモジュール
    モジュール 説明
    デルタトークン 利用可能なデルタトークンのリストを表示します。
    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」を参照してください。