着信 Webhook URL を作成します

Microsoft Teams 通知を投稿するには、着信 Webhook URLを作成する必要があります。 着信 Webhook URLを作成するには、 ここに記載されている手順に従います。

Microsoft Teams 宛先の構成

「 Destinations 」タブで Microsoft Teams 宛先を構成できます。 構成の一部として、Microsoft チームの着信 Webhook URLを入力します。

Microsoft Teams サブスクリプションの構成

Microsoft Teams の宛先をトピックに関連付けるためのサブスクリプションを作成します。

Event Notifications からの Microsoft Teams 通知の外観

イベント通知は、着信ペイロードから Microsoft Teams 通知を生成します。 Microsoft Teams に送信するために使用されるテンプレート・イベント通知は、以下のようになります。

{
   "type": "message",
   "attachments": [
      {
         "contentType": "application/vnd.microsoft.card.adaptive",
         "content": {
            "type": "AdaptiveCard",
            "body": [
               {
                  "items": [
                     {
                        "size": "large",
                        "text": "{{event.ibmendefaultshort}}",
                        "type": "TextBlock"
                     }
                  ],
                  "type": "Container"
               },
               {
                  "text": "{{event.ibmendefaultlong}}",
                  "type": "TextBlock",
                  "weight": "Bolder",
                  "wrap": true
               },
               {
                  "actions": [
                     {
                        "targetElements": [
                           "stacktrace"
                        ],
                        "title": "Show Data",
                        "type": "Action.ToggleVisibility"
                     }
                  ],
                  "type": "ActionSet"
               },
               {
                  "id": "stacktrace",
                  "isVisible": false,
                  "items": [
                     {
                        "fontType": "monospace",
                        "isSubtle": true,
                        "size": "Small",
                        "text": "{{event.data}}",
                        "type": "TextBlock",
                        "weight": "Bolder",
                        "wrap": true
                     }
                  ],
                  "type": "Container"
               }
            ],
            "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
            "version": "1.4"
         }
      }
   ]
}

ここで-

ibmendefaultshort は、着信ペイロードで提供されるデフォルトの短いペイロードです。 ibmendefaultlong は、着信ペイロードで提供されるデフォルトの long ペイロードです。 data は、着信ペイロードで提供されるデータ JSON であり、Microsoft Teams 通知で JSON として形式設定されます。

Microsoft™ Teams 宛先構成のテスト

Microsoft™ Teams 宛先をテストするには、宛先にアゴリを提供するオプション・メニューを使用します。 提供された構成が正しいかどうかにかかわらず、シングルクリックで宛先を簡単にテストできます。

宛先のテストについて詳しくは、 ここ を参照してください。

Microsoft チームの再試行ポリシー

Microsoft Teams 通知を公開すると、ネットワーク・エラーやアプリケーションの欠陥などの問題が原因で要求が失敗する可能性があります。 再試行は、外部要求に対する回復力を提供するために使用されます。 このような状況では、以下の値を使用して要求を再試行してください。

• 制限 = 60 秒: サービスが再試行する合計時間。
• ステップ = 5 秒: 各障害の後、サービスは 5 秒待機してから再試行します。 この遅延により、外部サービス (Webhook) の爆撃を防ぐことができます。

さらに、以下のタイムアウト条件が原因で、Microsoft Teams 呼び出しが失敗します。

• 10 秒の接続タイムアウト
• 60 秒の応答タイムアウト

Microsoft Teams Webhook URL への呼び出しが再試行しても失敗した場合、通知は失われます。