Vermittlungsplatz in Microsoft Teams

Wozu dient das

Der Vermittlungsplatz lässt sich als persönliche App in Microsoft Teams einbinden. Der Attendant öffnet ihn in der Teams-App-Leiste und meldet sich mit seinem aktiven Teams-Konto an. Das Kennwort wird nicht an EasyUC übertragen. Teams lädt dabei die Seite des Vermittlungsplatzes vom eigenen EasyUC-Server.

Die App ist tenant-intern. Jeder Betreiber verwaltet seine eigene Entra-App-Registrierung und lädt sein eigenes App-Paket in Teams hoch. Es gibt keine Veröffentlichung im öffentlichen Teams Store.

Davon unabhängig ist die Frage, mit welchem Gerät der Attendant spricht. Als Gerät kommen die Microsoft-Teams-App und ein Teams-Tischtelefon in Frage. Bei beiden nimmt der Attendant den Anruf in Teams an.

Voraussetzungen

Lizenzmodule acd und teams.
Ein vollständiger DNS-Name für EasyUC und HTTPS auf Port 443 mit einer für Teams und Browser vertrauenswürdigen Zertifikatskette. Reine IP-Adressen und selbstsignierte Zertifikate sind für einen Teams-Tab ungeeignet.
Über HTTPS erreichbare Seiten mit Datenschutzerklärung und Nutzungsbedingungen.
In Microsoft Entra: Berechtigung zum Erstellen einer App-Registrierung. Im Teams Admin Center: Berechtigung zum Hochladen und Freigeben einer benutzerdefinierten App.
Ein in EasyUC angebundener Teams-Tenant. Die Attendants sind mit ihrem Teams-Konto (UPN) bzw. einem Teams-Gerät der Konsole zugeordnet.
Das Erzeugen des App-Pakets erfolgt mit einem mitgelieferten Werkzeug. Wenden Sie sich dafür an den Hersteller bzw. die Systembetreuung.

Schritt für Schritt: Entra-App registrieren

Öffnen Sie im Microsoft Entra Admin Center Identity → Applications → App registrations → New registration.
Vergeben Sie einen Namen, zum Beispiel EasyUC Attendant, und wählen Sie Accounts in this organizational directory only. Tragen Sie keine Redirect URI ein.
Notieren Sie Directory (tenant) ID und Application (client) ID.
Setzen Sie im Manifest der App unter api den Wert requestedAccessTokenVersion auf 2.
Legen Sie unter Expose an API die Application ID URI api://<fqdn>/<client-id> an.
Erstellen Sie den delegierten Scope access_as_user (Zustimmung durch Admins und Benutzer, aktiviert).
Tragen Sie unter Authorized client applications die beiden Teams-Clients von Microsoft ein (Teams Desktop/Mobile und Teams Web) und autorisieren Sie den Scope für sie.

Schritt für Schritt: App-Paket hochladen und freigeben

Lassen Sie das App-Paket für Ihren Hostnamen und Ihre Client-ID erzeugen. Es enthält genau manifest.json, color.png und outline.png und weder Kennwörter noch Client Secrets.
Öffnen Sie das Teams Admin Center und dort Teams apps → Manage apps.
Klicken Sie auf Actions → Upload new app und laden Sie die ZIP-Datei hoch.
Geben Sie die App für die Gruppe der Attendants frei. Sie erscheint unter Built for your org.
Verwenden Sie bei Bedarf eine Setup Policy, um die App automatisch zu installieren und in der App-Leiste anzuheften.

Schritt für Schritt: In Teams anmelden und Anrufe annehmen

Öffnen Sie in Teams die App EasyUC Attendant. Die Seite zeigt Vermittlungsplatz in Microsoft Teams.
Klicken Sie auf Mit Teams anmelden. EasyUC verwendet Ihre aktive Teams-Anmeldung.
Wählen Sie Ihr Gerät, zum Beispiel Microsoft Teams (Softphone), und klicken Sie auf Loslegen.
Erscheint ein Anruf, nehmen Sie ihn in Microsoft Teams an. Die Konsole zeigt dazu Bitte in Microsoft Teams annehmen.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Application ID URI	`api://<fqdn>/<client-id>`. Muss exakt mit dem Wert im App-Paket übereinstimmen.
Scope	`access_as_user`. Für die Anmeldung am EasyUC-Server sind keine Microsoft-Graph-Berechtigung und kein Client Secret erforderlich.
App-Paket	Persönlicher Installationsumfang, Manifest nach Teams-Schema 1.22. Bei einem Update dieselbe Client-ID verwenden und die Versionsnummer erhöhen.
Mit Microsoft anmelden	Im Browser außerhalb von Teams: Anmeldung über ein Microsoft-Fenster oder einen Anmeldecode. Bei mehreren Organisationen wählen Sie unter Microsoft-Organisation die eigene.
Gerät Microsoft-Teams-App	Annehmen in Microsoft Teams. Teams klingelt beim Benutzer: Alle Teams-Geräte dieses Kontos klingeln gleichzeitig.
Gerät Microsoft-Teams-Tischtelefon	Annehmen am Teams-Telefon. Teams-zertifiziertes Tischtelefon, angemeldet mit dem Konto des Attendants.
Strecken	Welche Anrufe ein Teams-Gerät erreichen, zeigen Übersicht und Prüfliste je Strecke. Nach der Annahme eines Teams-Anrufs steuert der Attendant Halten, Auflegen und Vermitteln im Teams-Client.

Ergebnis prüfen und Fehler eingrenzen

Die App öffnet den Vermittlungsplatz innerhalb von Teams, und nach Mit Teams anmelden erscheint die Gerätewahl.
Der Vermittlungsplatz konnte in Microsoft Teams nicht initialisiert werden. Bitte öffnen Sie ihn erneut in Teams. Die Seite wurde nicht aus Teams heraus geladen oder das Einbetten ist blockiert. Prüfen Sie Hostname und Zertifikat.
Die Anmeldung mit Ihrem Microsoft-Teams-Konto ist fehlgeschlagen. Bitte versuchen Sie es erneut. Prüfen Sie Application ID URI, Scope und die autorisierten Client-Anwendungen.
Dieses Microsoft-Konto ist nicht für den Vermittlungsplatz freigeschaltet. Das Konto ist keinem Attendant zugeordnet. Tragen Sie das Teams-Konto beim Attendant ein.
Die Microsoft-Anmeldung ist noch nicht vollständig eingerichtet. Bitte wenden Sie sich an die Verwaltung. bzw. Für die Microsoft-Anmeldung ist noch keine Organisation eingerichtet.
Das Microsoft-Anmeldefenster wurde blockiert. Bitte erlauben Sie Pop-ups für EasyUC und versuchen Sie es erneut.
Die Seite bleibt in Teams leer: Der Webserver darf das Einbetten durch Teams nicht verbieten. EasyUC erlaubt es nur für den Einstieg des Vermittlungsplatzes; ein vorgeschalteter Proxy darf den Header nicht überschreiben.
Anrufe werden nicht zugestellt, obwohl der Attendant bereit ist: Voicemail und Umleitung bei Nichtmelden des Teams-Benutzers ausschalten und in der Prüfliste die Strecke für Teams-Geräte prüfen.