Allgemein

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.

Alphabetische Reihenfolge ohne Wertung

Telefonie

Nein, die STARFACE Teams App ist ein Client zur Steuerung der STARFACE und zur Anzeige relevanter Informationen aus der STARFACE – vergleichbar dem Basis UCC-Client ohne Softphone.

Als Telefonie-Endgerät kann Teams (mittels Microsoft Phone System und Direct Routing Anbindung), das STARFACE UCC-Client Softphone oder jedes andere STARFACE-Telefonie-Endgerät verwendet werden.
Die Systematik lautet: Als Endgerät kommt jedes iFMC oder SIP-Telefon der STARFACE in Betracht. Das Endgerät selbst hat zunächst nichts mit Microsoft Teams oder der STARFACE Teams App zu tun.
Für die ausgehende Telefonie wird in der Regel das primäre Telefon eines Benutzers verwendet. Dieses kann entweder im UCC-Client, der STARFACE-Web-Benutzer- oder Admin-Oberfläche oder der STARFACE Teams App ausgewählt werden.

Das ausgewählte Primärtelefon muß erreichbar sein, damit ausgehende Telefonie überhaupt möglich ist. Ist beispielsweise ein UCC-Client-Softphone (aka WinClient) ausgwählt, muß der STARFACE UCC-Client aktiv und angemeldet sein sowie das Softphone des UCC-Clients aktiviert werden.



Hierzu muß man zunächst verstehen, dass das Auslösen eines Anrufs per STARFACE Teams App (genauso wie das Auslösen per UCC-Client oder STARFACE Weboberfläche) technisch durch einen Anruf der STARFACE an das primäre Endgerät eines Benutzers umgesetzt wird. Endgeräte, die eine automatische Rufannahme unterstützen (z.B. diverse Tischtelefone, das Softphone des UCC-Clients und auch manche DECT-Endgeräte) scheinen – durch die automatische Annahme und den unmittelbar folgenden Rufaufbau zum Zielteilnehmer – quasi "ferngesteuert".

Wird die STARFACE/Teams-Integration mittels Direct Routing und Microsoft Phone System umgesetzt und Teams damit zu einem "Endgerät" der STARFACE – und handelt es sich beim "Teams-Endgerät" um das Primärtelefon eines Benutzers –, erzeugt die STARFACE, für den ausgehenden Anruf zum Zielteilnehmer, zunächst einen ausgehenden Anruf zum "Teams-Endgerät". Teams ist derzeit jedoch leider nicht in der Lage, Anrufe automatisch anzunehmen. Der Anruf wird in Teams deshalb als "normaler" eingehender Anruf signalisiert, der vom Benutzer angenommen werden muß. Durch die Annahme des Gesprächs wird unmittelbar folgend der ausgehende Anruf zum Zielteilnehmer durch die STARFACE erzeugt und mit dem eben angenommenen Anruf verbunden.

Dafür ist ein Bug in der STARFACE UCI API verantwortlich. STARFACE wurde darüber in Kenntnis gesetzt und wir warten auf eine Behebung.

Alternativ kann die native Wähltastatur von Teams verwendet werden, um DTMF Signale direkt im Audiostrom zu übermitteln. 

Compliance

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.

Teams-Lizenzierung

STARFACE User-Assigned-License (UAL)

Die Möglichkeit einer Teams-Anbindung läßt sich, ähnlich wie beim UCC-Client Softphone, über ein lizenzpflichtiges Benutzerrecht steuern. Benutzer, mit dem Recht Integration mit Microsoft Teams können sich aus der STARFACE Teams App heraus mit der STARFACE Telefonanlage verbinden. Die Anzahl der Benutzer, denen dieses Recht zugewiesen werden kann, ist abhängig von der Anzahl entsprechender STARFACE UALs. STARFACE UALs werden über den STARFACE Partner-Shop bzw. STARFACE Lizenzmanager verkauft. Während der Laufzeit der Lizenzen erhalten die zugewiesenen Benutzer dauerhaft das Recht, sich per STARFACE Teams App zu verbinden.

Fluxpunkt Floating-License (FL)

Fluxpunkt Floating-Licenses werden in Form eines Lizenzschlüssels in der Modulkonfiguration des STARFACE API Connectors eingetragen und erlauben es der lizenzierten Anzahl von Benutzern, sich zeitgleich mit der STARFACE zu verbinden. Es findet keine Zuweisung zu konkreten Benutzern statt. Fluxpunkt Floating-Licenses stellen einen Lizenz-Pool dar, der von Benutzern ausgeschöpft werden kann.

Ein Benutzer, der sich anmeldet konsumiert eine Lizenz – wird der Benutzer abgemeldet, wird die Lizenz wieder frei und kann von einem anderen Benutzer verwendet werden.

