Microsoft Teams Graph スポーク用の双方向 Webhook の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • ServiceNow コールバック URL を使用して、Microsoft Teams を登録する Webhook を構成します。

    始める前に

    • 必要な統合ハブサブスクリプションの要求
    • Microsoft Teams Graph スポーク の有効化
    • 必要なロール：admin

    ServiceNow インスタンスでの Microsoft Teams Graph Webhook の登録

    Microsoft Teams で特定のイベントが発生したときに ServiceNow アプリに通知するために、Microsoft Teams を ServiceNow インスタンスに登録します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 Microsoft Teams Graph Spoke > Webhook レジストリー.
    2. [New] をクリックします。
    3. フォームのフィールドに入力します。
      名前 Webhook レジストリを識別する名前です。例：MS Teams Graph Webhook レジストリ。
      クライアントステータス クライアントステータス
      パス Microsoft Teams Graph Webhook パス。このフィールドは api/sn_msteams_ahv2/ms_teams_webhook に自動入力されます。
      説明 Webhook レジストリの説明です。
    4. フォームヘッダーを右クリックし、 [保存] をクリックします。
    5. [コールバック URL] をクリックします。
      Webhook コールバック URL が自動入力されます。

    チャネルの Webhook サブスクリプションの作成

    [Webhook を登録] サブフローをテストして、チーム内の必要なチャネルの Webhook サブスクリプションを作成します。

    始める前に

    必要なロール：admin

    手順

    1. [] に移動します。プロセス自動化 > ワークフロースタジオ.
    2. [サブフロー] をクリックします。
    3. [Webhook を登録] サブフローを開きます。
    4. [テスト] をクリックします。
    5. フォームに、次の値を入力します。
      フィールド 説明
      Webhook レジストリレコード名 ServiceNow インスタンスに Webhook を登録したときに指定した Webhook レコードの名前。例：MS Teams Graph Webhook レジストリ。
      変更タイプ 変更通知を送信する登録済みリソースの変更のタイプ。サポートされている値は、[作成済み]、[更新済み]、[削除済み] です。複数の値をカンマで区切って指定できます。
      チーム ID チームの一意の識別子。
      チャネル ID チャネルの一意の識別子。
      図 : 1. [Webhook を登録] サブフローをテストする
      必要な変更タイプの [ Webhook を登録 ] サブフローをテストします。
    6. [テストを実行] をクリックします。
      必要なチャネルのサブスクリプションが作成されます。

      サブフローのテストの詳細については、「サブフローのビルド」を参照してください。

    スポークサブフローのカスタマイズ

    スポークに付属する必要なサブフローのコピーを作成してカスタマイズします。

    始める前に

    必要なロール：admin

    手順

    1. [] に移動します。プロセス自動化 > ワークフロースタジオ.
    2. [サブフロー] をクリックします。
    3. Microsoft Teams Graph スポークに付属する必要なサブフローを開きます。
      たとえば、受信通知の処理のサブフローです。
    4. その他のアクションアイコン (その他のアクションメニュー) をクリックし、[サブフローのコピー] を選択します。
    5. [新しいフロー名] に、コピーしたサブフローに付ける一意の名前を入力します。
      たとえば、受信通知の処理のコピーのサブフローです。
    6. [コピー] をクリックします。
      サブフローのコピーが作成されます。
    7. 要件に応じてサブフローをカスタマイズし、公開します。
      サブフローの作成と使用の詳細については、「サブフローのビルド」を参照してください。

    Microsoft Teams Graph Webhook 決定ポリシーの構成

    要件に従って、Webhook ルーティングポリシーとサブフローを作成します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 Microsoft Teams Graph Spoke > Webhook 決定ポリシー
    2. [New] をクリックします。
    3. フォームのフィールドに入力します。
      表 : 1. 意思決定フォーム
      フィールド 説明
      ラベル ルーティングポリシーを識別する一意のラベルです。
      回答

      条件が満たされるとトリガーされるサブフローです。

      1. [ルックアップ] アイコンをクリックします。
      2. ドキュメントリストから必要なサブフローを選択します。たとえば、受信通知の処理のコピーなどです。
      デフォルトの回答 この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。
      条件 受信 Webhook が Microsoft Teams からデータを配信するときに満たすべき条件です。
    4. [送信] をクリックします。
      注:
      これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。