Just Social in eurem Microsoft (MS) Teams

Ihr könnt unsere Anwendung auch in euer Microsoft Teams integrieren.  Das bedeutet, dass Just Social dann in einem Tab in MS Teams angezeigt werden kann und es daher nicht mehr im Browser aufgerufen werden muss.

Zusätzlich können Notifications aus Just Social (zu News oder Wikis) in MS Teams angezeigt werden.

Einrichten von MS Teams in Just Social

Ihr habt die Möglichkeit MS Teams mit und ohne Just Notifications einzurichten. Für die Einrichtung der Notifications werden weitere Daten aus Microsoft Entra benötigt, weiteres dazu weiter unten.

Sofern ihr dies wünscht, müsst ihr in der Admin-App unter Anbindungen > Microsoft Teams den Punkt "Teams einrichten" wählen.

Einrichtung ohne Notifications

1. Ihr werdet automatisch durch die nötigen Schritte geleitet.Wenn ihr gefragt werdet ob ihr Notifications aktivieren wollt könnt ihr dies hier überspringen und habt die Möglichkeit diese später zu aktivieren.
2. Ihr ladet euch die zip-Datei herunter.

3. Ein Administrator von MS Teams klickt dann in der Applikation unten auf "Apps" -> "Benutzerdefinierte App hochladen" an und lädt im Anschluss die zip-Datei hoch.

   

4. Auf "Hinzufügen" klicken
   

Nun kann jede*r Nutzer*in diese App unter "Weitere Apps" finden und selbst hinzufügen. Es ist ratsam, dass jede*r Nutzer*in die App danach auch in seinem Tab fixiert.

Dazu klickt der Nutzer per Rechtsklick auf die hinzugefügte App und wählt "Anheften" aus.

Bitte beachtet:

Just Social lädt sich in einem iFrame in eurem MS Teams. Sofern ihr zwischen den Tabs links wechselt, wird immer wieder der Home Screen oder das Newscover angezeigt (je nach Einstellung in eurem Just Social).

Einrichtung mit Just Notifications (für News/Wiki)

Die Einrichtung von MS Teams inklusive der Just Notifications funktioniert genau so wie die ohne, lediglich beim Einrichten der Notifications werden noch folgende Daten gefordert:

• Tenant ID (von MS Teams)
• Client ID
• Client Secret
• Ablaufzeit des Secrets

Diese Daten müssen zuvor über Microsoft Entra von einem MS Teams Admin generiert werden:

Neue App registrieren

Im Menü auf der Linken Seite unter Entra ID > App Registrierung auswählen auf der rechten Seite auf Neue Registerung wählen.

App Details ausfüllen

Name: frei wählbar
Unterstützte Kontotypen: "Nur ein mandant"
Umleitungs-URI (optional): leer lassen

Es wird eine neue App Registriert und ihr landet auf die Übersichtseite.

Tenant und Client ID
Die hier angezeigte Anwendungs-ID (Client) wird in Just als Client ID und die Verzeichnis-ID (Mandant) wird als Tenant ID benötigt.

Client Secret

Nun muss noch das Client Secret erzeugt werden. Klickt dazu auf der App-Details-Seite auf Zertifikate & Geheimnisse und dort auf + Neuer geheimer Clientschlüssel.
Vergebt eine Beschreibung und setzt das Ablaufdatum des Schlüssels fest.

⚠️⚠️⚠️⚠️⚠️

NUR jetzt könnt ihr den Wert des generierten Secrets kopieren, später ist es nicht mehr vollständig sichtbar! Notiert euch nun auch das Ablaufdatum des Secrets.

Berechtigung zum Senden von Notifications

Nun muss nur noch die passende Berechtigung vergeben werden damit Just Notifications an Microsoft senden darf. Dazu klickt auf API-Berechtigung, wählt Berechtigung hinzufügen.

Konfiguriert dort eine Microsoft Graph Berechtigung:Anwendungsberechtigungen > TeamsActivity.Send

Diese Berechtigung muss nun von einem Entra Administrator freigegeben werden.

Der Rest der Einrichtung funktioniert genau so wie in der Einrichtung ohne Notifications.