メッセージ拡張機能を使用した操作の開始

[アーティクル]
06/24/2024

重要

このセクションの記事は、v3 Bot Framework SDK に基づいています。現在のドキュメント (バージョン 4.6 以降のバージョンの SDK) をお探しの場合は、「メッセージ拡張機能とのタスク指向の対話」セクションを参照してください。

アクションベースのメッセージ拡張機能を使用すると、ユーザーは Teams にいる間に外部サービスでアクションをトリガーできます。

スクリーンショットは、メッセージ拡張カードを示す例です。

アプリにメッセージ拡張機能を追加する

メッセージ拡張機能は、ユーザーの要求をリッスンし、カードなどの構造化データで応答するクラウドホスト型サービスです。 Bot Framework Activity オブジェクトを使用して、サービスをMicrosoft Teamsと統合します。 Bot Builder SDK の .NET および Node.js 拡張機能は、アプリにメッセージ拡張機能機能を追加するのに役立ちます。

Teams のアクションベースのメッセージ拡張機能を示すスクリーンショット。

Bot Framework に登録する

まず、Microsoft Bot Framework にボットを登録する必要があります。ボットの Microsoft アプリ ID とコールバックエンドポイントは、そこで定義されているように、メッセージ拡張機能でユーザーの要求を受信して応答するために使用されます。ボットのMicrosoft Teams チャネルを有効にすることを忘れないでください。

ボットアプリ ID とアプリパスワードを書き留めます。アプリマニフェストでアプリ ID を指定する必要があります。

アプリマニフェストを更新する

ボットとタブと同様に、アプリのマニフェストを更新してメッセージ拡張機能のプロパティを含めます。これらのプロパティは、Microsoft Teams クライアントでのメッセージ拡張機能の表示方法と動作を制御します。メッセージ拡張機能は、マニフェスト v1.0 以降でサポートされています。

メッセージ拡張機能を宣言する

メッセージ拡張機能を追加するには、 composeExtensions プロパティを使用して、マニフェストに新しい最上位の JSON 構造体を含めます。アプリの 1 つのメッセージ拡張機能を作成することに制限されています。

注:

マニフェストは、メッセージ拡張機能を composeExtensionsとして参照します。これは、下位互換性を維持するためです。

拡張定義は、次の構造を持つオブジェクトです。

プロパティ名	用途	必須
`botId`	Bot Framework に登録された、ボット用の一意の Microsoft アプリ ID。これは通常、Teams アプリ全体の ID と同じである必要があります。	はい
`scopes`	この拡張機能を `personal` スコープまたは `team` スコープ (またはその両方) に追加できるかどうかを宣言する配列。	はい
`canUpdateConfiguration`	[設定] メニュー項目を有効にします。	いいえ
`commands`	このメッセージ拡張機能がサポートするコマンドの配列。コマンドは 10 個に制限されています。	はい

注:

canUpdateConfiguration プロパティをアプリマニフェストでtrueに設定した場合は、メッセージ拡張機能の [設定] メニュー項目を表示できます。設定を有効にするには、onQuerySettingsUrlとonSettingsUpdateも処理する必要があります。

コマンドを定義する

メッセージ拡張機能で 1 つのコマンドを宣言する必要があります。このコマンドは、ユーザーが作成ボックスの [ その他のオプション (⋯)] ボタンからアプリを選択したときに表示されます。

スクリーンショットは、Teams のメッセージ拡張機能の一覧を示す例です。

アプリマニフェストでは、コマンド項目は次の構造を持つオブジェクトです。

