Définir des commandes d’action d’extension de message

Pour créer une extension de message basée sur une action à l’aide de Teams Toolkit, procédez comme suit :

1. Ouvrez Visual Studio Code.
2. Dans le volet gauche, sélectionnez Kit de ressources Teams.
3. Sélectionnez Créer une application.
4. Sélectionnez Extension de message.
5. Sélectionnez Collecter à partir des données d’entrée et de traitement.
6. Sélectionnez un langage de programmation.
7. Sélectionnez Dossier par défaut.
8. Entrez le nom de votre application, puis sélectionnez Entrée.

Teams Toolkit crée une structure de votre projet et crée une extension de message d’action.

Pour créer une extension de message basée sur une action à l’aide du Portail des développeurs pour Teams, procédez comme suit :

1. Accédez au Portail des développeurs pour Teams.

2. Accédez à Applications.

3. Sélectionnez Créer une application.

4. Sous Configurer, sélectionnez Fonctionnalités de l’application.

5. Sélectionnez Extension de messagerie.

   

6. Sous Type d’extension de message, sélectionnez Bot.

   1. Si vous obtenez une clause d’exclusion de responsabilité, qui indique que l’extension de message d’API est déjà utilisée par les utilisateurs. Voulez-vous changer le type d’extension de message en bot ?. Sélectionnez Oui, modifier.

   

7. Si vous n’avez pas de bot existant, sélectionnez Bot existant ou, si vous avez un ID de bot, sélectionnez Entrer l’ID du bot.

   1. Si vous n’avez pas d’ID de bot, sélectionnez Créer un bot pour créer un bot et entrez l’ID du bot que vous avez créé.

8. Sélectionnez les étendues requises.

9. Sous Commande, sélectionnez + Ajouter une commande.

   Une page de détails de commande s’affiche.

10. Dans la page Détails de la commande, sélectionnez Action , puis type de paramètre.

11. Sélectionnez Action comme type de commande et mettez à jour les champs suivants :

    • ID de commande
    • Titre de la commande
    • Description de la commande
    • Contexte dans lequel la commande fonctionne
    • Nom du paramètre
    • Titre du paramètre
    • Description du paramètre
    • Type de description du paramètre

12. Sélectionnez Ajouter un domaine sous Liens de préversion.

13. Entrez domaine valide, puis sélectionnez Ajouter.

    

14. Sélectionnez Enregistrer.

    

Pour ajouter des paramètres supplémentaires

1. Sous la commande, sélectionnez l’icône d’ellipse (...), puis sélectionnez Modifier le paramètre.

   

2. Sélectionnez Ajouter un paramètre et mettez à jour les détails du paramètre.

   

3. Sélectionnez Enregistrer.

Une extension de message d’action basée sur un bot est créée.

• Référence du Kit de développement logiciel (SDK)
• Exemple de référence de code

protected override Task<MessagingExtensionActionResponse> OnTeamsMessagingExtensionFetchTaskAsync(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionAction action, CancellationToken cancellationToken)
        {
            // Handle different actions using switch.
            switch (action.CommandId)
            {
                case "HTML":
                    return new MessagingExtensionActionResponse
                    {
                        Task = new TaskModuleContinueResponse
                        {
                            Value = new TaskModuleTaskInfo
                            {
                                Height = 200,
                                Width = 400,
                                Title = "Task Module HTML Page",
                                Url = baseUrl + "/htmlpage.html",
                            },
                        },
                    };
                default:
                    string memberName = "";
                    var member = await TeamsInfo.GetMemberAsync(turnContext, turnContext.Activity.From.Id, cancellationToken);
                    memberName = member.Name;
                    return new MessagingExtensionActionResponse
                    {
                        Task = new TaskModuleContinueResponse
                        {
                            Value = new TaskModuleTaskInfo
                            {
                                Card = <<AdaptiveAction card json>>,
                                Height = 200,
                                Width = 400,
                                Title = $"Welcome {memberName}",
                            },
                        },
                    };
            }
        }

Exemple de référence de code

// Invoked when a Messaging Extension Fetch activity is received from the connector.
    async handleTeamsMessagingExtensionFetchTask(context, action) {
        switch (action.commandId) {
            case 'Static HTML':
                return staticHtmlPage();
        }
    }

    staticHtmlPage(){
        return {
            task: {
                type: 'continue',
                value: {
                    width: 450,
                    height: 125,
                    title: 'Dialog Static HTML',
                    url: `${baseurl}/StaticPage.html`
                }
            }
        };
    }