STARFACE Benutzer mit dem Recht Administration → Benutzer können innerhalb der STARFACE Teams App sehen, welchem STARFACE Benutzer eine Floating-License zugewiesen wurde und können diese Lizenz auch aktiv entziehen und die Anbindung des Benutzers damit trennen.

Abhängig vom Anwendungsfall kann es sinnvoll sein, STARFACE User-Assigned-Licenses und Fluxpunkt Floating-Licenses zu mischen. Beispiel:
Fixe Lizenzzuweisung für feste Mitarbeiter und Floating Licenses für "Überhänge" (Zeitarbeiter, Schichtbetrieb, temporäre Accounts, Bedarfsspitzen).


STARFACE UALFluxpunkt FL
Lizenzbedarffixflexibel
Zuweisung der Lizenzdurch Administratorautomatisch mit Anmeldung
Entziehen der Lizenzdurch Administratorautomatisch mit Abmeldung
Lizenzmanagement in Teams App-
BezugsmöglichkeitenSTARFACE LizenzmanagerFluxpunkt Modulbestellung
Bereitstellung durch STARFACE Partnerfür eigene Kunden-Installationenfür beliebige STARFACE-Installationen
Abrechnungdurch STARFACEdurch Fluxpunkt
Beratung & Supportdurch STARFACEdurch STARFACE Partner bzw.
Fluxpunkt Leuchtturmpartner
STARFACE Kompatibilität>= 6.7.3>= 6.7.0

Probleme bei der Anmeldung an der STARFACE Teams App

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.

Probleme bei der Anmeldung an Azure AD

Fehlermeldungen die im Zusammenhang mit der Microsoft-Anmeldung generiert werden, müssen vom Betreuer Ihrer Microsoft-Umgebung behandelt werden!

Fehlermeldungen:


Probleme bei der Gesprächsannahme

Zur Annahme von Anrufen in Teams, muss der von Teams eingeblendete Popup-Dialog verwendet werden. Innerhalb der Teams App lässt sich dann das angenommene Gespräche steuern.

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.

Probleme bei der Beendigung eines Gesprächs

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

Probleme bei der Synchronisierung des Präsenzstatus 

  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.



Généralités

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.

Ordre alphabétique sans notation

Téléphonie