プロパティ名	用途	必須	マニフェストの最小バージョン
`id`	このコマンドに割り当てる一意の ID。ユーザー要求には、この ID が含まれています。	はい	1.0
`title`	コマンド名。この値は UI に表示されます。	はい	1.0
`description`	このコマンドの動作を示すヘルプテキスト。この値は UI に表示されます。	はい	1.0
`type`	コマンドの種類を設定します。使用可能な値は、`query`、`action` です。存在しない場合、既定値は `query` に設定されます。	いいえ	1.4
`initialRun`	省略可能なパラメーター。 `query` コマンドで使用されます。 true に設定されている場合は、ユーザーが UI でこのコマンドを選択するとすぐに、このコマンドを実行する必要があることを示します。	いいえ	1.0
`fetchTask`	省略可能なパラメーター。 `action` コマンドで使用されます。タスクモジュール内に表示するアダプティブカードまたは Web URL をフェッチするには、true に設定します。これは、パラメーターの静的セットではなく、 `action` コマンドへの入力が動的な場合に使用されます。 true に設定すると、コマンドの静的パラメーターリストは無視されることに注意してください。	いいえ	1.4
`parameters`	コマンドのパラメーターの静的リスト。	はい	1.0
`parameter.name`	パラメーターの名前です。これは、ユーザー要求でサービスに送信されます。	はい	1.0
`parameter.description`	このパラメーターの目的と、指定する必要がある値の例について説明します。この値は UI に表示されます。	はい	1.0
`parameter.title`	短い使いやすいパラメーターのタイトルまたはラベル。	はい	1.0
`parameter.inputType`	必要な入力の種類に設定します。使用できる値には、 `text`、 `textarea`、 `number`、 `date`、 `time`、 `toggle`などがあります。既定値は `text` に設定されます。	いいえ	1.4
`context`	メッセージアクションが使用できるコンテキストを定義する値の省略可能な配列。使用可能な値は、 `message`、 `compose`、または `commandBox`です。既定値は `["compose", "commandBox"]` です。	いいえ	1.5

アクションの種類のメッセージ拡張機能

メッセージ拡張機能からアクションを開始するには、 type パラメーターを action に設定します。 1 つのメッセージ拡張機能には最大 10 個の異なるコマンドがあり、複数の検索ベースおよびアクションベースのコマンドを含めることができます。

完全なアプリマニフェストの例

次のコードは、検索と create コマンドを使用したマニフェストの例です。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.8/MicrosoftTeams.schema.json",
  "manifestVersion": "1.5",
  "version": "1.0",
  "id": "57a3c29f-1fc5-4d97-a142-35bb662b7b23",
  "developer": {
    "name": "John Developer",
    "websiteUrl": "http://todobotservice.azurewebsites.net/",
    "privacyUrl": "http://todobotservice.azurewebsites.net/privacy",
    "termsOfUseUrl": "http://todobotservice.azurewebsites.net/termsofuse"
  },
  "name": {
    "short": "To Do",
    "full": "To Do"
  },
  "description": {
    "short": "Find or create a new task in To Do",
    "full": "Find or create a new task in To Do"
  },
  "icons": {
    "outline": "todo-outline.jpg",
    "color": "todo-color.jpg"
  },
  "accentColor": "#ff6a00",
  "composeExtensions": [
    {
      "botId": "57a3c29f-1fc5-4d97-a142-35bb662b7b23",
      "canUpdateConfiguration": true,
      "commands": [
        {
          "id": "searchCmd",
          "description": "Search you Todo's",
          "title": "Search",
          "initialRun": true,
          "context": ["commandBox", "compose"],
          "parameters": [
            {
              "name": "searchKeyword",
              "description": "Enter your search keywords",
              "title": "Keywords"
            }
          ]
        },
        {
          "id": "addTodo",
          "description": "Create a To Do item",
          "title": "Create To Do",
          "type": "action",
          "context": ["commandBox", "message", "compose"],
          "parameters": [
            {
              "name": "Name",
              "description": "To Do Title",
              "title": "Title",
              "inputType": "text"
            },
            {
              "name": "Description",
              "description": "Description of the task",
              "title": "Description",
              "inputType": "textarea"
            },
            {
              "name": "Date",
              "description": "Due date for the task",
              "title": "Date",
              "inputType": "date"
            }
          ]
        },
        {
          "id": "reassignTodo",
          "description": "Reassign a todo item",
          "title": "Reassign a todo item",
          "type": "action",
          "fetchTask": false,
          "parameters": [
            {
              "name": "Name",
              "title": "Title"
              "inputType": "text"
            }
          ]
        }
      ]
    }
  ],
  "permissions": [
    "identity",
    "messageTeamMembers"
  ],
  "validDomains": [
    "todobotservice.azurewebsites.net",
    "*.todobotservice.azurewebsites.net"
  ]
}

