# Microsoft Teams anbinden

> **Zielgruppe & Rolle**
>
> **Rolle**: IT-Administrator des Kunden (Globaler Administrator, oder Administrator für privilegierte Rollen und
> Teams-Administrator) | **Voraussetzung**: [Microsoft 365 angebunden](/knowledge/docs/products/portal/system-config/microsoft-365.md); im Portal das Recht
> „Integrationen“

# Microsoft Teams anbinden

Anrufe und Besprechungen aus Microsoft Teams erscheinen im Arbeitsplatz unter **Aktivitäten**, in Kunde 360° und in
„Mein Tag“ – mit Teilnehmenden, Dauer und, wenn vorhanden, Transkript. Das Portal liest die Anrufe und Besprechungen
**aller** Benutzer Ihres Microsoft 365 und legt Aktivitäten für die Benutzer an, die im Personalbereich als
Mitarbeitende geführt sind – zugeordnet über ihre E-Mail-Adresse. Ihre eigenen Domains liest das Portal aus Microsoft;
Teilnehmende anderer Domains, Gäste und Telefonnummern gelten als Gegenseite.

| Berechtigung (Anwendung, mit Administratorzustimmung) | Wofür |
|---|---|
| `CallRecords.Read.All` | Anrufe und Besprechungen aller Benutzer |
| `User.Read.All` | Adressen der Teilnehmenden |
| `Organization.Read.All` | Ihre eigenen Domains (fehlt sie, gelten nur Benutzer Ihres Microsoft 365 als intern) |
| `OnlineMeetings.Read.All` | Betreff von Besprechungen |
| `OnlineMeetingArtifact.Read.All` | Teilnahme |
| `OnlineMeetingTranscript.Read.All` | Transkripte |
| `Calendars.Read` (optional) | Termine in der Leistungserfassung („Mein Tag“) |
| `TeamsAppInstallation.ReadWriteForUser.All` | installiert die Teams-App persönlich für Mitarbeitende, die „In Teams“ einschalten |
| `AppCatalog.Read.All` | findet die hochgeladene Teams-App im App-Katalog Ihrer Organisation |
| Application Access Policy in Teams | gibt der App die Besprechungen der Benutzer frei |

## Einrichtung per PowerShell

Das Skript [Setup-MbcomCloudTeams.ps1](/knowledge/docs/products/portal/system-config/Setup-MbcomCloudTeams.ps1) vergibt die Berechtigungen samt Zustimmung und
erstellt die Application Access Policy für alle Benutzer. Es meldet Sie zweimal an: bei Microsoft Graph und bei Teams.

```powershell
./Setup-MbcomCloudTeams.ps1 -AppId <Client-ID>
./Setup-MbcomCloudTeams.ps1 -AppId <Client-ID> -DeviceCode   # Anmeldung mit Gerätecode
```

| Parameter | Bedeutung |
|---|---|
| `-AppId` | Client-ID der App; ohne sie sucht das Skript die App „MBCOM Cloud“ |
| `-Users` | Policy nur für diese Benutzer statt für alle (Besprechungen anderer bleiben ohne Betreff, Teilnahme und Transkript) |
| `-NoCalendar` | ohne `Calendars.Read` |
| `-DeviceCode` | Anmeldung mit Gerätecode statt Browserfenster |

> [!NOTE]
> Die Application Access Policy kann bis zu 30 Minuten brauchen, bis sie greift. Meldet das Portal in dieser Zeit
> „Microsoft 365 verweigert den Zugriff“, versuchen Sie es später noch einmal.

## Einrichtung von Hand

1. **App-Registrierung › API-Berechtigungen › Microsoft Graph › Anwendungsberechtigungen**: die Berechtigungen aus der
   Tabelle hinzufügen, dann **Administratorzustimmung erteilen**.
2. In der Teams-PowerShell (`Connect-MicrosoftTeams`):

   ```powershell
   New-CsApplicationAccessPolicy -Identity MBCOM-Cloud -AppIds <Client-ID> -Description "MBCOM Cloud"
   Grant-CsApplicationAccessPolicy -PolicyName MBCOM-Cloud -Global
   ```

## Im Portal

**Einstellungen › Integrationen › Teams**: **Anrufe und Besprechungen abrufen** einschalten und **Testen**. Weitere
Einstellungen gibt es nicht. Microsoft hält Anrufdaten 30 Tage vor; das Portal ruft neue Anrufe laufend ab.

## Teams-App (Benachrichtigungen und Entscheidungen)

Die MBCOM-Cloud-App für Teams schickt Benachrichtigungen als Karten in den persönlichen Chat und in Teams-Kanäle. Bei
Aufgaben, Abwesenheits- und Reiseanträgen und Tickets enthält die Karte Schaltflächen (zum Beispiel **Freigeben**,
**Ablehnen**, **Mir zuweisen**): Die Entscheidung gilt, als hätte die Person sie im Portal getroffen, mit ihren eigenen
Rechten. Die Karte enthält nur die Benachrichtigung, keine Dokumente, Anhänge oder Transkripte. Voraussetzung ist die
Berechtigungstabelle oben (Skript oder von Hand) und eine **bestätigte** Microsoft-365-Verbindung.

1. **Verbindung bestätigen**: unter **Einstellungen › Integrationen › Microsoft 365** einmal **Verbindung testen**. Erst
   danach ordnet das Portal Teams-Nutzer Ihrem Mandanten zu; bis dahin zeigt **Integrationen › Teams** den Hinweis
   „Microsoft 365 ist noch nicht bestätigt“.
2. **App-Paket laden**: unter **Einstellungen › Integrationen › Teams** im Abschnitt „Teams-App“ auf **Teams-App
   herunterladen** klicken (Administrationsrecht für Kommunikation). Das Paket gilt für diese Plattform.
3. **In Teams hochladen**: im Teams Admin Center unter **Teams-Apps › Apps verwalten › Hochladen** das Paket hochladen.
4. **Freigeben**: die App unter **Berechtigungsrichtlinien** und **Setuprichtlinien** Benutzern oder Teams freigeben.
   Teams braucht dafür bis zu einigen Stunden.
5. **Persönlich einschalten**: Mitarbeitende schalten unter **Einstellungen › Meine Benachrichtigungen** den Schalter
   **In Teams** ein (siehe [Benachrichtigungen in Teams](/knowledge/docs/products/portal/user-docs/benachrichtigungen-in-teams.md)).
6. **Kanäle**: fügen Sie die App einem Team oder Gruppenchat hinzu, erscheint der Kanal unter **Einstellungen ›
   E-Mail & Kanäle › Kanäle**. Als Ziel wählen Sie ihn in Flows (zum Beispiel bei einer
   Aufgabe mit Entscheidung) aus.

> [!NOTE]
> Hat eine Microsoft-365-Verzeichnis-ID zwei Mandanten, bedient die Teams-App keinen von beiden und die Seite zeigt einen
> Konflikt. Wenden Sie sich in diesem Fall an den Support.
