Wir haben eine neue MS Teams-App! Die Anweisungen in diesem Artikel gelten für die Konfiguration der neuen MS Teams-App. Wenn du deine alte App konfigurierst, sieh dir bitte den Legacy-Microsoft Teams-Einrichtungsartikel an, um Unterstützung bei deiner Konfiguration zu erhalten: Einrichten einer Microsoft Teams-Integration (Legacy).

Möchtest du von einer alten zur neuen App wechseln? Lies unsere empfohlenen Schritte für einen erfolgreichen Übergang in diesem Artikel.

Benutzer können ganz einfach ihre Haiilo-Plattform und deren Inhalte direkt in MS Teams erkunden! Du hast die Möglichkeit, ihnen das volle Erlebnis innerhalb von Teams zu bieten oder nur einen Blick auf deine Startseiten zu ermöglichen. Wenn du das volle Erlebnis wählst, können Benutzer alles direkt in Teams sehen und damit interagieren. Entscheidest du dich für die Ansicht der Startseiten, können sie immer noch Inhalte liken und kommentieren, aber ein Klick auf einen Link öffnet die Haiilo-Plattform in einem neuen Browser-Tab.

Zusätzlich erhalten Benutzer Benachrichtigungen über neue Blog-Beiträge und Studio-Beiträge. Sie sehen den Beitragstitel, einen kleinen Teaser und ein Bild. Wenn sie auf den Beitrag klicken, werden sie zur Haiilo-Plattform in einem Browser weitergeleitet, um den vollständigen Artikel zu lesen. Wenn neue Beiträge verfügbar sind, wird in der App in Teams eine Zahl angezeigt, die dich darauf hinweist, die Benachrichtigungen zu überprüfen.

Um die Funktionalitäten der Microsoft Teams-Integration zu nutzen, musst du zuerst einen OpenID-Authentifizierungsanbieter einrichten und das Microsoft-Add-On aktivieren. Bitte schließe die Microsoft-Authentifizierungseinrichtung und die Add-On-Aktivierung ab, bevor du mit diesen Einrichtungsanweisungen fortfährst.

1. Aktualisiere deine Entra ID-App

Du benötigst Administratorrechte in deinem Microsoft Entra ID-Konto, um diese Schritte abzuschließen.

1. Melde dich beim Microsoft Azure-Portal 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.

• 1. Gehe zu Manifest.
  2. Setze das Attribut für "requestedAccessTokenVersion" auf 2. In einigen Versionen ist der Standardwert null und sollte auf 2 gesetzt werden.
• 1. Gehe zu API-Berechtigungen.
  2. Berechtigungen hinzufügen > Microsoft Graph > Anwendungsrechte.
  3. Füge hinzu oder stelle sicher, dass die folgenden API-Berechtigungen hinzugefügt sind:
     • TeamsAppInstallation.ReadWriteSelfForUser.All
     • AppCatalog.Read.All
     • User.Read.All
  4. Wähle Admin-Einwilligung für app_name für die hinzugefügten Berechtigungen und stelle sicher, dass der Status für alle Berechtigungen als Erteilt für deinen_mandanten markiert ist.
• 1. Gehe zu API veröffentlichen > Bereich hinzufügen
  2. Im Feld Anwendungs-ID-URI füge deine Plattform-Domain und die Microsoft-Anwendungs-ID in diesem Format hinzu:
     • api://deine_plattform-domain/applicationId . Beispiel: api://example.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-Einwilligung: access_as_user
     • Beschreibung für Admin-Einwilligung: 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_plattform-domain/applicationId erstellt).
• 1. Wähle im gleichen Abschnitt wie oben (API veröffentlichen) Eine Client-Anwendung hinzufügen.
  2. Füge beide diese Client-IDs nacheinander hinzu:
     • 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (Für die mobile und Desktop MS Teams App)
     • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (Für die Browser MS Teams App)
  3. Wähle das Kontrollkästchen, um die Client-ID für den von dir erstellten Bereich zu autorisieren
  4. Wähle Anwendung hinzufügen
  5. Wiederhole dies für die andere Client-ID. Beide sind erforderlich.

