Compartilhar via

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

  • Artigo

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

Observação

A atualização automática está ativada para todos os utilizadores no chat ou canal de grupo com menos ou igual a 60 utilizadores. Para conversações (chat de grupo ou canal) com mais de 60 utilizadores, os utilizadores podem utilizar o botão atualizar no menu de opções da mensagem para obter o resultado mais recente.

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.

Observação

Para aplicações que não têm Action.Execute e refresh esquema definido, o pedido de instalação não é apresentado aos utilizadores.

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

GIF mostra o fluxo de utilizador para uma extensão de mensagem dinâmica e instalação JIT.

Confira também