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

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. [新規] をクリックします。
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. [Test] をクリックします。
5. フォームに、次の値を入力します。

   フィールド	Description (説明)
   Webhook レジストリレコード名	ServiceNow インスタンスに Webhook を登録したときに指定した Webhook レコードの名前。例: MS Teams Graph Webhook レジストリ。
   変更タイプ	変更通知を送信する登録済みリソースの変更のタイプ。サポートされている値は、[ created]、[ updated]、および [deleted] です。複数の値をカンマで区切って指定できます。
   チーム ID	チームの一意の識別子。
   チャネル ID	チャネルの一意の識別子。

   図 : 1. 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. [新規] をクリックします。
3. フォームのフィールドに入力します。

   表 : 1. 意思決定フォーム

   フィールド	説明
   ラベル	ルーティングポリシーを識別する一意のラベルです。
   回答	条件が満たされたときにトリガーされるサブフロー。 [ルックアップ] アイコンをクリックします。 ドキュメントリストから必要なサブフローを選択します。たとえば、「 受信通知の処理のコピー」などです。
   デフォルトの回答	この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。
   条件	受信 Webhook が Microsoft Teams からデータを配信するときに満たすべき条件です。

4. [送信] をクリックします。
   注:

   これらのルーティングポリシーは意思決定テーブルに保存されます。ユーザーは、これらのテーブルのデータを直接更新または変更しないように注意してください。