Универсальные действия для расширений сообщений на основе поиска

  • Статья

Адаптивные карточки в расширениях сообщений на основе поиска теперь поддерживают универсальные действия. Чтобы включить универсальные действия для расширений сообщений на основе поиска, приложение должно соответствовать схеме универсальных действий для адаптивных карточек , а также следующим требованиям:

  1. Приложение должно иметь бот беседы, определенный в манифесте приложения.
  2. Если у вас уже есть чат-бот, необходимо использовать тот же бот, который используется в расширении сообщений.
  3. Если карта отправляется в группе, приложение должно указать team или groupchat область бота в манифесте.

Пример схемы JSON со значениями team и groupchat :

{
    "$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
        }
    ]
}

Автоматическое обновление адаптивных карточек в расширениях сообщений на основе поиска

Включите автоматическое обновление адаптивных карточек в расширениях сообщений на основе поиска, чтобы пользователи всегда видели последние сведения. Чтобы включить этот параметр, определите userIds массив в 29:<ID> свойстве refresh или 8:orgid:<AAD ID> в формате . Дополнительные сведения см. в статье Работа с универсальными действиями для адаптивных карточек.

Пример массива userIds в свойстве refresh :

    {
        "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.Execute свойстве refresh :

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

JIT-установка

JIT позволяет установить расширение карта или сообщений для нескольких пользователей в групповом чате или канале. Для поддержки универсальных действий в расширениях для сообщений на основе поиска бот добавляется в беседу, в которой пользователь отправляет карта (с Action.Execute).

Когда пользователь выбирает карта и отправляет его в групповом чате или канале, появляется запрос на установку JIT. Когда пользователь выберет параметр отправки , приложение добавляется для всех пользователей в чате или канале в фоновом режиме.

Примечание.

Для приложений, в которых нет Action.Execute и refresh определена схема, запрос на установку не отображается пользователям.

Пример потока пользователя динамической установки ME и JIT:

GIF показывает пользовательский поток для динамического расширения сообщений и JIT-установки.

См. также