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

Nota:

La actualización automática está habilitada para todos los usuarios del chat de grupo o canal con menos o igual que 60 usuarios. En el caso de las conversaciones (chat en grupo o canal) con más de 60 usuarios, los usuarios pueden usar el botón actualizar del menú de opciones de mensaje para obtener el resultado más reciente.

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.

Nota:

En el caso de las aplicaciones que no tienen Action.Execute y refresh el esquema definido, el símbolo del sistema de instalación no se muestra a los usuarios.

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