Um die Teams-Integration für STARFACE verwenden zu können, benötigen Sie vier Komponenten:

STARFACE

• STARFACE Appliance, VM oder Cloud-Instanz
• UCC-Premiumlizenzen für die STARFACE Benutzer mit Teams-Integration sowie MS Teams Integration Lizenzen

Microsoft Office 365

• Microsoft Phone System Lizenz für STARFACE/Office 365-Benutzer mit Teams-Integration

Patton eSBC (entweder On-Premise oder als Managed Service)

• Patton eSBC (z.B. SmartNode 5500/5600, vTrinity-VM oder Vergleichbares)
• Öffentlich erreichbare IP-Adresse für den eSBC (kein DNAT/Portforwarding)
• Extern auflösbaren Hostnamen für den eSBC (z.B. sbc01.IhreFirma.de)
• Von einer externen vertrauenswürdigen CA signiertes SSL-Zertifikat sowie zugehörigen Private Key für den SBC und dessen Hostnamen

Fluxpunkt Teams Integration für STARFACE

• Modul für die STARFACE
• App für Teams
• Managed Service für die Anbindung von Teams an die STARFACE (für die Laufzeit der Nutzung)

Achtung Bandbreite:
Desweiteren sollte die Bandbreite für die Sprachkommunikation 300kbit/s (symmetrisch) pro Teams-Gespräch betragen. Die Bandbreitenanforderung resultiert aus der Verbindung von Teams zur Microsoft (1 VoIP-Call), von Microsoft zum eSBC (weiterer VoIP-Call), vom eSBC/der STARFACE zurück ins Amt (weiterer VoIP-Call).

Als Endkunde ist der für Sie zuständige STARFACE-Partner Ihr Ansprechpartner für alle Themen rund um STARFACE und die Modullandschaft.

Da die Integration von STARFACE in Teams eine sehr stark nachgefragte Funktion ist, bitten wir STARFACE-Partner, im Sinne einer breiten Skalierbarkeit, sich entweder an STARFACE oder an einen unserer "Leuchtturmpartner" zu wenden. Leuchtturmpartner haben besonderes Know-How im Bereich Microsoft, Patton und STARFACE und können bei Projekten gezielt unterstützen. Leuchtturmpartner wiederum werden von Fluxpunkt direkt unterstützt.

Vorweg: Die für den Betrieb der Teams-Integration notwendigen Webservices speichern keine personenbezogenen Daten.

Die Webservices bauen auf einer Datenbank auf, in der Office 365-Tenant-IDs mit IPs oder dem Hostnamen von STARFACE-Instanzen verknüpft werden.
Auf diese Weise können Unternehmen auch mehrere STARFACE-Anlagen mit Teams nutzen. Die eingegebenen Zugangsdaten für eine STARFACE-Anmeldung werden nicht gespeichert, sondern lediglich für eine unmittelbare UCI-Verbindung zur STARFACE verwendet. Es kann daher von Zeit zu Zeit vorkommen, dass Zugangsdaten in Teams erneut eingegeben werden müssen.

Die Meldung "No open connection to STARFACE ... with key ..." deutet darauf hin, dass sich die gewünschte STARFACE-Anlage (noch) nicht am Cloud-Connector-Dienst angemeldet hat. Mögliche Ursachen:

• Modulkonfiguration des STARFACE APIs Connector ist nicht aktiv.
  Fehlerbehebung: Aktivieren Sie die Modulkonfiguration:
  
  Bitte aktivieren Sie anschließend den UCI Connector innerhalb der Modulkonfiguration (dieser ist nach Aktivierung des Moduls zunächst deaktiviert).
  
  
• Der UCI Connector (innerhalb der Modulkonfiguration) ist nicht aktiv.
  
  Fehlerbehebung: Deaktivieren und Reaktivieren Sie den Schalter "UCI Connector".
  
  
• Der Cloud-Connector-Dienst ist für die STARFACE nicht erreichbar.
  Mögliche Fehlerquellen: DNS, Firewall, Routing, Proxy, Netzwerkausfall. Das Modul baut eine Verbindung zum Cloud-Connector-Dienst auf, um sich an diesem zu registrieren und Daten auszutauschen.
  
  Transport: Websocket (TCP/443)
  Dienste-URLs: service-cloud-connector.fluxpunkt.de bzw. uci-cloud-connector.westeurope.cloudapp.azure.com
  
  Fehlerbehebung: Prüfen Sie die Erreichbarkeit der genannten URLs.
