Ações Universais para extensões de mensagens baseadas em pesquisa

Os Cartões Ajustáveis em extensões de mensagens baseadas em pesquisa suportam agora Ações Universais. Para ativar as Ações Universais para extensões de mensagens baseadas em pesquisa, a aplicação tem de estar em conformidade com o esquema das Ações Universais para Cartões Ajustáveis , juntamente com os seguintes requisitos:

1. A aplicação tem de ter um bot de conversação definido no manifesto da aplicação.
2. Se já tiver um bot de conversação, tem de utilizar o mesmo bot que é utilizado na extensão da sua mensagem.
3. Se o cartão for enviado num grupo, a aplicação tem de especificar team ou groupchat definir o âmbito no bot no manifesto.

Exemplo de um esquema JSON com team e groupchat valores:

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

Atualização automática de Cartões Ajustáveis em extensões de mensagens baseadas em pesquisa

Ative a atualização automática de Cartões Ajustáveis em extensões de mensagens baseadas em pesquisa para garantir que os utilizadores veem sempre as informações mais recentes. Para ativar, defina userIds a matriz no 29:<ID> formato ou 8:orgid:<AAD ID> na refresh propriedade . Para obter mais informações, veja Trabalhar com Ações Universais para Cartões Ajustáveis.

Exemplo de userIds matriz na refresh propriedade :

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

Exemplo de Action.Execute na refresh propriedade:

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

Instalação just-in-time

O Just-in-time (JIT) permite-lhe instalar uma extensão de cartão ou mensagem para vários utilizadores num chat ou canal de grupo. Para suportar as Ações Universais em extensões de mensagens baseadas em pesquisa, o bot é adicionado à conversação em que o cartão (com Action.Execute) é enviado pelo utilizador.

Quando um utilizador seleciona um cartão e o envia num chat ou canal de grupo, é apresentado um pedido de instalação do JIT . Depois de o utilizador selecionar a opção de envio , a aplicação é adicionada a todos os utilizadores no chat ou canal em segundo plano.

Exemplo de um fluxo de utilizador de instalação me e JIT dinâmico:

Confira também

• Extensões de mensagens
• Cartões Adaptáveis
• Ações Universais para Cartões Adaptáveis