Microsoft Teams Integration einrichten (Intranet - Private Cloud)

Mit Haiilos Microsoft-Add-On können Deine Nutzer einfach auf die Inhalte ihrer Plattform zugreifen, indem sie ihre Startseiten direkt in der Teams-App anzeigen. Außerdem erhalten Nutzer Benachrichtigungen über neue Blog Artikel. Sie sehen den Titel des Blogs, den Teasertext und das Bild und können Haiilo leicht von Teams aus öffnen, um den vollständigen Artikel zu lesen.

Um sowohl Haiilo-Startseiten anzuzeigen als auch Benachrichtigungen über neue Blog-Artikel in Microsoft Teams zu erhalten, musst Du Schritte sowohl in Microsoft Entra ID als auch in Microsoft Teams abschließen.

Die Microsoft-Authentifizierung und ein aktiviertes Microsoft-Add-On sind erforderlich, um die Integrationsfunktionen von Microsoft Teams zu nutzen. Bitte schließe die Einrichtung der Microsoft-Authentifizierung und die Aktivierung des Add-Ons ab, bevor Du mit diesen Anleitungen fortfährst.

Die Microsoft-App konfigurieren

Du benötigst Administratorrechte in Deinem Microsoft Entra ID-Konto, um die App zu konfigurieren.

Das Manifest aktualisieren und API-Berechtigungen definieren

  1. Melde Dich bei der Microsoft Azure-Plattform an.
  2. Gehe zu Microsoft Entra ID > App-Registrierungen > wähle die App aus, die Du erstellt hast, als Du die Microsoft-Authentifizierung und das Add-On für Haiilo eingerichtet hast.
  3. Aktualisiere das Manifest
    1. Gehe zu Manifest
    2. Passe das Attribut für "accessTokenAcceptedVersion" auf 2 an. Der Standardwert ist in einigen Versionen null, und dies muss auf 2 gesetzt werden.
  4. Definiere API-Berechtigungen
    1. Gehe zu API-Berechtigungen > Berechtigung hinzufügen
    2. Wähle Microsoft Graph > Delegierte Berechtigungen
    3. Überprüfe, ob die folgenden Berechtigungen eingerichtet sind:
      • E-Mail
      • offline_access
      • openid
      • Profil
      • User.Read
    4. Wähle Administratoreinwilligung erteilen für app_name für die hinzugefügten Berechtigungen und stelle sicher, dass der Status für alle Berechtigungen als Genehmigt für deinen_mandanten markiert ist.

