Entpacken von Links in Teams mithilfe eines Bots

Microsoft Bot Framework erweitert die Kartenspezifikation um eine Reihe vordefinierter Karten, die Bots als Teil von Bot-Messaging verwenden können. Das Entpacken von Links mithilfe des Bots in Teams hilft Ihnen beim Registrieren Ihrer App und beim Empfangen einer Aufrufaktivität, wenn die URL mit der Domäne in den Nachrichtenbereich zum Verfassen eingefügt wird. Die Aufrufaktivität enthält die vollständige URL, und Sie können mit einer Karte antworten. Benutzer können den Link mithilfe eines Bots mit zusätzlichen Informationen entpacken, um eine verbesserte Benutzererfahrung zu erhalten.

Wichtige Features der Linkentkopplung

• Ermöglicht es dem Benutzer, URLs einzufügen und mit einer Karte zu antworten.
• Ermöglicht es dem Benutzer, die App zu registrieren und eine Aufrufaktivität zu erhalten.

Diese Schritt-für-Schritt-Anleitung hilft Ihnen beim Erstellen eines Bots, um das Entpacken von Links in Microsoft Teams für https://www.BotFramework.comdurchzuführen. Die folgende Ausgabe wird angezeigt:

Voraussetzungen

• 12 Minuten verbleibend

Stellen Sie sicher, dass Sie die folgenden Tools installieren und Ihre Entwicklungsumgebung einrichten:

Einrichten einer lokalen Umgebung

• 11 Minuten verbleibend

1. Öffnen Sie Microsoft-Teams-Samples.

2. Wählen Sie Code aus.

3. Wählen Sie im Dropdownmenü Mit GitHub Desktop öffnen aus.

   

4. Wählen Sie Klonen aus.

Registrieren der Microsoft Entra-App

• 10 Minuten verbleibend

Die folgenden Schritte helfen Ihnen beim Erstellen und Registrieren Ihres Bots im Azure-Portal:

• Erstellen und registrieren Sie Ihre Azure-App.
• Erstellen Sie einen geheimen Clientschlüssel, um die SSO-Authentifizierung des Bots zu aktivieren.
• Fügen Sie den Teams-Kanal hinzu, um den Bot im Teams-Kanal bereitzustellen.
• Verwenden Sie ngrok, um einen Tunnel zu den Endpunkten Ihres Webservers zu erstellen.
• Fügen Sie dem erstellten ngrok-Tunnel einen Messagingendpunkt hinzu.

Hinzufügen der App-Registrierung

1. Navigieren Sie zum Azure-Portal.

2. Wählen Sie App-Registrierungen aus.

   

3. Wählen Sie + Neue Registrierung aus.

   

4. Geben Sie den Namen Ihrer App ein.

5. Wählen Sie Konten in einem beliebigen Organisationsverzeichnis (Beliebiger Microsoft Entra ID-Mandant – Mehrinstanzenfähig) aus.

6. 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

ngrok http --host-header=localhost 3978

Hinzufügen einer Webauthentifizierung

1. Wählen Sie im linken Bereich unter Verwalten die Option Authentifizierung aus.

2. Wählen SiePlattformweb>hinzufügenaus.

   

3. Geben Sie den Umleitungs-URI für Ihre App ein, indem Sie an den vollqualifizierten Domänennamen anfügen auth-end . Zum Beispiel https://your-devtunnel-domain/auth-end oder https://your-ngrok-domain/auth-end.

4. Aktivieren Sie unter Implizite Genehmigung und Hybridflows die Kontrollkästchen Zugriffstoken und ID-Token .

5. Wählen Sie Konfigurieren aus.

   

6. Wählen Sie unter Web die Option URI hinzufügen aus.

7. https://token.botframework.com/.auth/web/redirect eingeben.

8. Klicken Sie auf Speichern.

   

Erstellen eines geheimen Clientschlüssels

1. Wählen Sie im linken Bereich unter Verwalten die Option Zertifikate & Geheimnisse aus.

2. Wählen Sie unter Geheime Clientschlüsseldie Option + Neuer geheimer Clientschlüssel aus.

   

   Das Fenster Geheimen Clientschlüssel hinzufügen wird angezeigt.

3. Geben Sie Beschreibung ein.

4. Klicken Sie auf Hinzufügen.

   

5. Wählen Sie unter Wertdie Option In Zwischenablage kopieren aus, um den Wert des geheimen Clientschlüssels zur weiteren Verwendung zu speichern.

   