メッセージからアクションを開始する

メッセージの作成領域と、メッセージ拡張機能を使用してメッセージからアクションを開始できます。これにより、メッセージの内容をボットに送信して処理できます。必要に応じて、「送信への応答」で説明されているメソッドを使用して、そのメッセージに応答できます。応答は、ユーザーが送信する前に編集できるメッセージへの返信として含まれます。

ユーザーは、次の図に示すように、オーバーフロー ... メニューの [アクションの実行] オプションからメッセージ拡張機能にアクセスできます。

スクリーンショットは、メッセージからアクションを開始する方法を示しています。

メッセージ拡張機能をメッセージから機能させるには、次の例に示すように、 context パラメーターをアプリマニフェストのメッセージ拡張機能の commands オブジェクトに追加します。 context配列の有効な文字列は、"message"、"commandBox"、および"compose"です。既定値は ["compose", "commandBox"] です。 context パラメーターの詳細については、「コマンドの定義」セクションを参照してください。

"composeExtensions": [
  {
    "botId": "57a3c29f-1fc5-4d97-a142-35bb662b7b23",
    "canUpdateConfiguration": true,
    "commands": [
      {
        "id": "reassignTodo",
        "description": "Reassign a todo item",
        "title": "Create To Do",
        "type": "Action",
        "context": ["message"],
        "fetchTask": true
    }]
    ...

次のコードは、composeExtensions要求の一部としてボットに送信されるメッセージの詳細を含む value オブジェクトの例です。

{
  "name": "composeExtension/submitAction",
  "type": "invoke",
...
  "value": {
    "commandId": "setReminder",
    "commandContext": "message",
    "messagePayload": {
      "id": "1111111111",
      "replyToId": null,
      "createdDateTime": "2019-02-25T21:29:36.065Z",
      "lastModifiedDateTime": null,
      "deleted": false,
      "subject": "Message subject",
      "summary": null,
      "importance": "normal",
      "locale": "en-us",
      "body": {
        "contentType": "html",
        "content": "this is the message"
    },
      "from": {
        "device": null,
        "conversation": null,
        "user": {
          "userIdentityType": "aadUser",
          "id": "wxyz12ab8-ab12-cd34-ef56-098abc123876",
          "displayName": "Jamie Smythe"
        },
        "application": null
      },
      "reactions": [
        {
          "reactionType": "like",
          "createdDateTime": "2019-02-25T22:40:40.806Z",
          "user": {
            "device": null,
            "conversation": null,
            "user": {
              "userIdentityType": "aadUser",
              "id": "qrst12346-ab12-cd34-ef56-098abc123876",
              "displayName": "Jim Brown"
            },
            "application": null
          }
        }
      ],
      "mentions": [
        {
          "id": 0,
          "mentionText": "Sarah",
          "mentioned": {
            "device": null,
            "conversation": null,
            "user": {
              "userIdentityType": "aadUser",
              "id": "ab12345678-ab12-cd34-ef56-098abc123876",
              "displayName": "Sarah"
            },
            "application": null
          }
        }
      ]
    }
  ...

アップロードによるテスト

アプリをアップロードすることで、メッセージ拡張機能をテストできます。詳細については、「チームでのアプリのアップロード」を参照してください。

メッセージ拡張機能を開くには、チャットまたはチャネルのいずれかに移動します。作成ボックスの [ その他のオプション (⋯)] ボタンを選択し、メッセージ拡張機能を選択します。

ユーザーからの入力の収集

Teams でユーザーから情報を収集するには、3 つの方法があります。

静的パラメーターリスト

このメソッドでは、"Create To Do" コマンドに示すように、マニフェストでパラメーターの静的リストを定義するだけです。このメソッドを使用するには、 fetchTask が false に設定されていること、およびマニフェストでパラメーターを定義していることを確認します。

ユーザーが静的パラメーターを持つコマンドを選択すると、Teams はマニフェストで定義されたパラメーターを持つフォームをタスクモジュールに生成します。 [送信] をクリックすると、 composeExtensions/submitAction がボットに送信されます。予想される一連の応答の詳細については、「送信への応答」を参照してください。

アダプティブカードを使用した動的入力

この方法では、サービスでカスタムアダプティブカードを定義してユーザー入力を収集できます。この方法では、マニフェストで fetchTask パラメーターを true に設定します。 fetchTaskを true に設定した場合、コマンドに対して定義されているすべての静的パラメーターは無視されます。

この方法では、サービスは composeExtensions/fetchTask イベントを受信し、アダプティブカードベースのタスクモジュール応答で応答します。アダプティブカードでの応答例を次に示します。

{
    "task": {
        "type": "continue",
        "value": {
            "card": {
                "contentType": "application/vnd.microsoft.card.adaptive",
                "content": {
                    "body": [
                        {
                            "type": "TextBlock",
                            "text": "Please enter the following information:"
                        },
                        {
                            "type": "TextBlock",
                            "text": "Name"
                        },
                        {
                            "type": "Input.Text",
                            "spacing": "None",
                            "title": "New Input.Toggle",
                            "placeholder": "Placeholder text"
                        },
                        {
                            "type": "TextBlock",
                            "text": "Date of birth"
                        },
                        {
                            "type": "Input.Date",
                            "spacing": "None",
                            "title": "New Input.Toggle"
                        }
                    ],
                    "type": "AdaptiveCard",
                    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
                    "version": "1.0"
                }
            }
        }
    }
}

また、ユーザーがユーザー入力を取得する前に拡張機能を認証または構成する必要がある場合は、ボットは認証/構成応答で応答することもできます。

Web ビューを使用した動的入力

このメソッドでは、サービスで <iframe> ベースのウィジェットを表示して、任意のカスタム UI を表示し、ユーザー入力を収集できます。この方法では、マニフェストで fetchTask パラメーターを true に設定します。

アダプティブカードフローと同様に、サービスは fetchTask イベントを送信し、URL ベースのタスクモジュール応答で応答します。アダプティブカードを使用した応答の例を次に示します。

{
    "task": {
        "value": {
            "url": "http://mywebapp.com/input"
        },
        "type": "continue"
    }
}

会話型ボットのインストールを要求する

アプリに会話ボットが含まれている場合は、タスクモジュールを読み込む前に会話にインストールされていることを確認して、タスクモジュールのコンテキストを増やします。たとえば、ユーザー選択コントロールやチーム内のチャネルの一覧を設定するには、名簿をフェッチする必要がある場合があります。

このフローを容易にするために、メッセージ拡張機能が最初に composeExtensions/fetchTask 呼び出しを受け取ったときに、ボットが現在のコンテキストにインストールされているかどうかを確認します。これを取得するには、名簿の取得呼び出しを試みます。たとえば、ボットがインストールされていない場合は、ユーザーにボットのインストールを要求するアクションを含むアダプティブカードを返します。ユーザーは、その場所にアプリをインストールするためのアクセス許可を持っている必要があります。インストールできない場合は、管理者に問い合わせるメッセージが表示されます。

応答の例を次に示します。

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "text": "Looks like you haven't used Disco in this team/chat"
    }
  ],
  "actions": [
    {
      "type": "Action.Submit",
      "title": "Continue",
      "data": {
        "msteams": {
          "justInTimeInstall": true
        }
      }
    }
  ],
  "version": "1.0"
}

ユーザーがインストールを完了すると、ボットは、 name = composeExtensions/submitAction と value.data.msteams.justInTimeInstall = trueを含む別の呼び出しメッセージを受信します。

呼び出しの例を次に示します。

{
  "value": {
    "commandId": "giveKudos",
    "commandContext": "compose",
    "context": {
      "theme": "default"
    },
    "data": {
      "msteams": {
        "justInTimeInstall": true
      }
    }
  },
  "conversation": {
    "id": "19:7705841b240044b297123ad7f9c99217@thread.skype"
  },
  "name": "composeExtension/submitAction",
  "imdisplayname": "Bob Smith"
}

ボットがインストールされている場合は、応答したのと同じタスク応答で呼び出しに応答します。

送信への応答

ユーザーが入力を完了すると、ボットはコマンド ID とパラメーター値が設定された composeExtensions/submitAction イベントを受け取ります。

これらは、 submitActionに対するさまざまな予期される応答です。

タスクモジュールの応答

タスクモジュールの応答は、拡張機能がダイアログを連結して詳細情報を取得する必要がある場合に使用されます。応答は、前に説明した fetchTask と同じです。

拡張機能の認証/構成応答を作成する

Compose extensions auth/config response は、拡張機能が続行するために認証または構成する必要がある場合に使用されます。詳細については、検索セクションの認証に関するセクションを参照してください。

拡張機能の結果応答を作成する

Compose 拡張機能の結果応答は、コマンドの結果としてカードを compose ボックスに挿入するために使用されます。これは、検索コマンドで使用されるのと同じ応答ですが、配列内の 1 つのカードまたは 1 つの結果に制限されます。

{
  "composeExtension": {
    "type": "result",
    "attachmentLayout": "list",
    "preview": {
          "contentType": "application/vnd.microsoft.card.thumbnail",
          "content": {
            "title": "85069: Create a cool app",
            "images": [
              {
                "url": "https://placekitten.com/200/200"
              }
            ]
          }
        },
    "attachments": [
      {  
        "contentType": "application/vnd.microsoft.teams.card.o365connector",
        "content": {
          "sections": [
            {
              "activityTitle": "[85069]: Create a cool app",
              "activityImage": "https://placekitten.com/200/200"
            },
            {
              "title": "Details",
              "facts": [
                {
                  "name": "Assigned to:",
                  "value": "[Larry Brown](mailto:larryb@example.com)"
                },
                {
                  "name": "State:",
                  "value": "Active"
                }
              ]
            }
          ]
        }
      }
    ]
  }
}

ボットから送信されたアダプティブカードメッセージで応答する

アダプティブカードを含むメッセージをボットを使用してチャネルに挿入して、送信アクションに応答します。ユーザーはメッセージを送信する前にプレビューでき、メッセージを編集または操作することもできます。これは、アダプティブカード応答を作成する前にユーザーから情報を収集する必要があるシナリオで役立ちます。次のシナリオは、チャネルメッセージに構成手順を含めずに、このフローを使用してポーリングを構成する方法を示しています。

ユーザーがメッセージ拡張機能を選択してタスクモジュールをトリガーします。
ユーザーは、タスクモジュールを使用してポーリングを構成します。
構成タスクモジュールを送信すると、アプリはタスクモジュールで提供された情報を使用してアダプティブカードを作成し、クライアントに botMessagePreview 応答として送信します。
その後、ユーザーは、ボットがチャネルに挿入する前に、アダプティブカードメッセージをプレビューできます。ボットがまだチャネルのメンバーでない場合は、[ Send ] をクリックするとボットが追加されます。
アダプティブカードを操作すると、送信前にメッセージが変更されます。
ユーザーが Sendを選択すると、ボットはチャネルにメッセージを投稿します。

注:

activityPreview には、1 つのアダプティブカード添付ファイルを含む message アクティビティが含まれている必要があります。
Outlook では、ボットから送信されたアダプティブカードメッセージでの応答はサポートされていません。

このフローを有効にするには、次の例のようにタスクモジュールが応答し、プレビューメッセージがユーザーに表示されます。

{
  "composeExtension": {
    "type": "botMessagePreview",
    "activityPreview": {
      "type": "message",
      "attachments":  [
        {
          "contentType": "application/vnd.microsoft.card.adaptive",
          "content": << Card Payload >>
        }
      ]
    }
  }
}

メッセージ拡張機能は、 value.botMessagePreviewAction = "send" と value.botMessagePreviewAction = "edit"という 2 種類の新しい対話に対応する必要があります。次のコードは、処理する必要がある value オブジェクトの例です。

{
  "name": "composeExtension/submitAction",
  "type": "invoke",
  "conversation": { "id": "19:c366b75791784100b6e8b515fd55b063@thread.skype" },
  "imdisplayname": "Pranav Smith",
  ...
  "value": {
    "botMessagePreviewAction": "send" | "edit",
    "botActivityPreview": [
      {
        "type": "message/card",
        "attachments": [
          {
            "content":
              {
                "type": "AdaptiveCard",
                "body": [{<<card payload>>}]
              },
            "contentType" : "application/vnd.microsoft.card.adaptive"
          }
        ],
        "context": { "theme": "default" }
      }
    ],
  }
}

edit要求に応答するときは、ユーザーが送信した情報が入力された値を含むtask応答で応答する必要があります。 send要求に応答するときは、確定されたアダプティブカードを含むチャネルにメッセージを送信する必要があります。

TypeScript/Node.js
C#/.NET

サンプルコードリファレンス

teamChatConnector.onComposeExtensionSubmitAction((
    event: builder.IEvent,
    request: teamBuilder.IComposeExtensionActionCommandRequest,
    callback: (err: Error, result: any, statusCode: number) => void) => {
        let invokeValue = (<any> event).value;

        if (invokeValue.botMessagePreviewAction ) {
            let attachment = invokeValue.botActivityPreview[0].attachments[0];

            if (invokeValue.botMessagePreviewAction === 'send') {
                let msg = new builder.Message()
                    .address(event.address)
                    .addAttachment(attachment);
                teamChatConnector.send([msg.toMessage()],
                    (error) => {
                        if(error){
                            // TODO: Handle error and callback.
                        }
                        else {
                            callback(null, null, 200);
                        }
                    }
                );
            }

            else if (invokeValue.botMessagePreviewAction === 'edit') {
              // Create the card and populate with user-inputted information.
              let card = { ... }

              let taskResponse = {
                task: {
                  type: "continue",
                  value: {
                    title: "Card Preview",
                    card: {
                      contentType: 'application/vnd.microsoft.card.adaptive',
                      content: card
                    }
                  }
                }
              }
              callback(null, taskResponse, 200);
            }

        else {
            let attachment = {
                  // Create Adaptive Card.
                };
            let activity = new builder.Message().addAttachment(attachment).toMessage();
            let response = teamBuilder.ComposeExtensionResponse.messagePreview()
                .preview(activity)
                .toResponse();
            callback(null, response, 200);
        }
    });

このサンプルでは、 Microsoft.Bot.Connector.Teams SDK (v3) を使用してこのフローを示します。

public class MessagesController : ApiController
{

    [BotAuthentication]
    public async Task<HttpResponseMessage> Post([FromBody]Activity activity)
    {
        MicrosoftAppCredentials.TrustServiceUrl(activity.ServiceUrl, DateTime.MaxValue);
        ConnectorClient connectorClient = new ConnectorClient(
            new Uri(activity.ServiceUrl),
            ConfigurationManager.AppSettings[MicrosoftAppCredentials.MicrosoftAppIdKey],
            ConfigurationManager.AppSettings[MicrosoftAppCredentials.MicrosoftAppPasswordKey]);

        if (activity.Type == ActivityTypes.Invoke)
        {
            // Initial task module presented to the user.
            if (activity.Name == "composeExtension/fetchTask")
            {
                string task = GetTaskModule();

                return Request.CreateResponse(HttpStatusCode.OK, JObject.Parse(task));
            }
            else if (activity.Name == "composeExtension/submitAction")
            {
                dynamic activityValue = JObject.FromObject(activity.Value);
                string botMessagePreviewAction = activityValue["botMessagePreviewAction"];

                // This is the initial card response sent after the task module is submitted.
                if (botMessagePreviewAction is null)
                {
                    string text = activityValue.data.cardMessage;

                    AdaptiveCard card = new AdaptiveCard(new AdaptiveSchemaVersion("1.0"));
                    card.Body.Add(new AdaptiveTextBlock()
                    {
                        Text = "This card will be inserted into the conversation by the bot.",
                        Size = AdaptiveTextSize.Large,
                        Wrap = true
                    });
                    card.Body.Add(new AdaptiveTextBlock()
                    {
                        Text = "The text below is what you provided."
                    });
                    card.Body.Add(new AdaptiveTextBlock()
                    {
                        Text = text,
                    });

                    string cardJson = card.ToJson();

                    string cardMessage = $@"{{
                        'composeExtension': {{
                        'type': 'botMessagePreview',
                        'activityPreview': {{
                            'type': 'message',
                            'attachments': [{{
                                'contentType': 'application/vnd.microsoft.card.adaptive',
                                'content': {cardJson}
                            }}]
                        }}
                        }}
                    }}";

                    JObject res = JObject.Parse(cardMessage);
                    return Request.CreateResponse(HttpStatusCode.OK, res);

                }
                else
                {
                    // This is the "send the card to the channel" event.
                    if (botMessagePreviewAction.Equals("send"))
                    {
                        string cardJson = JsonConvert.SerializeObject(activityValue.botActivityPreview[0].attachments[0].content);

                        AdaptiveCardParseResult cardResult = AdaptiveCard.FromJson(cardJson);
                        AdaptiveCard card = cardResult.Card;
                        Attachment cardAttachment = new Attachment
                        {
                            ContentType = AdaptiveCard.ContentType,
                            Content = card
                        };


                        Activity response = activity.CreateReply();
                        response.Attachments.Add(cardAttachment);

                        var result = await connectorClient.Conversations.SendToConversationAsync(response);
                    }
                    // This is fired if the user edits the card before sending it.
                    else if (botMessagePreviewAction.Equals("edit"))
                    {
                        string task = GetTaskModule();

                        return Request.CreateResponse(HttpStatusCode.OK, JObject.Parse(task));
                    }
                    else
                    {
                        return Request.CreateResponse(HttpStatusCode.NotImplemented);
                    }
                }
            }
        }

        return Request.CreateResponse(HttpStatusCode.NotImplemented);

    }

    private static string GetTaskModule()
    {
        AdaptiveCard card = new AdaptiveCard(new AdaptiveSchemaVersion("1.0"));
        card.Body.Add(new AdaptiveTextBlock()
        {
            Text = "Please enter the following information:",
            Size = AdaptiveTextSize.Large
        });
        card.Body.Add(new AdaptiveTextBlock()
        {
            Text = "Card Message:"
        });
        card.Body.Add(new AdaptiveTextInput()
        {
            Id = "cardMessage",
            Spacing = AdaptiveSpacing.None,
            Placeholder = "Card message goes here."
        });
        card.Actions.Add(new AdaptiveSubmitAction()
        {
            Title = "Submit"
        });

        string cardJson = card.ToJson();

        // Create the task module response.
        string task = $@"{{
                            'task': {{
                                'type': 'continue',
                                'value': {{
                                    'card': {{
                                        'contentType': 'application/vnd.microsoft.card.adaptive',
                                        'content': {cardJson}
                                        }}
                                    }}
                                }}
                            }}";
        return task;
    }

}