Füge einen Bereich und eine Client-Anwendung hinzu

  1. Füge einen Bereich hinzu
    1. Gehe zu API freigeben > Bereich hinzufügen
    2. Füge in das Feld Anwendungs-ID-URI Deine Haiilo-Domain und die Microsoft-Anwendungs-ID in diesem Format hinzu:
      • api://deine_haiilo-domain/applicationId . Beispiel: api://beispiel.haiilo.app/e7d2fcb0-4c19-43a8-8ccc-2605be203fac
    3. Wähle Speichern und Fortfahren.
    4. Wenn das Anwendungs-ID-URI erfolgreich aktualisiert wurde, erscheint ein weiteres Pop-up. Fülle die Felder wie folgt aus:
      • Bereichsname: access_as_user
      • Wer kann zustimmen: Nur Admins
      • Anzeigename für Admin-Zustimmung: access_as_user
      • Beschreibung für Admin-Zustimmung: access_as_user
      • Status: Aktiviert
    5. Wähle Bereich hinzufügen 
    6. Bestätige, dass das neue Anwendungs-ID-URI hinzugefügt wurde (diese URL wird immer als api://deine_haiilo-domain/applicationId erstellt).
  2. Füge eine Client-Anwendung hinzu
    1. Wähle im gleichen Abschnitt wie oben (API freigeben) Eine Client-Anwendung hinzufügen.
    2. Füge beide diese Client-IDs nacheinander hinzu:
      • Für die mobile und Desktop MS Teams-App: 1fec8e78-bce4-4aaf-ab1b-5451cc387264
      • Für die Browser-MS Teams-App: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
    3. Wähle das Kontrollkästchen, um die Client-ID für den oben erstellten Bereich zu autorisieren
    4. Wähle Anwendung hinzufügen
    5. Wiederhole dies für die andere Client-ID. Beide sind erforderlich.

Eine benutzerdefinierte Teams-App erstellen

Du benötigst Administratorrechte in Deinem Microsoft Teams-Konto, um eine App zu erstellen.

Grundlegende Informationen und Branding definieren

  1. Lade das Anwendungspaket am Ende dieses Artikels herunter.
  2. Melde Dich im Entwicklerportal in Microsoft Teams an
  3. Gehe zu Funktionen > App importieren und wähle die kürzlich heruntergeladene App aus. Wenn Du gefragt wirst, ob Du die App ersetzen oder duplizieren möchtest, wähle bitte Ersetzen.Screenshot 2023-12-15 um 14.48.41.png
  4. Passe in Grundlegende Informationen mindestens die folgenden Felder an:
    • Kurzname: Gib Deiner App einen Namen, der für Deine Nutzer erkennbar ist
    • Kurze und Lange Beschreibung: Gib eine Beschreibung der App und was sie tut
    • Version: Setze sie von Anfang an auf 1.0.0.
    • Entwicklerinformationen: Hier sollte Dein Unternehmen als Entwickler genannt werden.
      • Gib unter Entwickler- oder Firmenname den rechtlichen Namen Deines Unternehmens ein
      • Gib unter Website die URL der Website Deines Unternehmens ein
    • Datenschutzrichtlinie: Gib eine URL ein, die zu Deiner Datenschutzrichtlinie führt
    • Nutzungsbedingungen: Gib eine URL ein, die zu Deinen Nutzungsbedingungen führt
    • Anwendungs (Client-) ID: Gib die ID Deiner zuvor konfigurierten Microsoft Entra ID-App ein. Diese wird für die Authentifizierung auf der Seite von MS Teams benötigt.
  5. Wähle Speichern.
  6. Gehe zu Branding und bearbeite das Farbsymbol, das Umriss-Symbol und die Akzentfarbe, um sie an das Branding Deiner Plattform anzupassen.

Definiere App Funktionen

  1. Aktiviere die Funktion Startseiten
    1. Gehe zu App Funktionen > Persönliche App
    2. Für den Tab Start wähle die drei Punkte > Bearbeiten
    3. Konfiguriere es wie folgt:
      • Inhalts-URL: https://deine_haiilo_domain/web/teams/teams-tab
      • Website-URL: https://deine_haiilo_domain
      • Bereich: persönlich
      • Kontext: personalTab
    4. Wähle Bestätigen

    5. Wähle Speichern
  2. Aktiviere die Benachrichtigungsfunktion für Blogs
    1. Gehe zu App Funktionen > Bot
    2. Wähle Erstelle einen neuen Bot > Neuer Bot. Du kannst den Standard Haiilo-Bot nicht in der Private Cloud verwenden.
    3. Gib deinem Bot einen Namen
    4. Gib in Konfigurieren die Endpunktadresse ein. Der Anfang der Endpunktadresse besteht aus deiner Haiilo-Plattform-URL gefolgt von /web/teams/api/messages. Zum Beispiel, https://beispiel.haiilo.app/web/teams/api/messages
    5. Wähle in Client Secrets Füge ein Client Secret für deinen Bot hinzu. Kopiere den geheimen Wert für die spätere Verwendung.
    6. Gehe zurück zu deiner Teams-App > App Funktionen > Bot
    7. Wähle deinen neu erstellten Bot unter Wähle einen vorhandenen Bot aus
    8. Wähle Persönlich als Bereich
    9. Wähle Füge einen Befehl hinzu und füge die folgenden Befehle mit Persönlich als Bereich hinzu:
      • Sign In
      • Sign Out
    10. Wähle Speichern

Privater Cloud-Bot in MS Teams-App.png

Teams-App abschließen

  1. Gehe zu Single sign-on
    1. Gib die Anwendungs-URI-ID ein, die Du früher konfiguriert hast in Microsoft Entra ID
    2. Wähle Speichern
  2. Gehe zu Domains
    1. Wähle Eine Domain hinzufügen
    2. Gib Deine eigene Domain ein, z.B., https://example.haiilo.app
    3. Wähle Hinzufügen
    4. Bestätige, dass die Domain coyocloud.com ebenfalls aufgeführt ist. Wenn nicht, füge sie hinzu. Dies ist erforderlich für Haiilo Public Cloud-Kunden, damit der Bot funktioniert.
      • Wenn Du ein Private Cloud-Kunde bist, musst Du die Domain hinzufügen, die Du verwendet hast, um den Bot zu konfigurieren, den Du zuvor erstellt hast.
  3. Du kannst die Anwendung jetzt testen, indem Du Vorschau in Teams auswählst und dann die App in Teams hinzufügst. Wenn die App wie erwartet funktioniert, kannst Du sie gemäß den Richtlinien Deines Unternehmens veröffentlichen.

In der App kannst Du zum Start-Tab navigieren, um Deine Haiilo Startseite anzuzeigen oder den Chat-Tab verwenden, um Dich anzumelden und über neue Blog Artikel informiert zu werden.

Teams homepages and blog notifications.png

War dieser Beitrag hilfreich?