Pour ce faire, vous devez d'abord comprendre que le déclenchement d'un appel à l'aide de l'application STARFACE Teams (tout comme le déclenchement à l'aide d'un client UCC ou d'une interface Web STARFACE) est implémenté techniquement en appelant STARFACE sur le terminal principal d'un utilisateur. Les terminaux prenant en charge l'acceptation automatique des appels (par exemple, divers téléphones fixes, le softphone du client UCC et également certains terminaux DECT) semblent être «télécommandés» en raison de l'acceptation automatique et de la configuration d'appel immédiatement suivante vers l'abonné cible.

Si l'intégration STARFACE / Teams est implémentée en utilisant Direct Routing et Microsoft Phone System et que les équipes deviennent un «terminal» de STARFACE - et que le «terminal Teams» est le téléphone principal de l'utilisateur - STARFACE génère l'appel sortant vers l'abonné cible, d'abord un appel sortant vers le "terminal des équipes". Malheureusement, Teams n'est actuellement pas en mesure de répondre automatiquement aux appels. Dans les équipes, l'appel est donc signalé comme un appel entrant "normal" qui doit être accepté par l'utilisateur. En acceptant l'appel, l'appel sortant vers l'abonné cible est immédiatement généré par STARFACE et connecté à l'appel qui vient d'être accepté.

Un bug dans l'API STARFACE UCI en est responsable. STARFACE en a été informé et nous attendons que cela soit rectifié.

Alternativement, le clavier natif peut être utilisé par les équipes pour transmettre des signaux DTMF directement dans le flux audio.

Compliance - Conformité

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.

Licenses de MS Teams Integration

STARFACE User-Assigned-License (UAL)

La possibilité d'une connexion MS Teams peut être contrôlée via un droit d'utilisation sous licence, similaire au softphone du client UCC. Les utilisateurs ayant une bonne intégration avec MSTeams peuvent se connecter au système téléphonique STARFACE à partir de l'application STARFACE Teams. Le nombre d'utilisateurs qui peuvent se voir attribuer ce droit dépend du nombre de STARFACE UAL correspondants. Les STARFACE UAL sont vendus via la boutique des partenaires STARFACE ou le gestionnaire de licences STARFACE. Pendant la durée des licences, les utilisateurs assignés reçoivent en permanence le droit de se connecter via l'application STARFACE Teams.

Fluxpunkt Floating-License (FL)

Les Fluxpunkt Floating-Licenses sont saisies sous la forme d'une clé de licence dans la configuration du module du connecteur API STARFACE et permettent au nombre d'utilisateurs autorisés de se connecter à STARFACE simultanément. Il n'y a pas d'affectation à des utilisateurs spécifiques.
Fluxpunkt Floating-Licenses représentent un pool de licences qui peuvent être utilisées par les utilisateurs.

Un utilisateur qui se connecte consomme une licence - si l'utilisateur se déconnecte, la licence redevient libre et peut être utilisée par un autre utilisateur.

Les utilisateurs de STARFACE avec la bonne administration → Les utilisateurs peuvent voir dans l'application STARFACE Teams quel utilisateur STARFACE s'est vu attribuer une licence flottante et peuvent également révoquer activement cette licence et ainsi déconnecter l'utilisateur.

Selon le cas d'utilisation, il peut être judicieux de mélanger les licences STARFACE attribuées par l'utilisateur et les licences flottantes Fluxpunkt. Exemple :
Attribution de licences fixes pour les employés permanents et de licences flottantes pour les "surplombs" (travailleurs temporaires, travail en équipe, comptes temporaires, pics de demande).


STARFACE UALFluxpunkt FL
Exigences en matière de licencesfixéflexible
Attribution de la licencepar administrateurautomatiquement avec l'enregistrement
Révocation de la licencepar administrateurautomatiquement avec déconnexion
Gestion des licences dans l'App Teams-
Options d'abonnementSTARFACE LizenzmanagerCommande du module Fluxpunkt
Mise à disposition par le partenaire STARFACEpour les installations de ses propres clientspour toute installation STARFACE
Facturationpar STARFACEpar Fluxpunkt
Conseil et assistancepar STARFACEpar les partenaires STARFACE ou
Partenaire du phare Fluxpoint
STARFACE Compatibilité>= 6.7.3>= 6.7.0

Problèmes de connexion à l'application STARFACE Teams

Le message "No open connection to STARFACE ... with key ..." indique que le système STARFACE souhaité n'est pas (encore) enregistré auprès du service Cloud Connector. Causes possibles:

  • La configuration des modules du connecteur des API STARFACE n'est pas active..
    Dépannage: Activez la configuration du module:

    Veuillez activer le connecteur UCI dans la configuration du module (il est désactivé après l'activation du module).

  • Le connecteur UCI (dans la configuration du module) n'est pas actif.

    Dépannage: Désactiver et réactiver le commutateur "Connecteur UCI".

  • Le service Cloud Connector n'est pas disponible pour la STARFACE.
    Sources d'erreurs possibles: DNS, Firewall, Routing, Proxy, Network. Le module établit une connexion avec le service Cloud Connector afin de s'enregistrer auprès de celui-ci et d'échanger des données.

    Transport: Websocket (TCP/443)
    Services-URLs: service-cloud-connector.fluxpunkt.de bzw. uci-cloud-connector.westeurope.cloudapp.azure.com

    Dépannage: vérifiez l'accessibilité des URL mentionnées.


  • Le nom d'hôte saisi est déjà lié à une autre installation STARFACE.
    Par exemple, en réinstallant une STARFACE (sans importer une sauvegarde) et en enregistrant la STARFACE sous le même nom d'hôte ou en exploitant plusieurs installations STARFACE et en utilisant le même nom d'hôte dans la configuration du module.

    Dépannage: En cas de nouvelle installation, veuillez contacter notre support ou utiliser un nom d'hôte différent ou nouveau.

  • La clé de la STARFACE est fausse.
    Dépannage: veuillez vérifier la cohérence de la clé saisie avec la clé affichée dans la configuration du module. Vous pouvez également télécharger le fichier clé et l'insérer par glisser-déposer dans la fenêtre de connexion de l'application STARFACE Teams.

Problèmes d'acceptation des appels

Si le client Teams et le softphone client UCC utilisent les mêmes dispositifs d'entrée/sortie audio, ceux-ci ne sont plus disponibles pour le client Teams au moment où le client UCC répond à l'appel.
Le client Microsoft Teams répond en rejetant l'appel, ce qui entraîne la fin de l'appel entrant au moment de l'acceptation. L'appel est activement rejeté et terminé.

Workaround:

Le MS Teams Client et le client de l'UCC STARFACE doivent utiliser des dispositifs d'entrée/sortie audio différents. Celles-ci peuvent être effectuées dans les paramètres du client concerné.

Problèmes liés à la terminaison d'un appel

Ce problème se produit si le multiplexage RTCP est désactivé sur le SBC utilisé. Veuillez activer le multiplexage RTCP.

Problèmes de synchronisation du statut de présence 

  1. Supprimez toutes les cases à cocher dans la sélection de la liste des statuts de présence qui doivent être transférés à STARFACE en tant que MDN. Ensuite, cochez à nouveau les statuts souhaités.
  2. Si cela ne corrige pas l'erreur, déconnectez votre utilisateur et reconnectez-vous à l'application Teams.