Adicionar um menu de bot no Microsoft Teams

Importante

Este artigo baseia-se no SDK v3 do Bot Framework. Se estiver à procura da versão atual da documentação 4.6 ou posterior do SDK, consulte a secção bots de conversação .

Para ajudar na deteção e ajudar a informar os utilizadores sobre a funcionalidade do bot, agora pode adicionar menus que aparecem sempre que o utilizador interage com o bot. O menu mostrará o texto do comando e também fornecerá texto de ajuda, como um exemplo de utilização ou uma descrição da finalidade do comando.

Quando um utilizador seleciona um item de menu, a cadeia de comandos é inserida na caixa de texto para ajudar na conclusão do utilizador da mensagem do bot.

Suporte do menu Bot na aplicação Teams para dispositivos móveis

Observação

Os menus de bot não são apresentados em dispositivos móveis.

Manifesto do aplicativo

Para criar um menu de bot, adicione um novo commandLists objeto ao manifesto da aplicação na secção bot. Pode declarar menus individuais com comandos separados para cada âmbito suportado pelo bot (personal, groupChatou team) Cada menu suporta até 10 comandos.

Excerto de manifesto - menu único para ambos os âmbitos

{
  ⋮
  "bots":[
    {
      "botId":"[Microsoft App ID for your bot]",
      "scopes": [
        "personal",
        "team"
      ],
      "commandLists":[
        {
          "scopes":[
            "team",
            "personal"
          ],
          "commands":[
            {
              "title":"Help",
              "description":"Displays this help message"
            },
            {
              "title":"Search Flights",
              "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm"
            },
            {
              "title":"Search Hotels",
              "description":"Search hotels in Portland tonight"
            },
            {
              "title":"Best Time to Fly",
              "description":"Best time to fly to London for a 5 day trip this summer"
            }
          ]
        }
      ]
    }
  ],
  ...
}

Excerto de manifesto - menu separado por âmbito

{
  ...
  "bots":[
    {
      "botId":"[Microsoft app ID for your bot]",
      "scopes": [
        "groupChat",
        "team"
      ],
      "commandLists":[
        {
          "scopes":[
            "team"
          ],
          "commands":[
            {
            "title":"help",
            "description":"Displays this help message for channels"
            }
          ]
        },
        {
          "scopes":[
            "groupChat"
          ],
          "commands":[
            {
            "title":"help",
            "description":"Displays this help message for group chat"
            }
          ]
        }
      ]
    }
  ],
  ...
}

Práticas recomendadas

• Mantenha-o simples: o menu do bot destina-se a apresentar os principais recursos do bot.
• Seja breve: as opções de menu não devem ser instruções de linguagem natural extremamente longas e complexas. Devem ser comandos simples.
• Sempre disponível: as ações/comandos do menu bot devem ser sempre invokáveis, independentemente do estado da conversação ou da caixa de diálogo em que o bot se encontra.