• Der eingegebene Hostname ist bereits mit einer anderen STARFACE-Installation verknüpft.
  Zum Beispiel durch Neuinstallation einer STARFACE (ohne Einspielen eines Backups) und Registrierung der STARFACE unter dem selben Hostnamen oder beim Betrieb mehrerer STARFACE-Installationen und Verwenden des selben Hostnamens innerhalb der Modulkonfiguration.
  
  Fehlerbehebung: Im Falle einer Neuinstallation kontaktieren Sie bitte unseren Support oder verwenden einen anderen/neuen Hostnamen.
  
  
• Der Schlüssel zur Anlage ist falsch.
  Fehlerbehebung: Bitte prüfen Sie den eingegebenen Schlüssel auf Übereinstimmung mit dem in der Modulkonfiguration angezeigten Schlüssel. Alternativ laden Sie die Schlüsseldatei herunter und fügen diese per Drag&Drop im Anmeldefenster der STARFACE Teams App ein.
  

Wenn der Teams-Client und das UCC-Client-Softphone die selben Audio-Ein-/Ausgabegeräte verwenden, stehen diese im Moment der Rufannahme durch den UCC-Client dem Teams-Client nicht mehr zur Verfügung.
Der Microsoft Teams-Client reagiert darauf mit einer Ablehnung des Gesprächs, was zu einer Gesprächsbeendigung des eingehenden Anrufs im Zeitpunkt der Annahme führt. Der Anruf wird aktiv abgelehnt und beendet.

Workaround:

Der Teams- und UCC-Client müssen unterschiedliche Audio-Ein-/Ausgabegeräte verwenden. Diese können in den Einstellungen des jeweiligen Clients vorgenommen werden.

Dieses Problem tritt auf, wenn auf dem verwendeten SBC das RTCP-Multiplexing deaktiviert ist. Bitte aktivieren Sie RTCP-Multiplexing.

1. Entfernen Sie alle Haken in der Auswahl der Präsenstatusliste, die in die STARFACE als DND übernommen werden sollen. Setzen Sie anschließend wieder die Haken für die gewünschten Status.
2. Falls dies den Fehler nicht behebt, melden Sie Ihren Benutzer in der Teams App ab und wieder an.

Pour utiliser le Teams-Integration for STARFACE vous avez besoin de quatre éléments:

STARFACE

• STARFACE Appliance, VM ou Cloud-Instanz
• UCC-Premiumlizenzen pour les utilisateurs de STARFACE avec intégration de MS Teams ainsi que MS Teams Integration Lizenzen

Microsoft Office 365

• Microsoft Phone System Lizenz pour STARFACE/Office 365-utilisateurs avec MS Teams-Integration

Patton eSBC (soit On-Premise ou comme Managed Service)

• Patton eSBC (p.e. SmartNode 5500/5600, vTrinity-VM ou Vergleichbares)
• Adresse IP accessible au public pour l'eSBC (pas de DNAT/transfert de port)
• Nom d'hôte à résolution externe pour l'eSBC (p.e. sbc01.IhreFirma.de)
• Certificat SSL signé par une CA externe de confiance et clé privée associée pour le SBC et son nom d'hôte.

Fluxpunkt Teams Integration for STARFACE

