メッセージを作成して送信する

アクション可能なメッセージを作成して送信するには、受信 Webhook または Microsoft 365 コネクタを使用します。 ただし、アクション可能なメッセージには、Exchange Online ライセンスを持つユーザーのみがアクセスできます。

操作可能なメッセージを作成する

アクション可能なメッセージには、カードに表示される 6 つのボタンが含まれています。 各ボタンは、入力の種類、テキスト フィールド、日付ピッカー、または複数選択リストを持つActionCardアクションを使用して、メッセージの potentialAction プロパティで定義されます。 各 ActionCard には、 HttpPOSTなどのアクションが関連付けられます。

コネクタ カードは、次のアクションがサポートされています。

• ActionCard: 1 つ以上の入力の種類と関連するアクションを表示します。
• HttpPOST: POST 要求を URL に送信します。
• OpenUri: 別のブラウザーまたはアプリで URI を開きます。 必要に応じて、オペレーティング システムに基づいて異なる URI をターゲットにします。

ActionCard アクションでは、次の 3 つの入力の種類がサポートされています。

• TextInput: 1 行または複数行のテキスト フィールド (オプションの長さの制限あり)。
• DateInput: オプションの時刻セレクターを持つ日付セレクター。
• MultichoiceInput: 1 つまたは複数の選択を提供する選択肢の列挙リスト。

MultichoiceInput では、最初にすべて展開した状態でリストを表示するかどうかを制御する style プロパティがサポートされています。 styleの既定値は、次のようにisMultiSelectの値によって異なります。

コンパクト スタイルで複数選択リストを表示するには、 "isMultiSelect": true と "style": trueを指定する必要があります。

コネクタ カードのアクションの詳細については、「 Actions」を参照してください。

Microsoft 365 グループの受信 Webhook またはコネクタを介してメッセージを送信する

Microsoft 365 グループの受信 Webhook またはコネクタを介してメッセージを送信するには、WEBhook URL に JSON ペイロードを投稿します。 このペイロードは、 Microsoft 365 グループのコネクタ カードの形式である必要があります。

この JSON を使用して、テキスト入力、複数選択、日付と時刻の選択など、豊富な入力を含むカードを作成することもできます。 カードを生成して Webhook URL に投稿するコードは、ホストされている任意のサービスで実行できます。 これらのカードは、アクション可能なメッセージの一部として定義され、Teams ボットとメッセージ拡張機能で使用される カード でもサポートされます。

コネクタ メッセージの例

コネクタ メッセージの例を次に示します。

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "themeColor": "0076D7",
    "summary": "Larry Bryant created a new task",
    "sections": [{
        "activityTitle": "Larry Bryant created a new task",
        "activitySubtitle": "On Project Tango",
        "activityImage": "https://adaptivecards.io/content/cats/3.png",
        "facts": [{
            "name": "Assigned to",
            "value": "Unassigned"
        }, {
            "name": "Due date",
            "value": "Mon May 01 2017 17:07:18 GMT-0700 (Pacific Daylight Time)"
        }, {
            "name": "Status",
            "value": "Not started"
        }],
        "markdown": true
    }],
    "potentialAction": [{
        "@type": "ActionCard",
        "name": "Add a comment",
        "inputs": [{
            "@type": "TextInput",
            "id": "comment",
            "isMultiline": false,
            "title": "Add a comment here for this task"
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Add comment",
            "target": "https://video2.skills-academy.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "ActionCard",
        "name": "Set due date",
        "inputs": [{
            "@type": "DateInput",
            "id": "dueDate",
            "title": "Enter a due date for this task"
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Save",
            "target": "https://video2.skills-academy.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "OpenUri",
        "name": "Learn More",
        "targets": [{
            "os": "default",
            "uri": "https://video2.skills-academy.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "ActionCard",
        "name": "Change status",
        "inputs": [{
            "@type": "MultichoiceInput",
            "id": "list",
            "title": "Select a status",
            "isMultiSelect": "false",
            "choices": [{
                "display": "In Progress",
                "value": "1"
            }, {
                "display": "Active",
                "value": "2"
            }, {
                "display": "Closed",
                "value": "3"
            }]
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Save",
            "target": "https://video2.skills-academy.com/outlook/actionable-messages"
        }]
    }]
}

次の図は、チャネル内のコネクタ メッセージ カードの例です。

cURL と PowerShell を使用してメッセージを送信する

受信 Webhook を使用してアダプティブ カードを送信する

受信 Webhook を介してテキストまたは Base64 でエンコードされたイメージを使用してアダプティブ カードを送信するには、次の手順に従います。

1. Teams でカスタム Webhook を設定します。
2. 次のコードを使用してアダプティブ カード JSON ファイルを作成します。

    {
       "type":"message",
       "attachments":[
          {
             "contentType":"application/vnd.microsoft.card.adaptive",
             "contentUrl":null,
             "content":{
                "$schema":"http://adaptivecards.io/schemas/adaptive-card.json",
                "type":"AdaptiveCard",
                "version":"1.2",
                "body":[
                    {
                    "type": "TextBlock",
                    "text": "For Samples and Templates, see [https://adaptivecards.io/samples](https://adaptivecards.io/samples)"
                    }
                ]
             }
          }
       ]
    }

    {
      "type": "message",
      "attachments": [
        {
          "contentType": "application/vnd.microsoft.card.adaptive",
          "content": {
            "type": "AdaptiveCard",
            "body": [
              {
                "type": "Image",
                "url": "data:image/jpeg;base64,/xxxxxxxx"
              }
            ],
            "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
            "version": "1.0"
          }
        }
      ]
    }

1. Postman でアダプティブ カードをテストする:

   1. Postmanを使用してアダプティブ カードをテストし、受信 Webhook を設定するために作成された URL に POST 要求を送信します。
   2. 要求の本文に JSON ファイルを貼り付け、アダプティブ カード メッセージを [アダプティブ カード] Teams。

コネクタのレート制限

アプリケーションレート制限は、コネクタまたは受信 Webhook がチャネルで生成することを許可されるトラフィックを制御します。 Teams は、固定レート ウィンドウと増分カウンターを使用して、秒単位で測定された要求を追跡します。 1 秒間に 4 つ以上の要求が行われた場合、クライアント接続は、ウィンドウが固定レートの間更新されるまで調整されます。

1 秒あたりのトランザクションのしきい値

次の表に、時間ベースのトランザクションの詳細を示します。

// Please note that response body needs to be extracted and read 
// as Connectors do not throw 429s
try
{
    // Perform Connector POST operation     
    var httpResponseMessage = await _client.PostAsync(IncomingWebhookUrl, new StringContent(content));
    // Read response content
    var responseContent = await httpResponseMessage.Content.ReadAsStringAsync();
    if (responseContent.Contains("Microsoft Teams endpoint returned HTTP error 429")) 
    {
        // initiate retry logic
    }
}

これらの制限は、コネクタによるチャネルのスパムを減らし、ユーザーに最適なエクスペリエンスを確保するために実施されます。

関連項目

• Webhook とコネクタ
• 受信 Webhook を作成する
• 送信 Webhook を作成する
• Teams ボットメッセージのレート制限
• アダプティブ カードを使用してタブをビルドする
• Microsoft Teams のカードの書式設定
• アダプティブ カード
• Teams のアプリ マニフェストのスキーマ