Du kannst Deine Multichannel-Beiträge aus dem Studio an Microsoft Teams senden. Nutzer sehen den Beitrags-Teaser in Teams und können einfach auf einen Button klicken, um den vollständigen Beitrag in der Timeline zu öffnen.

Um den Kommunikationskanal zu Microsoft Teams einzurichten, musst Du eine Entra ID-App und eine Teams-App gemäß den folgenden Schritten konfigurieren. Beide Apps sind erforderlich.

Dieser Artikel betrifft die Erstellung einer Microsoft Teams-Integration für das Modul Multichannel-Kommunikation. Informationen zur Microsoft Teams-Integration des Modern Intranet-Moduls findest Du unter Microsoft Teams-Integration einrichten (Intranet - Public Cloud). Du kannst dieselbe Teams-App nicht für Multichannel und Intranet verwenden; es müssen unterschiedliche Apps sein.

Ein App-Registrierung in Microsoft einrichten

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

Eine app erstellen

1. Melde Dich bei der Microsoft Azure-Plattform an
2. Gehe zu Microsoft Entra ID > App-Registrierungen > Neue Registrierung
3. Vergebe einen Namen für Deine App, z.B. Haiilo
4. Wähle einen Unterstützten Kontotyp
5. Wähle Registrieren
6. Kopiere und speichere auf der App-Übersichts-seite die Anwendungs-(Client) ID und die Verzeichnis-(Mandanten) ID für die spätere Verwendung

Ein Clientschlüssel erstellen und API-Berechtigungen definieren

1. Client Secret erstellen
   1. Gehe zu Zertifikate & Geheimnisse > Geheime Clientschlüssel
   2. Wähle Neue geheimer Clientschlüssel
   3. Gib eine Beschreibung ein und wähle aus, wann das Secret abläuft.
      • Nach Ablauf eines Secrets musst Du ein neues Secret generieren und es in Haiilo aktualisieren, damit die Verbindung gültig bleibt. Wir empfehlen, eine Erinnerung einzurichten, um das Secret vor Ablauf zu erneuern.
   4. Wähle Hinzufügen
   5. Kopiere den Wert des Secrets für die spätere Verwendung
2. API-Berechtigungen definieren
   1. Gehe zu API-Berechtigungen
   2. Wähle Berechtigung hinzufügen > Microsoft Graph > Anwendungsberechtigungen
   3. Füge die folgenden API-Berechtigungen hinzu:
      • TeamsAppInstallation.ReadWriteSelfForUser.All
      • AppCatalog.Read.All
      • User.Read.All
   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.

Ein Teams-App einrichten

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

1. Melde Dich im Developer Portal in Microsoft Teams an
2. Wähle Apps > Neue App
3. Gib einen Namen für die App ein
4. Wähle Hinzufügen
5. Passe in Grundlegende Informationen mindestens die folgenden Felder an:
   
   • Kurz- und Langbeschreibung: Gib eine Beschreibung der App und ihrer Funktionen ein
   • Entwicklerinformationen: Hier sollte Haiilo als Entwickler angegeben sein.
     • Gib unter Entwickler- oder Firmenname Haiilo GmbH ein
     • Gib unter Website https://www.haiilo.com/ ein
   • Datenschutzrichtlinie: Gib eine URL zu Deiner Datenschutzrichtlinie ein
   • Nutzungsbedingungen: Gib eine URL zu Deinen Nutzungsbedingungen ein
   • Anwendungsclient-ID: Gib die Anwendungsclient-ID ein, die Du zuvor von Microsoft Entra ID kopiert hast. Dies ist für die Authentifizierung auf der Seite von MS Teams erforderlich.
6. Wechsle zu Branding und passe das Farbsymbol, das Umriss-Symbol und die Akzentfarbe an, um zum Branding Deiner Plattform zu passen.
7. Kopiere die App-ID von MS Teams für spätere Verwendung.
8. Aktiviere die Bot-Funktion
   1. Wähle App-Funktionen > Bot
   2. Gib im Feld Bot-ID eingeben die Bot ID ein, die in der Administration von Haiilo unter Multichannel zu finden ist.
   3. Wähle Nur Benachrichtigungen senden (Einweg-Konversationen)
   4. Wähle Persönlich als den Bereich
   5. Wähle Speichern
      
9. Füge die Domain hinzu
   1. Gehe zu Domains > Erstelle Deine erste Domain
   2. Füge die Domain Deiner Haiilo-Plattform hinzu, für die diese App verwendet wird, z.B. subdomain.haiilo.app
   3. Wähle Speichern
10. 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.

Den Teams-Kanal in Haiilo einrichten

Du benötigst die Berechtigung "Multichannel Administration", um die Multichannel-Einstellungen in Haiilo zu konfigurieren.

1. Gehe in Haiilo zu Administration > Multichannel
2. Aktiviere Microsoft Teams
3. Gib die Anwendungs-(Client) ID ein, die du von Microsoft Entra ID kopiert hast, in das Feld Client ID ein
4. Gib den Clientschlüssel ein, den du von Microsoft Entra ID kopiert hast, in das Feld Client Secret ein
5. Gib die Verzeichnis-(Tenant) ID ein, die du von Microsoft Entra ID kopiert hast, in das Feld Tenant ID ein
6. Gib die App ID ein, die du von Microsoft Teams kopiert hast, in das Feld App ID ein
7. Wähle Änderungen für Microsoft Teams speichern