Microsoft Teams Integration einrichten (Intranet - Public Cloud)

Mit dem Haiilo Add-on für Microsoft kannst du deinen Nutzern erlauben, Benachrichtigungen über neue Blog Artikel erhalten und/oder die Startseiten deiner Plattform direkt in Microsoft Teams. Außerdem können Nutzer Chats und Anrufe in Teams direkt von Haiilo aus starten.

Die Einrichtungsanweisungen für die Microsoft Teams-Integration kannst du in diesem Artikel nachlesen. Welche Anweisungen du befolgen solltest, hängt davon ab, welche der oben genannten Funktionalitäten du nutzen möchtest.

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.

Integrierte Startseiten und Benachrichtigungen über neue Blog Artikel

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

  • Um sowohl Haiilo-Startseiten anzuzeigen als auch Benachrichtigungen über neue Blog Artikel zu erhalten in Microsoft Teams anzuzeigen, musst du die folgenden Schritte sowohl in Microsoft Entra ID und Microsoft Teams durchführen.

    Konfiguriere die Microsoft Entra ID App

    1. Anmelden bei der Microsoft Azure Plattform.
    2. Gehe zu Microsoft Entra ID > App-Registrierungen > wähle die App aus, die du beim Einrichten der Microsoft Authentifizierung und Add-on für Haiilo
    3. Aktualisiere das Manifest
      1. Gehe zu Manifest
      2. Ändere das Attribut für "accessTokenAcceptedVersion" auf 2. Der Standardwert ist null in einigen Versionen, und dieser muss 2 sein.
    4. API-Berechtigungen definieren
      1. Gehe zu API-Berechtigungen > Berechtigung hinzufügen
      2. Wähle Microsoft Graph  > Delegierte Berechtigungen
      3. Überprüfe, ob die folgenden Berechtigungen eingerichtet sind:
        • email
        • offline_access
        • openid
        • profile
        • 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 für markiert ist.
    5. Einen Bereich hinzufügen
      1. Gehe zu API freigeben > Bereich hinzufügen
      2. Füge im Feld Anwendungs-ID-URI deine Haiilo-Plattform und die Microsoft-Anwendungs-ID in diesem Format ein:
        • api://deine_haiilo-domain/applicationId . Beispiel: api://example.haiilo.app/e7d2fcb0-4c19-43a8-8ccc-2605be203fac
      3. Wähle Speichern und weiter.
      4. Wenn die Anwendungs-ID-URI erfolgreich aktualisiert wurde, erscheint ein weiteres Pop-up-Fenster erscheinen. Fülle die Felder wie folgt aus:
        • Bereichsname: access_as_user
        • Wer kann zustimmen: Nur Admins
        • Admin-Zustimmung Anzeigename: access_as_user
        • Beschreibung der Admin-Einwilligung: access_as_user
        • Status: Aktiviert
      5. Wähle Zusatzbereich 
      6. Bestätige, dass die neue Anwendungs-ID-URI hinzugefügt wird (diese URl wird immer erstellt als api://deine_haiilo-domain/applicationId).
    6. Füge eine Client-Anwendung hinzu
      1. Wähle im gleichen Abschnitt wie oben (API freigeben) Eine Client-Anwendung hinzufügen.
      2. Füge diese beiden Client IDs nacheinander hinzu:
        • Für die mobile und die Desktop MS Teams App: 1fec8e78-bce4-4aaf-ab1b-5451cc387264
        • Für die Browser-MS-Teams-App: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
      3. Aktiviere das Kontrollkästchen, um die Client-ID für den Bereich zu autorisieren. den du oben erstellt hast.
      4. Wähle Anwendung hinzufügen
      5. Wiederhole den Vorgang einmal für die andere Kunden-ID. Beide sind erforderlich.

    Eine eigene App für Microsoft Teams erstellen

    1. Lade die Anwendungspaket am Ende dieses Artikels herunter.
    2. Melde dich auf der Seite Developer Portal in Microsoft Teams
    3. Gehe zu Apps > App importieren und wähle die kürzlich heruntergeladene App aus. Wenn du gefragt wirst, ob du die App ersetzen oder duplizieren willst, wähle Ersetzen.Screenshot 2023-12-15 um 14.48.41.png
    4. Passe unter Basisinformationen mindestens die folgenden Felder an:
      • Kurzer Name: Gib deiner App einen Namen, der der für deine Nutzer erkennbar ist
      • Kurz- und Langbeschreibung: Gib eine Beschreibung der App und was sie tut
      • Version: Setze sie von Anfang an auf 1.0.0.
      • Entwicklerinformationen: Dies sollte auf Haiilo als Entwickler angeben.
        • In Entwickler- oder Firmenname, gib ein Haiilo GmbH
        • In Website, gib https://www.haiilo.com/ ein.
      • Datenschutzrichtlinie: Gib eine URL ein, die zu deiner Datenschutzrichtlinie
      • Nutzungsbedingungen: Gib eine URL ein, die zu deinen Nutzungsbedingungen
      • Anwendungs-(Client-)ID: Gib die ID der deiner Microsoft Entra ID App ein, die du zuvor konfiguriert hast. Dies ist für die Authentifizierung auf der Seite von MS Teams erforderlich.
    5. Wähle Speichern.
    6. Gehe zu Branding und bearbeite das Farbsymbol, Umriss-Symbol und die Akzentfarbe um sie an das Branding deiner Plattform anzupassen.
    7. Gehe zu App Funktionen > Persönliche App
      1. Wähle auf der Registerkarte Home die drei Punkte > Bearbeiten
      2. Konfiguriere sie wie folgt:
        • Inhalts-URL: https://deine_haiilo_domain/web/teams/teams-tab
        • Website URL: https://deine_haiilo_domain
        • Geltungsbereich: personal
        • Kontext: personalTab
      3. auswählen. Bestätigen

      4. Wähle Speichern
      5. Außerdem kannst du unter App Funktionen, wenn du Haiilo's Private Cloud nutzt, einen eigenen Bot einrichten. Für die Public Cloud ist der Bot vorkonfiguriert und es sind keine Änderungen sind nicht notwendig.
    8. Gehe zu Single sign-on
      1. Gib die Anwendungs-URI-ID ein, die du zuvor konfiguriert hast in Microsoft Entra ID
      2. Wähle Speichern
    9. Gehe zu Domains
      1. Wähle Eine Domain hinzufügen
      2. Gib deine eigene Plattform ein, z.B. https://example.haiilo.app.
      3. Wähle Hinzufügen
      4. Überprüfe, ob die coyocloud.com Domain auch aufgeführt ist. Wenn nicht, füge sie hinzu. Das ist für Haiilo Public Cloud Kunden erforderlich Kunden erforderlich, damit der Bot funktioniert.
        • Wenn du ein Private Cloud Kunde bist, musst du die die Domain hinzufügen, die du für die Konfiguration des Bots verwendet hast. die du zuvor erstellt hast.
    10. Du kannst die Anwendung nun testen, indem du Vorschau in Teams und dann Hinzufügen die App in Teams.

    In der App kannst du zum Reiter Home navigieren, um deine Haiilo Startseite oder die Registerkarte Chat nutzen, um Anmelden, um über neue Blog Artikel informiert zu werden.

MS Teams homepage gif.gif

Nur Benachrichtigungen über neue Blog Artikel

Nutzer können Benachrichtigungen über neue Blog Artikel in einer Haiilo App auf Microsoft Teams. Sie sehen den Titel des Blogs, den Teasertext und das Bild und können Haiilo von Teams aus öffnen, um den ganzen Artikel zu lesen.

  • Um Benachrichtigungen über neue Blog Artikel in Microsoft Teams zu erhalten, musst du musst du die folgenden Schritte ausführen. Du kannst entweder die Standard Microsoft Teams App für Haiilo (die App trägt den Namen COYO) oder eine neue benutzerdefinierte App erstellen, um dein eigenes Branding und deine eigenen App-Informationen. Jeder Nutzer muss sich bei der App anmelden der App anmelden, um Benachrichtigungen zu erhalten.

    1. Entscheide, wie du deine App hinzufügen willst
      • Wenn du die Standard-App von Microsoft Teams verwenden möchtest, die COYO
        1. Füge die App in Teams unter Apps hinzu.
      • Wenn du eine benutzerdefinierte Microsoft Teams App verwenden möchtest
        1. Lade die Anwendungspaket am Ende dieses Artikels herunter.
        2. Melde dich auf der Seite Entwicklerportal in Microsoft Teams
        3. Gehe zu Apps > App importieren und wähle die kürzlich heruntergeladene App aus. Wenn du gefragt wirst gefragt wirst, ob du die App ersetzen oder duplizieren willst, wähle bitte Ersetzen.Screenshot 2023-12-15 um 14.48.41.png
        4. In Basisinformationen, passe mindestens die folgenden Felder an:
          • Kurzer Name: Gib deiner App einen Namen, der für deine Nutzer erkennbar ist.
          • Kurz- und Langbeschreibung: Beschreibe die App und was sie sie tut
          • Version: Setze sie auf 1.0.0. von dem Start
          • Entwicklerinformationen: Dies sollte auf Haiilo als Entwickler verweisen.
            • In Entwickler oder Firmenname, gib Haiilo GmbH ein
            • In Website, gib ein https://www.haiilo.com/
          • Datenschutzrichtlinie: Gib eine URL ein, die zu deiner Datenschutzrichtlinie führt.
          • Nutzungsbedingungen: Gib eine URL ein die zu deinen Nutzungsbedingungen führt
        5. Wähle Speichern.
        6. Gehe zu Branding und bearbeite das Farbsymbol, Umriss-Symbol, und Akzentfarbe, damit sie zum Branding deiner Plattform deiner Plattform anzupassen.
        7. Gehe zu Domains
          1. Bestätige, dass die coyocloud.com Domain ebenfalls aufgelistet ist. Wenn nicht, füge sie hinzu. Dies ist erforderlich für Haiilo Public Cloud Kunden, damit der Bot zu funktionieren.
        8. Du kannst die Anwendung jetzt testen, indem du Vorschau in Teams und dann Hinzufügen die Anwendung in Teams.
    2. Gib den Befehl Anmelden in das Nachrichtenfeld ein.
    3. Wähle Eintragen
    4. Gib die Domain deines Unternehmens in das vorgesehene Feld ein, z.B., Beispiel.haiilo.app
    5. Melde dich bei Haiilo an. Wenn du bereits in deinem Browser angemeldet bist, wird dies wird dies von Teams erkannt. Nachdem du dich angemeldet hast, wirst du zu Teams weitergeleitet. zurück zu Teams.

    Jedes Mal, wenn jetzt ein neuer Blog Artikel in einer Blog App einer Seite oder Community, die du abonniert hast, erhältst du eine Nachricht in Microsoft Teams. Die Nachricht enthält den Titel des Beitrags, einen Teasertext und ein Bild. Wähle Ganzen Artikel auf Haiilo lesen , um deine Haiilo-Plattform zu öffnen, um den ganzen Artikel zu lesen.

Blog Artikel Benachrichtigungen in Teams.png

Einen Microsoft Teams Chat von Haiilo aus starten

Nutzer mit der Berechtigung "Nachrichten über Microsoft Teams versenden" können einen Teams-Chat öffnen oder einen Kollegen direkt aus dessen Haiilo-Profil anrufen. Die Teams App wird geöffnet und der Nutzer kann das Gespräch beginnen.

  • Um das Starten eines Microsoft Teams Chats oder Anrufs von Haiilo aus zu ermöglichen, musst du musst du die Berechtigung "Nachrichten über Microsoft Teams versenden" für die Nutzer zuweisen, die diese Funktion nutzen können sollen. Außerdem müssen die Nutzer mit ihren eingeloggt sein und die Berechtigung "Microsoft 365 aktivieren" haben. 

    Nachdem die Nutzer die Berechtigungen erhalten haben, können sie einen Chat oder Anruf wie folgt starten:

    1. Gehe auf Haiilo zum Profil des Nutzers, den du kontaktieren möchtest.
    2. Wähle Chatten in Teams
    3. Wähle im Dropdown-Menü aus, ob du einen Chat, einen Audio-Anruf oder einen Videoanruf mit der Person starten möchtest.
    4. Die Microsoft Teams App öffnet einen Chat mit dem Nutzer oder fragt dich um zu bestätigen, dass du einen Anruf mit der Person starten willst.

Start a Teams chat gif.gif

Downloadbares App-Paket

War dieser Beitrag hilfreich?