Api-Berechtigung hinzufügen

1. Wählen Sie im linken Bereich unter Verwalten die Option API-Berechtigungen aus.

2. Wählen Sie + Berechtigung hinzufügen aus.

   

3. Wählen Sie Microsoft Graph aus.

4. Wählen Sie Delegierte Berechtigungen aus.

5. Wählen Sie die folgenden Berechtigungen aus:

   • OpenId-Berechtigungen>email, offline_access, openid, profile.
   • Benutzer>User.Read.

6. Wählen Sie Berechtigungen hinzufügen aus.

   

   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 des Anwendungs-ID-URI

1. Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.

2. Wählen Sie neben Anwendungs-ID-URIdie Option Hinzufügen aus.

   

3. Aktualisieren Sie den Anwendungs-ID-URI im api://your-devtunnel-domain/botid-{AppID} Format oder api://your-ngrok-domain/botid-{AppID} , und wählen Sie Speichern aus.

   

   Die folgende Abbildung zeigt den Domänennamen:

   

Hinzufügen eines Bereichs

1. Wählen Sie im linken Bereich unter Verwalten die Option API verfügbar machen aus.

2. Wählen Sie + Bereich hinzufügen aus.

   

3. Geben Sie access_as_user als Bereichsnamen ein.

4. Wählen Sie unter Wer kann zustimmen?die Option Administratoren und Benutzer aus.

5. 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.

6. Stellen Sie sicher, Zustand auf Aktiviert festgelegt ist.

7. 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_user am Ende angefügt ist.

   

Hinzufügen einer Clientanwendung

1. 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.

2. Wählen Sie + Clientanwendung hinzufügen aus.

   

3. Fügen Sie Teams mobile oder Desktop- und Teams-Webanwendung hinzu.

   1. Für Teams Mobile oder Desktop: Geben Sie die Client-ID als ein 1fec8e78-bce4-4aaf-ab1b-5451cc387264.

      

   2. Für Teams-Web: Geben Sie die Client-ID als ein 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

      

4. Aktivieren Sie das Kontrollkästchen Autorisierte Bereiche .

5. Wählen Sie Anwendung hinzufügen aus.

   

   Die folgende Abbildung zeigt die Client-ID:

   

Erstellen Ihres Bots

• 5 Minuten verbleibend

Erstellen einer Azure-Botressource

1. Wechseln Sie zu Startseite.

2. Wählen Sie + Ressource erstellen aus.

3. Geben Sie in das Suchfeld Azure Bot ein.

4. Drücken Sie die EINGABETASTE.

5. Wählen Sie Azure Bot aus.

6. Wählen Sie Erstellen aus.

   

7. Geben Sie den Botnamen im Bothandle ein.

8. Wählen Sie Ihr Abonnement aus der Dropdownliste aus.

9. Wählen Sie Ihre Ressourcengruppe aus der Dropdownliste aus.

   

   Wenn Sie nicht über eine vorhandene Ressourcengruppe verfügen, können Sie eine neue Ressourcengruppe erstellen. Führen Sie die folgenden Schritte aus, um eine neue Ressourcengruppe zu erstellen:

   1. Wählen Sie Neu erstellen aus.
   2. Geben Sie den Ressourcennamen ein, und wählen Sie OK aus.
   3. Wählen Sie in der Dropdownliste Neuer Ressourcengruppenstandort einen Standort aus.

   

10. Wählen Sie unter Preise die Option Plan ändern aus.

    

11. Wählen Sie FO Free>Select aus.

    

12. Wählen Sie unter Microsoft App-IDdie Option App-Typ als mehrinstanzenfähig aus.

13. Wählen Sie unter Erstellungstyp die Option Vorhandene App-Registrierung verwenden aus.

14. Geben Sie die App-ID ein.

    Hinweis

    Sie können nicht mehr als einen Bot mit derselben Microsoft-App-ID erstellen.

15. Wählen Sie Überprüfen + erstellen aus.

    

16. Nachdem die Überprüfung erfolgreich war, wählen Sie Erstellen aus.

    Die Bereitstellung des Bots dauert einige Minuten.

17. Wählen Sie Zu Ressource wechseln aus.

    

    Sie haben Ihren Azure-Bot erfolgreich erstellt.

    

Hinzufügen eines Teams-Kanals

1. Wählen Sie im linken Bereich Kanäle aus.

2. Wählen Sie unter Verfügbare Kanäledie Option Microsoft Teams aus.

   

