Freigeben über

Verbinden eines Bots mit Microsoft Teams

  • Artikel

GILT FÜR: SDK v4

Sie können Ihren Bot für die Kommunikation mit Personen über die Microsoft Teams konfigurieren. In diesem Artikel wird beschrieben, wie Sie eine Teams-App in Teams erstellen, Ihren Bot mit Ihrer Teams-App in Azure verbinden und dann Ihren Bot in Teams testen.

Voraussetzungen

  • Ein Azure-Abonnement. Wenn Sie noch nicht über ein Abonnement verfügen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
  • Ein Bot, der in Azure veröffentlicht wurde, den Sie mit Teams verbinden möchten.
  • Eine Entwickler-Instanz in Teams mit aktiviertem benutzerdefiniertem Hochladen oder Querladen. Weitere Informationen erhalten Sie unter Microsoft 365-Instanz vorbereiten.
  • Ein gültiges Teams-App-Paket. Weitere Informationen finden Sie unter App in Microsoft Teams hochladen.

Konfigurieren Sie Ihren Bot in Azure

  1. Öffnen Sie das Azure-Portal.
  2. Öffnen Sie das Azure Bot-Ressourcen-Blatt für Ihren Bot.
  3. Öffnen Sie Kanäle und wählen Sie Microsoft Teams:
    1. Lesen und akzeptieren Sie die Vertragsbedingungen.
    2. Wählen Sie auf der Registerkarte Messaging die Cloud-Umgebung für Ihren Bot. Weitere Informationen finden Sie im Abschnitt Build posten von Planen Sie Ihre App mit Teams-Features.
    3. Wählen Sie Übernehmen.
  4. Wählen Sie Bot-Einbettungscode abrufen, suchen Sie den Einbettungscode für Teams und kopieren Sie dann den https-Teil des Codes. Beispiel: https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232. Sie können diesen Code verwenden, um den Bot in Teams zu testen.

Tipp

  • Die Registerkarte Anrufe unterstützt das Feature für Teams-Anrufe. Weitere Informationen finden Sie unter Registrieren des Anruf- und Besprechungs-Bots für Microsoft Teams.
  • Die Registerkarte Veröffentlichen enthält Informationen zum Veröffentlichen Ihrer Teams-App im Teams Store.
  • Das von 21Vianet betriebene Microsoft Azure unterstützt das Feature "Bot-Einbettungscode abrufen" nicht. Um den Teams-Kanal zu testen, erstellen Sie die Teams-App, und stellen Sie sie mithilfe der unten aufgeführten Schritte bereit.

Ihren Bot in Teams testen

Bots in der Produktionsumgebung sollten als Teil einer Teams-App zu Teams hinzugefügt werden. Weitere Informationen finden Sie unter Testen Sie Ihre App.

Wichtig

Bots sollten ausschließlich zu Testzwecken per GUID hinzugefügt werden. Durch diese Vorgehensweise wird die Funktionalität eines Bots erheblich eingeschränkt. Bots in der Produktionsumgebung sollten Teams als Teil einer App hinzugefügt werden.

  1. Öffnen Sie in Ihrem Browser die URL, die Sie aus Ihrem Einbindungscode kopiert haben, und wählen Sie dann die Microsoft Teams-App (Client oder Web) aus, die Sie zum Hinzufügen des Bots zu Teams verwenden. Sie sollten die Möglichkeit haben, den Bot als Kontakt anzuzeigen, an den Sie Nachrichten senden und von dem Sie Nachrichten in Microsoft Teams empfangen können.
  2. Interagieren Sie mit Ihrem Bot in Teams.

Tipp

Verwenden Sie eine Bot-Kanalregistrierung pro Umgebung, da sich Ihr Endpunkt ändert, wenn Sie zwischen lokaler Entwicklung, Staging und Produktionsumgebungen wechseln.

Wenn Sie die Registrierung des Teams-Kanals löschen, wird beim erneuten Aktivieren ein neues Schlüsselpaar generiert. Dadurch werden alle 29:xxx- und a:xxx-IDs ungültig, die der Bot möglicherweise für proaktives Messaging gespeichert hat.

Bot in Teams veröffentlichen

Anweisungen zum Veröffentlichen Ihrer App finden Sie in der Teams-Übersicht über das Verteilen Ihrer Microsoft Teams-App. Sie und die zugehörigen Artikel behandeln Folgendes:

  • Auswählen und Konfigurieren von Installationsoptionen für Ihren Bot
  • Erstellen Ihres Microsoft Teams-App-Manifests, -Symbols und -Pakets
  • Hochladen Ihrer App in Teams
  • Veröffentlichen Sie Ihre App für Ihre Organisation oder im Teams-Store

Weitere Informationen