Proaktive Nachrichten senden
Eine proaktive Nachricht ist eine Nachricht, die von einem Bot als Reaktion auf einfache Befehle gesendet wird, die im Chat von einem Benutzer gesendet werden. Die Nachrichtenantwort kann in einem der folgenden Formate vorliegen:
- Willkommensnachrichten
- Geplante Nachrichten
- Benachrichtigungen
Diese Schritt-für-Schritt-Anleitung hilft Ihnen beim Senden einer proaktiven Nachricht von einem Bot. Die folgende Ausgabe wird angezeigt:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihrer Apps installieren.
| Installieren | Für die Verwendung von | |
|---|---|---|
| Microsoft Visual Studio Code | JavaScript oder TypeScript, Buildumgebungen. Verwenden Sie die neueste Version. | |
| Microsoft Teams-Toolkit | Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Version. | |
| Node.js | Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter Node.js Versionskompatibilitätstabelle für den Projekttyp. | |
| Microsoft Teams | Teams für die Zusammenarbeit mit allen, mit denen Sie arbeiten, über Apps für Chat, Besprechungen, Anrufe und alles an einem Ort. | |
| Microsoft Edge (empfohlen) oder Google Chrome | Ein Browser mit Entwicklertools. | |
| Microsoft 365-Entwicklerkonto | Zugriff auf das Teams-Konto mit den entsprechenden Berechtigungen zum Installieren einer App. |
Vorbereiten der Entwicklungsumgebung
Nachdem Sie die erforderlichen Tools installiert haben, richten Sie die Entwicklungsumgebung ein.
Installieren des Teams-Toolkits
Das Microsoft Teams-Toolkit vereinfacht den Entwicklungsprozess mit Tools zum Bereitstellen und Bereitstellen von Cloudressourcen für Ihre App und zum Veröffentlichen im Teams Store.
Sie können das Teams-Toolkit mit Visual Studio Code oder einer Befehlszeilenschnittstelle namens TeamsFx CLI verwenden.
Öffnen Sie Visual Studio Code, und wählen Sie Erweiterungen (STRG+UMSCHALT+X oder Erweiterungen anzeigen>)aus.
Geben Sie im Suchfeld Teams Toolkit ein.
Wählen Sie Installieren aus.
Das Symbol Teams Toolkit
wird in der Visual Studio Code-Aktivitätsleiste angezeigt.
Sie können das Teams-Toolkit auch über den Visual Studio Code Marketplace installieren.
Einrichten Ihres Teams-Entwicklungsmandanten
Ein Mandant ist ein Raum oder Container für Ihre Organisation in Teams, in dem Sie chatten, Dateien freigeben und Besprechungen ausführen. Dieser Bereich ist auch der Ort, an dem Sie Ihre App hochladen und testen. Lassen Sie uns überprüfen, ob Sie bereit sind, mit dem Mandanten zu entwickeln.
Option "Auf App-Upload überprüfen"
Nachdem Sie Ihre benutzerdefinierte App erstellt haben, müssen Sie Ihre App mit der Option Benutzerdefinierte App hochladen in Teams hochladen. Melden Sie sich bei Ihrem Microsoft 365-Konto an, um zu überprüfen, ob diese Option aktiviert ist.
Mit den folgenden Schritten können Sie überprüfen, ob Sie Apps in Teams hochladen können:
Wählen Sie im Teams-Client das Symbol Apps aus.
Wählen Sie Verwalten Ihrer Apps aus.
Wählen Sie App hochladen aus.
Suchen Sie nach der Option Hochladen einer benutzerdefinierten App. Wenn die Option angezeigt wird, können Sie benutzerdefinierte Apps hochladen.
Hinweis
Wenn Sie die Option zum Hochladen einer benutzerdefinierten App nicht finden, wenden Sie sich an Ihren Teams-Administrator.
Erstellen eines kostenlosen Teams-Entwicklermandanten (optional)
Wenn Sie nicht über ein Teams-Entwicklerkonto verfügen, treten Sie dem Microsoft 365-Entwicklerprogramm bei.
Gehen Sie zu Microsoft 365-Entwicklerprogramm.
Wählen Sie Jetzt beitreten aus, und folgen Sie den Anweisungen auf dem Bildschirm.
Wählen Sie auf der Willkommensseite E5-Abonnement einrichten aus.
Einrichten Ihres Administratorkontos. Nachdem Sie fertig sind, wird der folgende Bildschirm angezeigt:
Melden Sie sich bei Teams mit dem Administratorkonto an, das Sie gerade eingerichtet haben. Vergewissern Sie sich, dass Sie über die Option Benutzerdefinierte App hochladen in Teams verfügen.
Erstellen eines proaktiven Nachrichtenbots
Führen Sie die folgenden Schritte aus, um einen proaktiven Nachrichtenbot mit Visual Studio Code zu erstellen:
Öffnen Sie Visual Studio Code.
Wählen Sie das Symbol Teams Toolkit
in der Visual Studio Code-Aktivitätsleiste aus.Wählen Sie im linken Bereich Beispiele anzeigen aus.
Wählen Sie in der Liste der Beispiele proaktives Messaging aus. Es wird ein vordefiniertes Beispiel geöffnet, das zum Debuggen bereit ist.
Wählen Sie Erstellen aus.
Wählen Sie Standardordner aus, um ihren Projektstammordner am Standardspeicherort zu speichern.
Wenn Sie den Standardspeicherort ändern möchten, führen Sie die folgenden Schritte aus:
Wählen Sie Durchsuchen aus.
Wählen Sie den Speicherort für den Projektarbeitsbereich aus.
Wählen Sie Ordner auswählen aus.
Der proaktive Nachrichtenbot wird in wenigen Sekunden erstellt und zeigt den Dialog "Proaktiver Nachrichtenbot erfolgreich" in der unteren rechten Ecke mit der Option zum Debuggen an:
:::Wählen Sie in der oberen linken Ecke das Symbol Ausführen und Debuggen
aus.Wählen Sie in der Dropdownliste Debuggen (Edge) oder Debuggen (Chrome) aus.
Wenn das Debuggen erfolgreich ist, werden Sie aufgefordert, den proaktiven Nachrichtenbot in Teams auf Ihrem lokalen Computer hochzuladen.
Wählen Sie in der Dropdownliste neben Hinzufügen die Option Zu einem Team hinzufügen oder Zu einem Chat hinzufügen oder Zu einer Besprechung hinzufügen aus.
Geben Sie den Namen eines Chats oder Teams in das Suchfeld ein, und wählen Sie Bot einrichten aus.
Die Proaktive Nachrichtenbot-App wird in den Teams-Client hochgeladen, und die folgende Nachricht wird als Antwort auf die gesendete Nachricht angezeigt.
Kopieren Sie die URL, und fügen Sie sie ein, oder navigieren Sie im Browser zu der URL. Eine proaktive Hallo-Nachricht wird ausgelöst und im Chat freigegeben.
Wechseln Sie zu Teams. Sie erhalten eine proaktive Hallo-Nachricht vom Bot.
Machen Sie einen Rundgang durch den Quellcode
Das Teams-Toolkit stellt Komponenten zum Erstellen einer App bereit. Nach dem Erstellen des Projekts können Sie die Projektordner und -dateien im EXPLORER-Bereich von Visual Studio Code anzeigen.
Der neue Projektordner enthält den folgenden Inhalt:
| Ordner/Datei | Inhalt |
|---|---|
.vscode/ |
Visual Studio Code-Dateien zum Debuggen. |
appManifest/ |
Vorlagen für das App-Manifest (zuvor als Teams-App-Manifest bezeichnet). |
env/ |
Name/Wert-Paare werden in Umgebungsdateien gespeichert und von teamsapp.yml verwendet, um die Bereitstellungs- und Bereitstellungsregeln anzupassen. |
manifest.json |
Das App-Manifest für die Veröffentlichung über das Entwicklerportal für Teams wird in Properties/manifest.jsongespeichert. |
teamsapp.yml |
Die Hauptprojektdatei beschreibt Ihre App-Konfiguration und definiert die Aktionen, die in jeder Lebenszyklusphase ausgeführt werden sollen. |
teamsapp.local.yml |
Dies wird mit Aktionen überschrieben teamsapp.yml , die die lokale Ausführung und das Debuggen ermöglichen. |
Bereitstellen Ihres proaktiven Nachrichtenbots
Sie haben gelernt, eine Teams-App mit proaktiver Nachrichtenbotfunktion zu erstellen und auszuführen. Wir stellen die erste App mit proaktiver Nachrichtenbotfunktion in Azure mithilfe des Teams-Toolkits bereit.
Anmelden bei Ihrem Azure-Konto
Verwenden Sie Ihr Konto, um auf das Microsoft Azure-Portal zuzugreifen und neue Cloudressourcen zur Unterstützung Ihrer App bereitzustellen.
Öffnen Sie Visual Studio Code.
Öffnen Sie den Projektordner, in dem Sie die proaktive Nachrichtenbot-App erstellt haben.
Wählen Sie das Symbol Teams Toolkit
in der Visual Studio Code-Aktivitätsleiste aus.Wählen Sie Mit Ihren Anmeldeinformationen bei Azure anmelden aus.
Tipp
Wenn Sie die AZURE-KONTOerweiterung installiert haben und dasselbe Konto verwenden, können Sie diesen Schritt überspringen.
Ihr Standardwebbrowser wird geöffnet, damit Sie sich beim Konto anmelden können.
Schließen Sie den Browser, wenn Sie dazu aufgefordert werden, und kehren Sie zu Visual Studio Code zurück.
Im Abschnitt KONTEN der Randleiste werden die beiden Konten separat angezeigt. Außerdem wird die Anzahl der verwendbaren Azure-Abonnements aufgelistet, die Ihnen zur Verfügung stehen. Stellen Sie sicher, dass Mindestens ein verwendbares Azure-Abonnement verfügbar ist. Wenn nicht, melden Sie sich ab, und verwenden Sie ein anderes Konto.
Bereitstellen Ihrer App in Azure
Die Bereitstellung besteht aus zwei Schritten. Zunächst werden erforderliche Cloudressourcen erstellt (auch als Bereitstellung bezeichnet). Anschließend wird der Code Ihrer App in die erstellten Cloudressourcen kopiert. In diesem Tutorial stellen Sie die Bot-App bereit.
Was ist der Unterschied zwischen Bereitstellen und Bereitstellen?
Bereitstellen erstellt Ressourcen in Azure und Microsoft 365 für Ihre App, aber es wird kein Code (HTML, CSS und JavaScript) in die Ressourcen kopiert. Deploy kopiert den Code für Ihre App in die Ressourcen, die Sie während der Bereitstellung erstellt haben. Es ist üblich, mehrmals bereitzustellen, ohne neue Ressourcen bereitzustellen. Da die Bereitstellung einige Zeit in Anspruch nehmen kann, ist sie von der Bereitstellung getrennt.
Wählen Sie das Symbol Teams Toolkit
in der Visual Studio Code-Aktivitätsleiste aus.Wählen Sie unter LEBENSZYKLUSdie Option Bereitstellen aus.
Wählen Sie eines der vorhandenen Abonnements aus.
Wählen Sie eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine neue Ressourcengruppe. Weitere Informationen finden Sie unter Erstellen einer Ressourcengruppe.
Hinweis
Es wird ein Dialogfeld mit dem Hinweis angezeigt, dass beim Ausführen von Ressourcen in Azure Möglicherweise Kosten anfallen.
Wählen Sie Bereitstellen aus.
Beim Bereitstellungsprozess werden Ressourcen in der Azure-Cloud erstellt. Sie können den Fortschritt in den Dialogfeldern überwachen, die unten rechts angezeigt werden. Nach einigen Minuten wird das folgende Dialogfeld angezeigt:
Wählen Sie unter LEBENSZYKLUSdie Option Bereitstellen aus.
Wählen Sie Bereitstellen.
Die Bereitstellung dauert einige Zeit. Sie können den Fortschritt in den Dialogfeldern überwachen, die unten rechts angezeigt werden. Nach einigen Minuten wird das folgende Dialogfeld angezeigt.
Öffnen Sie den Debugbereich (STRG+UMSCHALT+D / ⌘⇧-D oder Ausführung anzeigen>) in Visual Studio Code.
Wählen Sie remote (Edge) starten aus der Dropdownliste Startkonfiguration aus.
Wenn das Debuggen erfolgreich ist, werden Sie aufgefordert, die proaktive Nachrichtenbot-App in Teams hochzuladen.
Wählen Sie in der Dropdownliste neben Hinzufügen die Option Zu einem Team hinzufügen oder Zu einem Chat hinzufügen oder Zu einer Besprechung hinzufügen aus.
Geben Sie den Namen eines Chats oder Teams in das Suchfeld ein, und wählen Sie Bot einrichten aus.
Die Proaktive Nachrichtenbot-App wird in den Teams-Client hochgeladen, und die folgende Nachricht wird als Antwort auf die gesendete Nachricht angezeigt.
Kopieren Sie die URL, und fügen Sie sie ein, oder navigieren Sie im Browser zu der URL. Eine proaktive Hallo-Nachricht wird ausgelöst und im Chat freigegeben.
Wechseln Sie zu Teams. Sie erhalten eine proaktive Hallo-Nachricht vom Bot.
Abschließen der Herausforderung
Haben Sie sich so etwas einfallen lassen?
Herzlichen Glückwunsch!
Sie haben das Szenario abgeschlossen.
- Sie können täglich Benachrichtigungen senden oder regelmäßig Feedback von Benutzern anfordern.
- Sie können Drosselungsgrenzwerte behandeln, um mehrere Benachrichtigungen zu vermeiden.
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.