Menu Aggiungi un bot in Microsoft Teams

Per facilitare l'individuazione e informare gli utenti sulle funzionalità del bot, è ora possibile aggiungere menu che vengono visualizzati ogni volta che l'utente interagisce con il bot. Il menu mostrerà il testo del comando e fornirà anche il testo della Guida, ad esempio un esempio di utilizzo o una descrizione dello scopo del comando.

Quando un utente seleziona una voce di menu, la stringa di comando viene inserita nella casella di testo per facilitare il completamento del messaggio del bot.

Supporto del menu Bot nell'app per dispositivi mobili Teams

Manifesto dell'app

Per creare un menu bot, aggiungere un nuovo commandLists oggetto al manifesto dell'app nella sezione bot. È possibile dichiarare singoli menu con comandi separati per ogni ambito supportato dal bot (personal, groupChat, o team) Ogni menu supporta fino a 10 comandi.

Estratto manifesto - menu singolo per entrambi gli ambiti

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

Estratto del manifesto - menu separato per ambito

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

Procedure consigliate

• Mantienilo semplice: il menu del bot ha lo scopo di presentare le funzionalità chiave del tuo bot.
• Crea una frase breve: le opzioni del menu non devono essere istruzioni in linguaggio naturale estremamente lunghe e complesse, ma devono essere comandi semplici.
• Sempre disponibile: le azioni/comandi del menu del bot dovrebbero essere sempre richiamabili, indipendentemente dallo stato della conversazione o del dialogo in cui si trova il bot.