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 nur 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 in einem Browser zur Haiilo-Plattform 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 "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 die folgenden API-Berechtigungen hinzu oder überprüfe, ob sie bereits hinzugefügt sind:
     • TeamsAppInstallation.ReadWriteSelfForUser.All
     • AppCatalog.Read.All
     • User.Read.All
  4. Wähle Admin-Einwilligung für app_name erteilen 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
     • Admin-Einwilligungsanzeigename: access_as_user
     • Admin-Einwilligungsbeschreibung: 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. Erstelle einen MS Teams Bot

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

1. Melde dich im Entwicklerportal in Microsoft Teams an.
2. Gehe zu Tools > Bot-Verwaltung < Neuer Bot.
3. Gib deinem Bot einen Namen, z.B. "Haiilo-Benachrichtigungen".
4. Wähle Erstellen aus.
5. Füge eine Endpunktadresse hinzu. Der Anfang der Endpunktadresse besteht aus deiner Haiilo-Plattform-URL gefolgt von /web/content-teams-bot/api/messages. Zum Beispiel, https://beispiel.haiilo.app/web/content-teams-bot/api/messages
6. Gehe zu Client Secrets und wähle Einen Client Secret für deinen Bot hinzufügen.
7. Kopiere den Client Secret und die Bot-ID und teile sie mit Haiilo, indem du ein Ticket in unserem Service Desk öffnest. Wir passen den Bot für dich an.
8. Sobald du vom Service Desk gehört hast, dass der Bot angepasst ist, kannst du mit den nächsten Schritten fortfahren.

3. Lade Haiilos Teams-App-Manifest herunter

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

1. Gehe in Haiilo 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 erledigen, 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.
   • 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.

4. Importiere die Teams-App

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

1. Melde dich im Entwicklerportal in Microsoft Teams an.
2. Gehe zu Apps > App importieren und wähle das kürzlich heruntergeladene Manifest aus.

3. Haiilo füllt die App-Informationen basierend auf Informationen von deiner Haiilo-Plattform, deinem Microsoft-Authentifizierungsanbieter und deinem benutzerdefinierten Bot 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 Haiilo-Authentifizierungsanbieter und sind notwendig, damit die App korrekt funktioniert.

     • Anwendungs (Client) ID
     • App Funktionen
     • Domänen
     • 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 ⬇️