• Module pour le STARFACE
• App pour MS Teams
• Managed Service pour la connexion de MS Teams à STARFACE (pour la durée d'utilisation)

Attention à la bande passante:
En outre, la largeur de bande pour la communication vocale devrait être de 300 kbit/s (symétrique) par appel de MS Teams. La largeur de bande requise résulte de la connexion de MS Teams à Microsoft (1 appel VoIP), de Microsoft à l'eSBC (autre appel VoIP), de l'eSBC/la STARFACE au bureau (autre appel VoIP).

En tant que client, le partenaire STARFACE responsable pour vous est votre interlocuteur pour tous les sujets concernant STARFACE et le paysage des modules.

Comme l'intégration de STARFACE dans le MS Teams est une fonction très populaire, nous demandons aux partenaires de STARFACE de contacter soit STARFACE, soit l'un de nos "partenaires phares" pour assurer une large extensibilité. Les "partenaires phares"  possèdent un savoir-faire particulier dans les domaines de Microsoft, Patton et STARFACE et peuvent apporter un soutien ciblé aux projets. Les partenaires du phare, à leur tour, sont soutenus directement par Fluxpunkt.

Tout d'abord : les services web nécessaires au fonctionnement de l'intégration de MS Teams ne stockent aucune donnée personnelle.

Les services web sont construits sur une base de données où les identifiants des locataires d'Office 365 sont liés aux IP ou au nom d'hôte des instances STARFACE.
De cette manière, les entreprises peuvent également utiliser plusieurs systèmes STARFACE avec de MS Teams. Les données d'accès saisies pour un login STARFACE ne sont pas stockées, mais uniquement utilisées pour une connexion immédiate de l'UCI à STARFACE. Il peut donc arriver de temps en temps que les données d'accès doivent être saisies à nouveau en MS Teams.

Die Meldung "No open connection to STARFACE ... with key ..." deutet darauf hin, dass sich die gewünschte STARFACE-Anlage (noch) nicht am Cloud-Connector-Dienst angemeldet hat. Mögliche Ursachen:

• Modulkonfiguration des STARFACE APIs Connector ist nicht aktiv.
  Fehlerbehebung: Aktivieren Sie die Modulkonfiguration:
  
  Bitte aktivieren Sie anschließend den UCI Connector innerhalb der Modulkonfiguration (dieser ist nach Aktivierung des Moduls zunächst deaktiviert).
  
  
• Der UCI Connector (innerhalb der Modulkonfiguration) ist nicht aktiv.
  
  Fehlerbehebung: Deaktivieren und Reaktivieren Sie den Schalter "UCI Connector".
  
  
• Der Cloud-Connector-Dienst ist für die STARFACE nicht erreichbar.
  Mögliche Fehlerquellen: DNS, Firewall, Routing, Proxy, Netzwerkausfall. Das Modul baut eine Verbindung zum Cloud-Connector-Dienst auf, um sich an diesem zu registrieren und Daten auszutauschen.
  
  Transport: Websocket (TCP/443)
  Dienste-URLs: service-cloud-connector.fluxpunkt.de bzw. uci-cloud-connector.westeurope.cloudapp.azure.com
  
  Fehlerbehebung: Prüfen Sie die Erreichbarkeit der genannten URLs.
• Der eingegebene Hostname ist bereits mit einer anderen STARFACE-Installation verknüpft.
  Zum Beispiel durch Neuinstallation einer STARFACE (ohne Einspielen eines Backups) und Registrierung der STARFACE unter dem selben Hostnamen oder beim Betrieb mehrerer STARFACE-Installationen und Verwenden des selben Hostnamens innerhalb der Modulkonfiguration.
  
  Fehlerbehebung: Im Falle einer Neuinstallation kontaktieren Sie bitte unseren Support oder verwenden einen anderen/neuen Hostnamen.
  
  
• Der Schlüssel zur Anlage ist falsch.
  Fehlerbehebung: Bitte prüfen Sie den eingegebenen Schlüssel auf Übereinstimmung mit dem in der Modulkonfiguration angezeigten Schlüssel. Alternativ laden Sie die Schlüsseldatei herunter und fügen diese per Drag&Drop im Anmeldefenster der STARFACE Teams App ein.
  

Wenn der Teams-Client und das UCC-Client-Softphone die selben Audio-Ein-/Ausgabegeräte verwenden, stehen diese im Moment der Rufannahme durch den UCC-Client dem Teams-Client nicht mehr zur Verfügung.
Der Microsoft Teams-Client reagiert darauf mit einer Ablehnung des Gesprächs, was zu einer Gesprächsbeendigung des eingehenden Anrufs im Zeitpunkt der Annahme führt. Der Anruf wird aktiv abgelehnt und beendet.

Workaround:

Der Teams- und UCC-Client müssen unterschiedliche Audio-Ein-/Ausgabegeräte verwenden. Diese können in den Einstellungen des jeweiligen Clients vorgenommen werden.

Dieses Problem tritt auf, wenn auf dem verwendeten SBC das RTCP-Multiplexing deaktiviert ist. Bitte aktivieren Sie RTCP-Multiplexing.

1. Entfernen Sie alle Haken in der Auswahl der Präsenstatusliste, die in die STARFACE als DND übernommen werden sollen. Setzen Sie anschließend wieder die Haken für die gewünschten Status.
2. Falls dies den Fehler nicht behebt, melden Sie Ihren Benutzer in der Teams App ab und wieder an.