次の方法で共有

検索ベースのメッセージ拡張機能のユニバーサル アクション

  • [アーティクル]

検索ベースのメッセージ拡張機能のアダプティブ カードでユニバーサル アクションがサポートされるようになりました。 検索ベースのメッセージ拡張機能に対してユニバーサル アクションを有効にするには、アプリが アダプティブ カードのユニバーサル アクションのスキーマ と次の要件に準拠している必要があります。

  1. アプリには、アプリ マニフェストで会話ボットが定義されている必要があります。
  2. 既に会話ボットがある場合は、メッセージ拡張機能で使用されているのと同じボットを使用する必要があります。
  3. カードがグループで送信される場合、アプリはマニフェストでボットの team または groupchat スコープを指定する必要があります。

team値とgroupchat値を持つ JSON スキーマの例:

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json",
    "manifestVersion": "1.11",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "scopes": [
                    "team",
                    "personal",
                    "groupchat"
                ]
        }
    ],
    "composeExtensions": [
        {
            "canUpdateConfiguration": true,
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%", // Use the same bot as what is specified in the bots section above
        }
    ]
}

検索ベースのメッセージ拡張機能でのアダプティブ カードの自動更新

検索ベースのメッセージ拡張機能でアダプティブ カードの自動更新を有効にして、ユーザーが常に最新の情報を確実に表示できるようにします。 有効にするには、refresh プロパティでuserIds配列を29:<ID>または8:orgid:<AAD ID>形式で定義します。 詳細については、「 アダプティブ カードのユニバーサル アクションの操作」を参照してください。

refresh プロパティuserIds配列の例:

    {
        "type": "AdaptiveCard",
        "refresh": {
            "userIds": [
                "8:orgid:<AADID>",
                "29:<id>"
            ],
            "action": {
                "type": "Action.Execute",
                "data": {}
            }
        },
        "body": [
            {
                "type": "TextBlock",
                "text": "Hello World!",
                "wrap": true
            }
        ],
        "actions": [
            {
                "type": "Action.Execute",
                "data": {},
                "title": "Hello"
            }
        ]
    }

注:

自動更新は、60 ユーザー以下のグループ チャットまたはチャネル内のすべてのユーザー に対して 有効になります。 60 人を超えるユーザーとの会話 (グループ チャットまたはチャネル) の場合、ユーザーはメッセージ オプション メニューの [更新] ボタンを使用して最新の結果を取得できます。

refresh プロパティのAction.Executeの例:

    {
        "type": "AdaptiveCard",
        "refresh": {
            "action": {
                "type": "Action.Execute",
                "data": {}
            }
        },
        "body": [
            {
                "type": "TextBlock",
                "text": "Hello World!",
                "wrap": true
            }
        ],
        "actions": [
            {
                "type": "Action.Execute",
                "data": {},
                "title": "Hello"
            }
        ]
    }

Just-In-Time インストール

Just-In-Time (JIT) を使用すると、グループ チャットまたはチャネルに複数のユーザーのカードまたはメッセージ拡張機能をインストールできます。 検索ベースのメッセージ拡張機能でユニバーサル アクションをサポートするために、( Action.Execute) カードがユーザーによって送信される会話にボットが追加されます。

ユーザーがカードを選択してグループ チャットまたはチャネルで送信すると、 JIT インストール プロンプトが表示されます。 ユーザーが 送信 オプションを選択すると、バックグラウンドでチャットまたはチャネル内のすべてのユーザーに対してアプリが追加されます。

注:

Action.Executeとrefreshスキーマが定義されていないアプリの場合、インストール プロンプトはユーザーに表示されません。

動的 ME および JIT インストール ユーザー フローの例:

GIF は、動的メッセージ拡張機能と JIT インストールのユーザー フローを示します。

関連項目