Acciones universales para extensiones de mensajes basadas en búsqueda

Las tarjetas adaptables de las extensiones de mensaje basadas en búsqueda ahora admiten Acciones universales. Para habilitar Acciones universales para extensiones de mensaje basadas en búsqueda, la aplicación debe cumplir el esquema de Acciones universales para tarjetas adaptables junto con los siguientes requisitos:

1. La aplicación debe tener un bot de conversación definido en el manifiesto de la aplicación.
2. Si ya tiene un bot conversacional, debe usar el mismo bot que se usa en la extensión de mensaje.
3. Si la tarjeta se envía en un grupo, la aplicación debe especificar team o groupchat el ámbito de su bot en el manifiesto.

Ejemplo de un esquema JSON con team valores y 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
        }
    ]
}

Actualización automática de tarjetas adaptables en extensiones de mensaje basadas en búsqueda

Habilite la actualización automática para tarjetas adaptables en extensiones de mensaje basadas en búsquedas para asegurarse de que los usuarios siempre ven la información más reciente. Para habilitarlo, defina userIds la matriz en o 8:orgid:<AAD ID> en 29:<ID> formato en la refresh propiedad . Para obtener más información, vea Trabajar con acciones universales para tarjetas adaptables.

Ejemplo de userIds matriz en la refresh propiedad :

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

Ejemplo de Action.Execute en la refresh propiedad :

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

Instalación Just-In-Time

Just-In-Time (JIT) le permite instalar una extensión de tarjeta o mensaje para varios usuarios en un chat de grupo o canal. Para admitir acciones universales en extensiones de mensaje basadas en búsquedas, el bot se agrega a la conversación donde el usuario envía la tarjeta (con Action.Execute).

Cuando un usuario selecciona una tarjeta y la envía en un chat de grupo o canal, aparece un mensaje de instalación JIT . Una vez que el usuario selecciona la opción de envío , la aplicación se agrega a todos los usuarios en el chat o canal en segundo plano.

Ejemplo de un flujo de usuario de instalación dinámica de ME y JIT:

Vea también

• Extensiones de mensajes
• Tarjetas adaptables
• Acciones universales para tarjetas adaptables