Fahre mit den nächsten Schritten fort.

2. Lade das Teams-App-Manifest von Haiilo herunter

Du benötigst die Berechtigung "Integrationen verwalten", um diese Schritte abzuschließen.

1. In Haiilo gehst du zu Administration > Integrationen > MS Teams.
2. Aktiviere die MS Teams-Einstellungen.
3. Scrolle nach unten und finde deinen Haiilo-Authentifizierungsanbieter, der mit deiner Entra ID-App übereinstimmt. Wenn du mehrere Authentifizierungsanbieter hast, musst du die Teams-App für jeden separat einrichten.
4. Wähle Herunterladen neben dem Authentifizierungsanbieter aus, um das Manifest herunterzuladen.
5. Unter   , aktiviere die MS Teams-App. Du kannst dies auch später tun, aber wir empfehlen, es jetzt zu tun, damit du es nicht vergisst. Dadurch wird sichergestellt, dass deine Teams-App aktiv ist, sobald sie veröffentlicht wird.
6. Wähle das Plattformerlebnis für deine Teams-App(s) aus. Alle deine Apps werden dieselbe Ansicht verwenden. Du kannst die Ansicht später ändern, und sie wird sich auf bereits installierte MS Teams-Apps auswirken:
   • Haiilo gesamt: Deine Benutzer können das gesamte Haiilo-Plattform innerhalb der Teams-App erleben. Derzeit ist der Zugriff auf die Administration oder die Verwendung/Anzeige anderer Microsoft-Integrationsfunktionen ausgeschlossen.
   • Nur Homepages: Deine Benutzer können nur die Startseiten innerhalb der Teams-App anzeigen. Sie können Beiträge auf der Timeline liken und kommentieren, aber die Auswahl eines anderen Elements öffnet die Plattform in einem Browser.
7. Fahre mit den nächsten Schritten fort.

Aus technischen Gründen im Zusammenhang damit, wie Microsoft Teams derzeit externe Integrationen behandelt, wird die Haiilo-Integration als iFrame eingebettet. Diese architektonische Einschränkung kann gelegentlich das Haiilo-Plattformerlebnis innerhalb von Teams beeinträchtigen. Dadurch können bestimmte Bereiche und Funktionen möglicherweise nicht genau so erscheinen oder funktionieren wie in der vollständigen Browser-Version von Haiilo.

3. Importiere die Teams-App

Du benötigst Administratorrechte in deinem Microsoft Teams Developer Portal, um diese Schritte abzuschließen.

1. Melde dich im Developer Portal in Microsoft Teams an.
2. Gehe zu Apps > App importieren und wähle das kürzlich heruntergeladene Manifest (.zip-Datei) aus.

3. Haiilo füllt die App-Informationen basierend auf Informationen von deiner Haiilo-Plattform und deinem Microsoft-Authentifizierungsanbieter vor. Du kannst einige Informationen optional bearbeiten, einschließlich des App-Namens, der Beschreibung, des Brandings usw., um die App für deine Organisation anzupassen.

   • Bitte ändere nicht die folgenden Einstellungen. Sie sind vorkonfiguriert basierend auf deiner Microsoft-App und deinem Haiilo-Authentifizierungsanbieter und sind notwendig, damit die App korrekt funktioniert.

     • Anwendungs (Client) ID
     • App Funktionen
     • Domains
     • Single Sign-On
4. Nachdem du die App konfiguriert hast, kannst du sie testen, indem du Vorschau in Teams auswählst und dann die App zu Teams hinzufügst.
5. Wenn die App wie erwartet funktioniert, kannst du sie gemäß den Richtlinien deines Unternehmens an deine Organisation veröffentlichen.

Sobald veröffentlicht, können deine Benutzer die App in MS Teams öffnen!

Nur Homepages-Erfahrung ⬇️

Haiilo gesamt-Erfahrung ⬇️

Neue Blog- und Studio-Benachrichtigungen ⬇️