Multichannel Communication: MS Teams Integration

Die Multichannel Communication kann auch über MS Teams genutzt werden. Wie das integriert wird, erfahrt ihr hier.

Microsoft Graph API

Für jede Haiilo-Cloud ist eine Microsoft Azure-App mit Zugriff auf den betroffenen Microsoft-Mandanten (Organisation) erforderlich.

Die folgenden Scopes (vom Typ Application) werden benötigt.

  • TeamsAppInstallation.ReadWriteSelfForUser.All
  • AppCatalog.Read.All
  • Benutzer.Lesen.Alle

Die folgenden Client-Anmeldedaten/Informationen sind erforderlich und müssen über den Multichannel Adminbereich bereitgestellt werden.

  • tenant id

  • client id

  • client secret

Bildschirm_foto_2023-02-01_um_14.25.12.png

Teams App

Für jede Haiilo-Cloud ist eine Microsoft Teams-App erforderlich. Zusätzlich ist es empfehlenswert, die Azure App ebenfalls der Teams App zuzuordnen.

Die folgenden Informationen sind erforderlich und müssen über den Adminbereich von Multichannel in Haiilo eingegeben werden.

  • app idBildschirm_foto_2023-02-01_um_14.25.06.png

Setup / Konfiguration

Azure App

Wie bereits im Abschnitt , müssen die folgenden Schritte durchgeführt werden.

  1. Login mit Admin-Konto in

  2. Erstelle eine neue App

    1. Gehe zur App Registrierungazure_app_01.png

    2. Klicke auf neue Registrierung

      1. Definiere einen Namen

      2. Wähle einen unterstützten Kontoyp

      3. Klicke auf Registrierenazure_app_02.png

  3. Konfiguriere die Berechtigungen

    1. Gehe zur App Registrierung

    2. Suche die App (durch den Namen)

    3. Öffne die Appazure_app_03.png

    4. Gehe zu den API Berechtigungen und füge die nachfolgenden hinzu:

      1. TeamsAppInstallation.ReadWriteSelfForUser.All

      2. AppCatalog.Read.All

      3. User.Read.All

      4. Klicken Sie auf Klicken Sie auf die Verwaltungs Zustimmung für alle Berechtigungen

      5. Klicke auf "Ja"azure_app_04.png

  4. Erstelle einen Client Secret

    1. Gehe zu Zertifikate & Geheimnisse

    2. Klicke auf "neuen Client Secret"

    3. Definiere einen Namen und ein Ablaufdatum

    4. Klicke "Hinzufügen"azure_app_05.png

Teams App (Setup Konfiguration)

Es muss eine Teams-App mit folgenden Schritten eingerichtet werden.

  1. Login zu

  2. Erstelle eine Teams App

    1. Klicke auf Apps (Menü links)
      teams_app_setup_01.png

    2. Klicke auf Neue App

    3. Definiere einen Namenteams_app_setup_02.png

    4. Klicke Hinzufügen an

  3. Konfiguriere Teams App Basic Informationen

    1. Klicke auf Apps (Menü links)

    2. Wähle eine erstelle App

    3. Klicke Konfiguriere → Basic Informationen

    4. Fülle die Developer Informationen austeams_app_setup_03.png

    5. Fülle die App URLs

    6. Füge Azure App (vorheriger Schritt) Client ID hinzu

  4. Bot-Funktion aktivieren

    1. Klicke auf Apps (Menü links)

    2. Wähle erstellte App aus

    3. Klicke Konfiguriere → App Funktionenteams_app_setup_04.png

    4. Klicke auf Bot

    5. Wählen Sie Identifizieren Sie Ihren Bot → Gebe die Bot-ID einteams_app_setup_05.png

      1. Füge die Bot ID aus dem Bereich Multichannel der Haiilo Administration ein Bildschirm_foto_2023-02-01_um_14.28.10.png

    6. Wähle optional "Nur Benachrichtigungen senden (einseitige Konversationen)" im Abschnitt "Was kann Ihr Bot?
       Es wird empfohlen, die Funktion zum Beantworten von Nachrichten zu deaktivieren, da von   einem Benutzer gesendete Antworten nicht erfasst und nicht verarbeitet werden. Aktivierte   Antworten könnten den Benutzer zu der Annahme verleiten, dass die Antwort den Autor   oder jemanden aus dem internen Kommunikationsteam erreicht hat.

    7. Wählen Sie "Persönlich" im Abschnitt "Auswahl der Bereiche, in denen Personen diesen Befehl verwenden können".

    8. Klicke auf Speichern

  5. Veröffentliche die App

    1. Klicke auf Apps (Menü links)

    2. Wähle eine erstellte App

    3. Klicke auf Veröffentlichen → In Organisation veröffentlichenteams_app_setup_06.png

Teams App (Genehmigung)

Eine Team-App muss in den folgenden Schritten genehmigt werden.

  1. Login zu https://admin.teams.microsoft.com/

    1. Klicke auf Teams Apps → Verwaltete Apps (Menü links)teams_app_approval_01.png

    2. Suche die App über den Namen

    3. Wähle die App austeams_app_approval_02.png

    4. Klicke auf Veröffentlichen → Veröffentlichenteams_app_approval_03.png

War dieser Beitrag hilfreich?