Hinzufügen eines Bot-Menüs in Microsoft Teams

Um die Ermittlung zu erleichtern und die Benutzer über die Funktionalität Ihres Bots zu informieren, können Sie jetzt Menüs hinzufügen, die immer dann angezeigt werden, wenn der Benutzer mit Ihrem Bot interagiert. Das Menü zeigt den Befehlstext an und enthält auch Hilfetext, z. B. ein Verwendungsbeispiel oder eine Beschreibung des Befehlszwecks.

Wenn ein Benutzer ein Menüelement auswählt, wird die Befehlszeichenfolge in das Textfeld eingefügt, um den Benutzer beim Abschließen der Bot-Nachricht zu unterstützen.

Bot-Menü-Unterstützung in der mobilen Teams-App

App-Manifest

Um ein Botmenü zu erstellen, fügen Sie Ihrem App-Manifest unter dem Bot-Abschnitt ein neues commandLists Objekt hinzu. Sie können einzelne Menüs mit separaten Befehlen für jeden Bereich deklarieren, den Ihr Bot unterstützt (personal, groupChatoder team) Jedes Menü unterstützt bis zu 10 Befehle.

Manifestauszug – einzelnes Menü für beide Bereiche

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

Manifestauszug – separates Menü pro Bereich

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

Bewährte Methoden

• Halten Sie es einfach: Das Botmenü soll die wichtigsten Funktionen Ihres Bots präsentieren.
• Machen Sie es kurz: Menüoptionen sollten nicht extrem lang und komplexe Anweisungen in natürlicher Sprache sein – es sollten einfache Befehle sein.
• Immer verfügbar: Bot-Menüaktionen/-befehle sollten immer aufrufbar sein, unabhängig vom Status der Konversation oder dem Dialog, in dem sich der Bot befindet.