3. Aktivieren Sie das Kontrollkästchen, um die Nutzungsbedingungen zu akzeptieren.

4. Wählen Sie Zustimmen aus.

   

5. Wählen Sie Anwenden aus.

   

So fügen Sie einen Messagingendpunkt hinzu

Hinzufügen von OAuth-Verbindungseinstellungen

1. Wählen Sie im linken Bereich Konfiguration aus.

2. Wählen Sie OAuth-Verbindungseinstellungen hinzufügen aus.

3. Aktualisieren Sie unter Neue Verbindungseinstellung die folgenden Details:

   • Name: Geben Sie einen Namen für Ihre neue Verbindungseinstellung ein. Sie können den Namen in den Einstellungen Ihres Botdienstcodes verwenden.
   • Dienstanbieter: Wählen Sie in der Dropdownliste Azure Active Directory v2 aus.
   • Client-ID: Aktualisieren Sie Ihre Microsoft-App-ID.
   • Geheimer Clientschlüssel: Aktualisieren Sie den Wert der geheimen Clientschlüssel.
   • Tokenaustausch-URL: Aktualisieren Sie den Anwendungs-ID-URI.
   • Mandanten-ID: Geben Sie Allgemein ein.
   • Bereiche: Geben Sie User.Read ein.

4. Klicken Sie auf Speichern.

   

Einrichten von App-Einstellungen und Manifestdateien

• 4 Minuten verbleibend

1. Wechseln Sie zur appsettings.json-Datei im geklonten Repository.

   

2. Öffnen Sie die appsettings.json-Datei , und aktualisieren Sie die folgenden Informationen:

   • Legen Sie auf MultiTenant fest"MicrosoftAppType".
   • Legen Sie "MicrosoftAppId" auf die Microsoft-App-ID Ihres Bots fest.
   • Legen Sie "MicrosoftAppPassword" auf den Wert der geheimen Clientschlüssel Ihres Bots fest.
   • Legen Sie für den MultiTenant-Bot als leer fest "MicrosoftAppTenantId" .

   

3. Wechseln Sie zur manifest.json-Datei im geklonten Repository.

   

4. Öffnen Sie die manifest.json Datei.

5. Fügen Sie der Manifestdatei den folgenden Codeausschnitt hinzu, falls noch nicht vorhanden:

   "bots": [
    {
      "botId": "<<YOUR-MICROSOFT-APP-ID>>",
      "scopes": [
        "personal",
        "team",
        "groupchat"
      ],
      "supportsFiles": false,
      "isNotificationOnly": false
    }      
   

6. Ersetzen Sie alle Vorkommen von <<YOUR-MICROSOFT-APP-ID>> durch die Microsoft App-ID Ihres Bots.

   

Erstellen und Ausführen des Diensts

• 3 Minuten verbleibend

Verwenden Sie zum Erstellen und Ausführen des Diensts die neueste Version von Visual Studio oder die Befehlszeile.

dotnet run

App "Link unfurling" hochladen

• 2 Minuten verbleibend

1. Navigieren Sie in Ihrem geklonten Repository zu beispiele>msgext-link-unfurling>csharp>TeamsAppManifest.

2. Erstellen Sie eine .zip-Datei mit den folgenden Dateien, die im Manifestordner vorhanden sind:

   • manifest.json

   • icon-outline.png

   • icon-color.png

     

3. Wählen Sie im Teams-Client das Symbol Apps aus.

4. Wählen Sie Verwalten Ihrer Apps aus.

5. Wählen Sie App hochladen aus.

6. Suchen Sie nach der Option Hochladen einer benutzerdefinierten App. Wenn die Option angezeigt wird, ist der benutzerdefinierte App-Upload aktiviert.

   

7. Wählen Sie die .zip Datei aus, die Sie im Ordner TeamsAppManifest erstellt haben, und wählen Sie Öffnen aus.

   

8. Klicken Sie auf Hinzufügen.

   

9. Geben Sie im Bereich Nachricht verfassen den Text ein https://www.BotFramework.com.

   Der Link wird wie in der folgenden Abbildung dargestellt entpackt:

   

10. Wählen Sie Senden aus.

    

Abschließen der Herausforderung

• 1 Minuten verbleibend

Haben Sie sich so etwas einfallen lassen?

Herzlichen Glückwunsch!

• 100 % abgeschlossen!

Sie haben das Tutorial für die ersten Schritte mit der App zum Entpacken von Teams-Links abgeschlossen!