Actions universelles pour les extensions de message basées sur la recherche

  • Article

Les cartes adaptatives dans les extensions de message basées sur la recherche prennent désormais en charge les actions universelles. Pour activer les actions universelles pour les extensions de message basées sur la recherche, l’application doit être conforme au schéma des actions universelles pour les cartes adaptatives , ainsi qu’aux exigences suivantes :

  1. L’application doit avoir un bot de conversation défini dans le manifeste de l’application.
  2. Si vous avez déjà un bot conversationnel, vous devez utiliser le même bot que celui utilisé dans votre extension de message.
  3. Si le carte est envoyé dans un groupe, l’application doit spécifier team ou groupchat l’étendue de son bot dans le manifeste.

Exemple de schéma JSON avec les team valeurs et 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
        }
    ]
}

Actualisation automatique des cartes adaptatives dans les extensions de message basées sur la recherche

Activez l’actualisation automatique des cartes adaptatives dans les extensions de message basées sur la recherche afin que les utilisateurs voient toujours les dernières informations. Pour activer, définissez userIds le tableau au format ou 8:orgid:<AAD ID> dans 29:<ID> la refresh propriété . Pour plus d’informations, consultez Utiliser des actions universelles pour les cartes adaptatives.

Exemple de userIds tableau dans la refresh propriété :

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

Remarque

L’actualisation automatique est activée pour tous les utilisateurs de la conversation de groupe ou du canal avec moins ou 60 utilisateurs. Pour les conversations (conversation de groupe ou canal) avec plus de 60 utilisateurs, les utilisateurs peuvent utiliser le bouton Actualiser dans le menu des options de message pour obtenir le résultat le plus récent.

Exemple de Action.Execute dans la refresh propriété :

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

Installation juste-à-temps

Juste-à-temps (JIT) vous permet d’installer une extension de carte ou de message pour plusieurs utilisateurs dans une conversation ou un canal de groupe. Afin de prendre en charge les actions universelles dans les extensions de message basées sur la recherche, votre bot est ajouté à la conversation où le carte (avec Action.Execute) est envoyé par l’utilisateur.

Lorsqu’un utilisateur sélectionne un carte et l’envoie dans une conversation ou un canal de groupe, une invite d’installation JIT s’affiche. Une fois que l’utilisateur a sélectionné l’option d’envoi , l’application est ajoutée pour tous les utilisateurs de la conversation ou du canal en arrière-plan.

Remarque

Pour les applications qui n’ont Action.Execute pas de schéma et refresh définis, l’invite d’installation n’est pas affichée aux utilisateurs.

Exemple de flux d’utilisateur d’installation me et JIT dynamique :

GIF affiche le flux utilisateur pour une extension de message dynamique et une installation JIT.

Voir aussi