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

  • [アーティクル]

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

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

と groupchat の値を持つ team 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
        }
    ]
}

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

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

プロパティ内の配列のuserIdsrefresh例:

    {
        "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 人を超えるユーザーとの会話 (グループ チャットまたはチャネル) の場合、ユーザーはメッセージ オプション メニューの [更新] ボタンを使用して最新の結果を取得できます。

プロパティ内の のAction.Executerefresh例:

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

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

注:

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

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

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

関連項目