次の方法で共有

メッセージ拡張機能を使用した操作の開始

アプリにメッセージ拡張機能を追加する

Bot Framework に登録する

アプリマニフェストを更新する

メッセージ拡張機能を宣言する

コマンドを定義する

アクションの種類のメッセージ拡張機能

完全なアプリマニフェストの例

メッセージからアクションを開始する

アップロードによるテスト

ユーザーからの入力の収集

静的パラメーターリスト

アダプティブカードを使用した動的入力

Web ビューを使用した動的入力

会話型ボットのインストールを要求する

送信への応答

タスクモジュールの応答

拡張機能の認証/構成応答を作成する

拡張機能の結果応答を作成する

ボットから送信されたアダプティブカードメッセージで応答する

関連項目

その他のリソース

次の方法で共有

メッセージ拡張機能を使用した操作の開始

アプリにメッセージ拡張機能を追加する

Bot Framework に登録する

アプリ マニフェストを更新する

メッセージ拡張機能を宣言する

コマンドを定義する

アクションの種類のメッセージ拡張機能

完全なアプリ マニフェストの例

メッセージからアクションを開始する

アップロードによるテスト

ユーザーからの入力の収集

静的パラメーター リスト

アダプティブ カードを使用した動的入力

Web ビューを使用した動的入力

会話型ボットのインストールを要求する

送信への応答

タスク モジュールの応答

拡張機能の認証/構成応答を作成する

拡張機能の結果応答を作成する

ボットから送信されたアダプティブ カード メッセージで応答する

関連項目

その他のリソース

アプリマニフェストを更新する

完全なアプリマニフェストの例

静的パラメーターリスト

アダプティブカードを使用した動的入力

タスクモジュールの応答

ボットから送信されたアダプティブカードメッセージで応答する