Aktivitätsfeedbenachrichtigung senden
Die Microsoft Teams-Aktivitätsfeedbenachrichtigung hilft Benutzern, Elemente zu bewerten, die Aufmerksamkeit erfordern, indem sie die Änderungen benachrichtigen. Um die Benachrichtigungsfunktion für Aktivitätsfeeds auf Ihre App zu erweitern, verwenden Sie die Benachrichtigungs-APIs für Aktivitätsfeeds in Microsoft Graph.
Die wichtigsten Features der Aktivitätsfeedübertragung sind:
- Bietet eine verbesserte Benutzererfahrung.
- Hält Benutzer auf dem neuesten Stand.
- Sendet eine Nachricht für alle Mitglieder.
- Zeigt eine Aktivitätsfeedbenachrichtigung an.
- Überträgt Details, die für Mitglieder verfügbar sind.
Diese Schritt-für-Schritt-Anleitung hilft Ihnen, Nachrichten zu übertragen und alle Mitglieder einer Organisation mithilfe von Aktivitätsfeedbenachrichtigungen zu benachrichtigen. Die folgende Ausgabe wird angezeigt:
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Tools installieren und Ihre Entwicklungsumgebung einrichten:
| Installieren | Zum Benutzen... | |
|---|---|---|
| Visual Studio 2022 | Sie können die Unternehmensversion in Visual Studio 2022 und die Workloads ASP.NET und Webentwicklung installieren. Verwenden Sie die neueste Version. | |
| .NET Core SDK Version 3.1 | Angepasste Bindungen für lokales Debuggen und Bereitstellungen von Azure Functions-Apps. Verwenden Sie die neueste Version, oder installieren Sie die portable Version. | |
| Entwicklungstunnel | Teams-App-Features (Konversationsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Dev Tunnel ist ein leistungsstarkes Tool, um Ihren Localhost sicher für das Internet zu öffnen und zu steuern, wer Zugriff hat. Dev Tunnel ist in Visual Studio 2022 Version 17.7.0 oder höher verfügbar. Sie können auch ngrok als Tunnel verwenden, um Ihr Entwicklungssystem mit Teams zu verbinden. Dies ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mithilfe von npm devDependencies). |
Hinweis
Nachdem Sie ngrok heruntergeladen haben, registrieren Sie sich, und installieren Sie authtoken.
Stellen Sie sicher, dass Sie über die folgenden Konten verfügen, und richten Sie Ihre Entwicklungsumgebung ein:
- Microsoft-Konto .
- Die Teams-App muss für den Empfänger entweder persönlich oder in einem Team oder Chat installiert werden.
- Die Mandanten-ID zum Senden und Empfangen von Benachrichtigungen muss übereinstimmen.
Einrichten Ihres Teams-Entwicklungsmandanten
Ein Mandant ist wie ein Raum oder Container, in dem Sie chatten, Dateien freigeben und Besprechungen für Ihre Organisation in Teams ausführen. Sie können die benutzerdefinierte App auch hochladen und testen.
Überprüfen auf benutzerdefinierte App-Uploadoption
Nachdem Sie die App erstellt haben, müssen Sie ihre App in Teams laden, ohne sie zu verteilen. Die Funktion wird als benutzerdefinierter App-Upload bezeichnet. Melden Sie sich bei Ihrem Microsoft 365-Konto an, um diese Option anzuzeigen.
Hinweis
Ein benutzerdefinierter App-Upload ist für die Vorschau und das Testen von Apps in der lokalen Teams-Umgebung erforderlich. Aktivieren Sie den benutzerdefinierten App-Upload, um eine Vorschau ihrer App in Teams lokal anzuzeigen und zu testen.
Verfügen Sie bereits über einen Mandanten und über Administratorzugriff? Lassen Sie uns überprüfen, ob Sie dies wirklich tun!
So überprüfen Sie benutzerdefinierte Upload-Apps in Teams:
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.
Hinweis
Wenden Sie sich an den Teams-Administrator, wenn Sie keine benutzerdefinierte App hochladen können.
Erstellen eines kostenlosen Teams-Entwicklermandanten (optional)
Wenn Sie nicht über ein Teams-Entwicklerkonto verfügen, können Sie es kostenlos erhalten. Nehmen Sie am Microsoft 365-Entwicklerprogramm teil!
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.
Richten Sie ein Administratorkonto ein. Nachdem Sie fertig sind, wird der folgende Bildschirm angezeigt.
Melden Sie sich mit dem neuen Administratorkonto bei Teams an. Jetzt können Sie benutzerdefinierte App hochladen auswählen.
Einrichten einer lokalen Umgebung
Öffnen Sie Microsoft-Teams-Samples.
Wählen Sie Code aus.
Wählen Sie im Dropdownmenü Mit GitHub Desktop öffnen aus.
Wählen Sie Klonen aus.
Registrieren Des einmaligen Anmeldens für Teams Auth mit Microsoft Entra ID
Die folgenden Schritte helfen Ihnen beim Erstellen und Registrieren des einmaligen Anmeldens für die Teams-Authentifizierung im Azure-Portal:
- Erstellen und registrieren Sie eine neue Anwendung unter App-Registrierungen.
- Verwenden Sie ngrok, um einen Tunnel zu den Endpunkten Ihres Webservers zu erstellen.
Hinzufügen der App-Registrierung
Navigieren Sie zum Azure-Portal.
Wählen Sie App-Registrierungen aus.
Wählen Sie + Neue Registrierung aus.
Geben Sie den Namen Ihrer App ein.
Wählen Sie Konten in einem beliebigen Organisationsverzeichnis (Beliebiger Microsoft Entra ID-Mandant – Mehrinstanzenfähig) aus.
Wählen Sie Registrieren aus.
Ihre App ist in der Microsoft Entra-ID registriert. Die App-Übersichtsseite wird angezeigt.
Hinweis
Speichern Sie die App-ID unter Anwendungs-ID (Client) und Verzeichnis-ID (Mandant) zur weiteren Verwendung.
Erstellen eines Tunnels
Öffnen Sie Visual Studio.
Wählen Sie Neues Projekt erstellen aus.
Geben Sie im Suchfeld ASP.NET ein. Wählen Sie in den Suchergebnissen ASP.NET Core Web App aus.
Wählen Sie Weiter aus.
Geben Sie Projektname ein , und wählen Sie Weiter aus.
Wählen Sie Erstellen aus.
Ein Übersichtsfenster wird angezeigt.
Wählen Sie in der Dropdownliste Debug die Option Dev Tunnels (kein aktiver Tunnel)>Tunnel erstellen... aus.
Ein Popupfenster wird geöffnet.
Aktualisieren Sie die folgenden Details im Popupfenster:
- Konto: Geben Sie ein Microsoft- oder GitHub-Konto ein.
- Name: Geben Sie einen Namen für Ihren Tunnel ein.
- Tunneltyp: Wählen Sie in der Dropdownliste die Option Temporär aus.
- Zugriff: Wählen Sie in der Dropdownliste Öffentlich aus.
Wählen Sie OK aus.
Ein Popupfenster wird angezeigt, in dem angezeigt wird, dass der Entwicklungstunnel erfolgreich erstellt wurde.
Wählen Sie OK aus.
Sie finden den tunnel, den Sie erstellt haben, in der Debug-Dropdownliste wie folgt:
Wählen Sie F5 aus, um die Anwendung im Debugmodus auszuführen.
Wenn ein Dialogfeld Sicherheitswarnung angezeigt wird, wählen Sie Ja aus.
Ein Popupfenster wird geöffnet.
Wählen Sie Weiter.
Die Dev Tunnel-Startseite wird in einem neuen Browserfenster geöffnet, und der Entwicklungstunnel ist jetzt aktiv.
Wechseln Sie zu Visual Studio, und wählen Sie Ausgabe anzeigen >aus.
Wählen Sie im Dropdownmenü Ausgabekonsoledie Option Dev Tunnels aus.
In der Ausgabekonsole wird die Dev Tunnel-URL angezeigt.
Hinzufügen des Anwendungs-ID-URI
Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.
Wählen Sie neben Anwendungs-ID-URIdie Option Hinzufügen aus.
Aktualisieren Sie den Anwendungs-ID-URI im
api://your-devtunnel-domain/botid-{AppID}Format oderapi://your-ngrok-domain/botid-{AppID}, und wählen Sie Speichern aus.
Die folgende Abbildung zeigt den Domänennamen:
Hinweis
Wenn Sie einen Tunnelingdienst wie ngrok verwenden, stellen Sie sicher, dass Sie den Wert aktualisieren, wenn Ihre ngrok-Unterdomäne aktualisiert wird. Beispiel: api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, wobei f631****.ngrok.io der name der neuen ngrok-Unterdomäne ist.
Hinzufügen eines Bereichs
Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.
Wählen Sie + Bereich hinzufügen aus.
Geben Sie access_as_user als Bereichsnamen ein.
Wählen Sie unter Wer kann zustimmen?die Option Administratoren und Benutzer aus.
Aktualisieren Sie die Werte für die restlichen Felder wie folgt:
Geben Sie Teams kann als Anzeigename der Administratoreinwilligungauf das Profil des Benutzers zugreifen ein.
Geben Sie Erlaubt Teams das Aufrufen der Web-APIs der App als aktuellen Benutzer als Beschreibung der Administratoreinwilligung ein.
Geben Sie Teams kann auf das Benutzerprofil zugreifen und Anforderungen im Namen des Benutzers als Anzeigename für die Benutzereinwilligung stellen ein.
Geben Sie Teams aktivieren ein, um die APIs dieser App mit den gleichen Rechten wie der Benutzer als Beschreibung der Benutzereinwilligung aufzurufen.
Stellen Sie sicher, Zustand auf Aktiviert festgelegt ist.
Klicken Sie auf Bereich hinzufügen.
Die folgende Abbildung zeigt die Felder und die Werte:
Hinweis
Der Bereichsname muss mit dem Anwendungs-ID-URI übereinstimmen, der
/access_as_useram Ende angefügt ist.
Hinzufügen einer Clientanwendung
Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.
Identifizieren Sie unter Autorisierte Clientanwendungen die Anwendungen, die Sie für die Webanwendung Ihrer App autorisieren möchten.
Wählen Sie + Clientanwendung hinzufügen aus.
Fügen Sie Teams mobile oder Desktop- und Teams-Webanwendung hinzu.
Für Teams Mobile oder Desktop: Geben Sie die Client-ID als ein
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
Für Teams-Web: Geben Sie die Client-ID als ein
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Aktivieren Sie das Kontrollkästchen Autorisierte Bereiche .
Wählen Sie Anwendung hinzufügen aus.
Die folgende Abbildung zeigt die Client-ID:
Api-Berechtigung hinzufügen
Wählen Sie im linken Bereich unter Verwalten die Option API-Berechtigungen aus.
Wählen Sie + Berechtigung hinzufügen aus.
Wählen Sie Microsoft Graph aus.
Wählen Sie Delegierte Berechtigungen aus.
Wählen Sie die folgenden Berechtigungen aus:
Directory.Read.All
Directory.ReadWrite.All
TeamsActivity.Send
TeamsAppInstallation.ReadForUser
TeamsAppInstallation.ReadWriteForUser
User.Read
Hinweis
Benutzer. Lesen ist standardmäßig aktiviert.
Wählen Sie Berechtigungen hinzufügen aus.
Wählen Sie + Berechtigung hinzufügen aus.
Wählen Sie Microsoft Graph aus.
Wählen Sie Anwendungsberechtigungen aus.
Wählen Sie die folgenden Berechtigungen aus:
- Directory.Read.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser.All
Wählen Sie Berechtigungen hinzufügen aus.
Stellen Sie sicher, dass Sie der Administratoreinwilligung für die erforderlichen Berechtigungen erteilen.
Stellen Sie sicher, dass Sie der Administratoreinwilligung für die erforderlichen Berechtigungen erteilen.
Hinweis
- Wenn einer App keine Zustimmung des IT-Administrators erteilt wird, müssen Benutzer bei der ersten Verwendung einer App ihre Zustimmung erteilen.
- Benutzer müssen den API-Berechtigungen nur zustimmen, wenn die Microsoft Entra-App in einem anderen Mandanten registriert ist.
Hinzufügen einer Webauthentifizierung
Wählen Sie im linken Bereich unter Verwalten die Option Authentifizierung aus.
Wählen SiePlattform-Single-Page-Anwendung>hinzufügenaus.
Geben Sie den Umleitungs-URI für Ihre App ein, indem Sie an den vollqualifizierten Domänennamen anfügen
auth-end. Zum Beispielhttps://your-devtunnel-domain/auth-endoderhttps://your-ngrok-domain/auth-end.Aktivieren Sie unter Implizite Genehmigung und Hybridflows die Kontrollkästchen Zugriffstoken und ID-Token .
Wählen Sie Konfigurieren aus.
Wählen Sie unter Web die Option URI hinzufügen aus.
https://token.botframework.com/.auth/web/redirecteingeben.Klicken Sie auf Speichern.
Erstellen eines geheimen Clientschlüssels
Wählen Sie im linken Bereich unter Verwalten die Option Zertifikate & Geheimnisse aus.
Wählen Sie unter Geheime Clientschlüsseldie Option + Neuer geheimer Clientschlüssel aus.
Das Fenster Geheimen Clientschlüssel hinzufügen wird angezeigt.
Geben Sie Beschreibung ein.
Klicken Sie auf Hinzufügen.
Wählen Sie unter Wertdie Option In Zwischenablage kopieren aus, um den Wert des geheimen Clientschlüssels zur weiteren Verwendung zu speichern.
Einrichten von App-Einstellungen
Wechseln Sie zu appsettings.json Datei im geklonten Repository.
Öffnen Sie die appsettings.json-Datei in der neuesten Version von Visual Studio, und aktualisieren Sie die folgenden Informationen:
Legen Sie
"MicrosoftAppId"auf die Microsoft-App-ID Ihres Bots fest.Legen Sie auf Verzeichnis-ID (Mandant) fest
"TenantID".Legen Sie
"MicrosoftAppPassword"auf den Wert der geheimen Client-ID Ihres Bots fest.Legen Sie
"BaseUrl"auf fest[WebAppDomainName].
Einrichten der Manifestdatei
Wechseln Sie zur manifest.json-Datei im geklonten Repository.
Öffnen Sie die manifest.json-Datei in der neuesten Version von Visual Studio, und nehmen Sie die folgenden Änderungen vor:
Ersetzen Sie alle Vorkommen von
<<Microsoft-App-ID>>durch die Microsoft App-ID Ihres Bots.Ersetzen Sie alle Vorkommen von
<<Base_URL>>durch Ihren vollqualifizierten Domänennamen.Legen Sie auf fest
validDomains[WebAppDomainName].
Erstellen und Ausführen des Diensts
Öffnen Sie Visual Studio.
Wechseln Sie zu Datei>Projekt>/Projektmappe öffnen....
Wählen Sie die ActivityFeedBroadcast.sln Datei aus dem Ordner csharp aus.
Klicken Sie auf Öffnen.
Press F5 to run the project.
Wählen Sie Ja aus, wenn das folgende Dialogfenster angezeigt wird:
Eine Webseite wird mit einer Meldung geöffnet: Ihr Bot ist bereit!
Hinzufügen einer Aktivitätsfeed-Broadcast-App zu Teams
Wechseln Sie in Ihrem geklonten Repository zu graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppManifest.
Erstellen Sie eine .zip-Datei mit den folgenden Dateien, die im Ordner AppManifest vorhanden sind:
manifest.json
outline.png
color.png
Wählen Sie im Teams-Client das Symbol Apps aus.
Wählen Sie Verwalten Ihrer Apps aus.
Wählen Sie App an Ihre Organisation übermitteln aus.
Wählen Sie Öffnen aus, um die .zip Datei hochzuladen, die Sie im Ordner AppManifest erstellt haben.
Klicken Sie auf Hinzufügen.
Interagieren mit der App in Teams
Lassen Sie uns mit der App in Teams interagieren!
Auf der Registerkarte Broadcast werdender Nachrichtentitel und die Beschreibung der Nachricht angezeigt.
Geben Sie den Titel und die Beschreibung der Nachricht ein**.
Wählen Sie Nachricht senden aus.
Die Nachricht, die erfolgreich übertragen wurde, wird angezeigt.
Die Aktivitätsfeedbenachrichtigung wird auf der Registerkarte Aktivität des Empfängers mit der gleichen Mandanten-ID angezeigt.
Die Nachrichtendetails werden beim Auswählen der Nachricht angezeigt.
Abschließen der Herausforderung
Haben Sie sich so etwas einfallen lassen?
Herzlichen Glückwunsch!
Sie haben das Tutorial für die ersten Schritte mit der Aktivitätsfeed-Broadcast-App abgeschlossen!
Liegt ein Problem mit diesem Abschnitt vor? Wenn ja, senden Sie uns Feedback, damit wir den Abschnitt verbessern können.