Definir comandos de ação de extensão de mensagem

Para criar uma extensão de mensagem baseada em ação com o Teams Toolkit, siga estes passos:

1. Abra o Visual Studio Code.
2. No painel esquerdo, selecione Teams Toolkit.
3. Selecione Criar uma Nova Aplicação.
4. Selecione Extensão da Mensagem.
5. Selecione Recolher a Partir de Dados de Entrada e Processo.
6. Selecione uma linguagem de programação.
7. Selecione Pasta predefinida.
8. Introduza o nome da sua aplicação e selecione Enter.

O Teams Toolkit estrutura o seu projeto e cria uma extensão de mensagem de ação.

Para criar uma extensão de mensagem baseada em ações com o Portal do Programador para Teams, siga estes passos:

1. Aceda ao Portal do Programador do Teams.

2. Aceda a Aplicações.

3. Selecione Criar uma nova aplicação.

4. Em Configurar, selecioneFuncionalidades da aplicação.

5. Selecione Extensão de mensagens.

   

6. Em Tipo de extensão de mensagem, selecione Bot.

   1. Se receber uma exclusão de responsabilidade, que diz API Message extension já está a ser utilizada pelos utilizadores. Pretende alterar o tipo de extensão da mensagem para bot? Selecione Sim, alterar.

   

7. Se não tiver um bot existente, selecione Bot existente ou, se tiver um ID de bot, selecione Introduzir ID do Bot.

   1. Se não tiver um ID de bot, selecione Criar um bot para criar um novo bot e introduza o ID do bot novo que criou.

8. Selecione os âmbitos necessários.

9. Em Comando, selecione + Adicionar um comando.

   É apresentada uma página de detalhes do comando.

10. Na página Detalhes do comando, selecione Ação e, em seguida, selecione tipo de parâmetro.

11. Selecione Ação como o tipo de comando e atualize os seguintes campos:

    • ID do Comando
    • Título do comando
    • Descrição do comando
    • Contexto no qual o comando funciona
    • Nome do parâmetro
    • Título do parâmetro
    • Descrição do parâmetro
    • Tipo de descrição do parâmetro

12. Selecione Adicionar um domínio em Ligações de pré-visualização.

13. Introduza um domínio válido e, em seguida, selecione Adicionar.

    

14. Selecione Salvar.

    

Para adicionar parâmetros adicionais

1. Em comando, selecione o ícone de reticências (...) e, em seguida, selecione Editar parâmetro.

   

2. Selecione Adicionar um Parâmetro e atualize os detalhes do parâmetro.

   

3. Selecione Salvar

É criada uma extensão de mensagem de ação baseada em bot.

• Referência do SDK
• Referência de código de exemplo

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}",
                            },
                        },
                    };
            }
        }

Referência de código de exemplo

// 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`
                }
            }
        };
    }