Features

Mobile#

Hinweis

Nach dem Upgrade ist die XPhone Connect 9 Mobile App ausschließlich für Migrationszwecke vorgesehen. Bitte stellen Sie sicher, dass alle Benutzer auf die XPhone Connect 10 Mobile App wechseln. Die Entwicklung der XPhone Connect 9 Mobile App wird nicht fortgesetzt.

Video Tutorial#

Softphone Mobile

Leistungsmerkmale#

Ein XPhone Connect Mobile Benutzer hat sprichwörtlich sein Bürotelefon in der Tasche. Folgende Leistungsmerkmale bietet die Mobile App:

  • Chat

  • Journal

    • Anrufe

    • Faxe

    • Voicemails

    • Chatnachrichten

  • Mit Softphone Mobile telefonieren (inbound/outbound)

  • Zugriff auf das Firmen-Adressbuch

  • Push-Benachrichtigungen für:

    • Anrufe

    • Neue Faxe

    • Neue Voicemails

    • Neue Chatnachrichten

  • TeamDesk

    • Verwaltung des eigenen Status

    • Anzeige der Key-Performance-Indikatoren

Hinweise#

  • Netzwerkanforderungen

    • Stellen Sie sicher, dass das Netzwerk VoIP-ready ist, um eine optimale Gesprächsqualität zu gewährleisten.

    • Konfigurieren Sie Quality of service im Netzwerk.

    • Lesen Sie unseren KB-Artikel

    • Beachten Sie die unterschiedlichen Hosting Varianten.

    • Hier erfahren Sie, welche Konzepte für Medienströme verwendet werden können:

      Softphone Mobile

      rtp-pf-mobile

      1. In diesem Szenario findet die Signalisierung für Softphone Mobile über die https-Verbindung zum IIS statt (WebClient-API).

      2. Über STUN werden die öffentlichen IP-Adressen ermittelt, die für die RTP-Datenströme dem Kommunikationspartner signalisiert werden.

      3. Der XPhone Call Controller ist aus dem Internet erreichbar (via NAT oder UDP-Port-Forwarding für RTP-Audioströme).

        • Hierbei ist es unerheblich, ob es sich bei dem XPhone Call Controller (XCC) um den Integrierten XCC auf dem Windows Server, oder einen ausgelagerten XCC auf einem Linux Satelliten, handelt.

        • Der XPhone Call Controller RTP-Port-Bereich kann frei konfiguriert werden (Default ist UDP 30000-33000).

        • Zusätzlich kann ggf. Hole Punching bei restriktiven NAT-Typen nötig sein.

      4. Der RTP-Medien-Stream erfolgt direkt von der Mobile App zum XPhone Call Controller und umgekehrt.

      Softphone Mobile mit TURN-Server

      rtp-turn-mobile

      1. In diesem Szenario findet die Signalisierung für Softphone Mobile über die https Verbindung zum IIS statt (WebClient-API).

      2. Über STUN werden die öffentlichen IP-Adressen ermittelt, die für die RTP-Datenströme dem Kommunikationspartner signalisiert werden.

      3. Der XPhone Call Controller ist aus dem Internet erreichbar (via NAT oder UDP-Port-Forwarding für RTP-Audioströme).

        • Hierbei ist es unerheblich, ob es sich bei dem XPhone Call Controller (XCC) um den Integrierten XCC auf dem Windows Server, oder einen ausgelagerten XCC auf einem Linux Satelliten, handelt.

        • Der XPhone Call Controller RTP-Port-Bereich kann frei konfiguriert werden (Default ist UDP 30000-33000)

        • Zusätzlich kann ggf. Hole Punching bei restriktiven NAT-Typen nötig sein.

      4. In diesem Szenario wird ein zusätzlicher TURN-Server verwendet, um die NAT-Router oder Firewalls der Mobile Apps zu überwinden.

        • Der TURN-Server verwendet verschiedene Verfahren (ICE), um die Firewall auf der Client-Seite zu überwinden, so dass ein RTP-Datenstrom vom XPhone Server zu den Mobile Apps über den TURN-Server möglich ist.

      5. Der RTP-Medien-Stream wird direkt von der Mobile App zum XPhone Call Controller gesendet.

      Achtung

      C4B stellt keinen TURN-Server zur Verfügung. Hieran muss in der Planungsphase unbedingt gedacht werden, denn es können u.U. weitere Kosten anfallen. Zur Zeit ist ausschließlich der kostenpflichtige Xirsys.com TURN-Server freigegeben. Möchten Sie andere TURN-Server verwenden, so fragen Sie bitte den C4B Produktsupport.

    • Mit dem Firewall-Generator können Sie alle erforderlichen Netzwerkfreigaben in einer PDF-Datei zusammenfassen.

  • Ressourcen

  • PBX und SBCs

  • Push

    • Die Push-Benachrichtigungen werden für die Signalisierung neuer Anrufe bei gesperrten Mobilgeräten sowie die Rufnummernauflösung benötigt.

  • WebClient API

    • Die WebClient-API muss aus dem Internet erreichbar sein.

    • Alternativ kann die WebClient-API auf einem separaten Server installiert werden.

    • Mit Android sind ausschließlich verschlüsselte Verbindungen zum XPhone Server über SSL/TLS (HTTPS) möglich.

  • Mobile App

    • Die Installation der Mobile App geschieht auf dem Smartphone entweder über den Google Play Store oder über den Apple App Store.

    • Unterstützte Betriebssysteme

      • Android: ab Version 14

      • Apple iOS: ab Version 17.4

    Hinweis

    • Für Mobile Device Management Systeme oder für die manuelle Installation von XPhone Connect Mobile liegen die Android APK-Dateien auf dem Installationsmedium unter \Software\Apps\Android.

    • Aktualisieren Sie auch Ihre Mobile Apps, um die neueste Version von XPhone Connect optimal nutzen zu können.

    • Ältere Mobile-App-Versionen (6, 7, 8) sind nicht mit dem XPhone Connect Server 10 kompatibel.

      • Unterstützt wird ausschließlich die XPhone Connect 10 Mobile App.

      • Nach dem Upgrade ist die XPhone Connect 9 Mobile App ausschließlich für Migrationszwecke vorgesehen.

Konfiguration#

Mobile App#

Um die Mobile App in Betrieb zu nehmen, sind folgende Konfigurationsschritte erforderlich:

  1. Allgemeine Einstellungen

    URL konfigurieren

    • Rufen Sie die XPhone Connect Server Administration auf:

      Systemeinstellungen > Allgemein > Web-API .

    • Hier wird die URL eingetragen:

      URL für den Zugriff auf XPhone Web-API

    • Geben Sie im entsprechenden Feld die externe URL in diesem Format ein:

      https://[meine-firma.de][:Port]/xphoneconnect/webclientapi

      zum Beispiel:

      https://meine-firma.de:8443/xphoneconnect/webclientapi
https://meine-firma.de/xphoneconnect/webclientapi

    • Diese URLs müssen aus dem Internet erreichbar sein, um die Mobile App korrekt zu verbinden.

      Beachten Sie die unterschiedlichen Hosting Varianten und HTTPS-Zertifikat.
    Push-Benachrichtigung konfigurieren

    • Navigieren Sie in der Web-Administration zu:

      Systemeinstellungen > Allgemein > Mobile App .

    • Damit Push-Benachrichtigungen funktionieren (siehe Leistungsmerkmale), muss die Checkbox Push-Benachrichtigung aktivieren gesetzt werden.

    • Optional kann auch die Checkbox Proxy-Einstellungen für den Versand von Push-Benachrichtigungen verwenden gesetzt werden.

      • Konfigurieren Sie dafür unter Systemeinstellungen > Allgemein > Proxy-Einstellungen den Proxy Server.

    • Erlauben Sie in der Firewall ausgehende Verbindungen zu den folgenden Ports, die für die Push-Benachrichtigungsdienste von XPhone Connect Mobile erforderlich sind:

  1. Standort Einstellungen

    Aktivieren Sie die Mobile App für eine/n Konfigurationsgruppe/Standort

    • Öffnen Sie die Web-Administration und navigieren Sie zu:

      Benutzerverwaltung > Standort [> Konfigurationsgruppe]

    • Wechseln Sie zum Reiter Einstellungen.

    • Klicken Sie auf Connect Client.

    • Scrollen Sie zum Abschnitt Connect Mobile-Client.

    • Aktivieren Sie die Checkbox Mobile Client verwenden.

    • Speichern Sie Ihre Einstellung.

  2. Benutzer

    XPhone Connect Server Anmeldung
    Die XPhone Connect Server Anmeldung ist für den Betrieb des Mobile-Clients erforderlich und muss bei jedem Benutzer konfiguriert werden.

    • Die XPhone Connect Server Anmeldung können Sie manuell im Benutzer konfigurieren:

      • Navigieren Sie in der Web-Administration zu:

        Benutzerverwaltung > Standort/Konfigurationsgruppe > Benutzer

      • Wählen Sie einen Benutzer über die Checkbox checkbox links neben dem Benutzernamen aus und klicken auf Bearbeiten. Alternativ können Sie auch den Namen anklicken:

      • Es öffnet sich das Dialogfenster Benutzer bearbeiten.

        • Aktivieren Sie die Checkbox:

          XPhone Connect Server Anmeldung zulassen

        • Der Anmeldename setzt sich aus dem Benutzer > Anmeldenamen und der Domäne zusammen.

        • Konfigurieren Sie ein Kennwort. [1]

      • Speichern Sie Ihre Einstellungen.

    • Alternativ:

App Installation#

Installation der XPhone Connect Mobile App aus dem jeweiligen App Store:

Die Mobile App ist verfügbar für:

  • iOS

  • Android

Suchen Sie im entsprechenden App-Store nach XPhone Connect Mobile und installieren Sie die App.

Anmeldung#

Zugangsdaten:

Nach erfolgreicher Installation der XPhone Connect Mobile App, ist es notwendig, die Zugangsdaten einzutragen.

  1. Starten Sie den XPhone Connect Client des Benutzers, der sich mit der Mobile App verbinden möchte, und klicken oben rechts auf Einstellungen > Mobiler Client. Ein QR-Code wird Ihnen angezeigt.

  2. Starten Sie die App auf Ihrem Smartphone. Beim ersten Start werden die Zugangsdaten abgefragt. Scannen Sie den angezeigten QR-Code ab:

    • Tippen Sie dazu auf Anmeldedaten scannen (Es kann sein, dass Sie den Zugriff der App auf die Kamera zunächst erlauben müssen).

    • Richten Sie die Kamera des Smartphones auf den QR-Code und warten Sie, bis die Kamera den QR-Code scharf gestellt und gescannt hat.

  3. Geben Sie Ihr Kennwort in der Mobile App ein. Wenn Ihnen das Kennwort nicht bekannt ist, können Sie ein neues XPhone Connect Kennwort vergeben. Klicken Sie dazu im XPhone Connect Client unter Einstellungen > Mobiler Client > Kennwort auf Ändern.

  4. Tippen Sie auf Anmelden.

Zugangsdaten bearbeiten:

Wenn Sie die Zugangsdaten erneut scannen wollen, tippen Sie in der gestarteten XPhone Connect Mobile App auf die Seite Start und oben rechts auf Einstellungen (Zahnradsymbol). Wählen Sie hier Anmeldedialog anzeigen und melden sich wie oben beschrieben erneut an.

Softphone Mobile#

Um Softphone Mobile in Betrieb zu nehmen, sind folgende Konfigurationsschritte erforderlich:

  1. XPhone Call Controller [2]

    XPhone Call Controller lokal oder auf einem Satelliten verwenden

    • Lokalen XPhone Call Controller verwenden

      • Öffnen Sie die Web-Administration und navigieren Sie zu:

        Systemeinstellungen > Telefonie & Meetings > Telefonie > SIP > XCC

      • Bearbeiten Sie den XCC und entfernen Sie das Häkchen in der Checkbox Deaktiviert.

      • Konfigurieren Sie die XCC IP-Adresse und die XPhone Server IP-Adresse.

    • Alternativ: XPhone Call Controller auf einem Satelliten betreiben

    • Konfigurieren Sie die externen UDP Ports

      • Öffnen Sie die Web-Administration und navigieren Sie zu:

        Systemeinstellungen > Telefonie & Meetings > Telefonie > SIP > XCC

      • Für Softphone Mobile, Payload Separation und Meetings müssen die Ports unter RTP-Kommunikation angegeben werden. Diese müssen in der Firewall auf den XCC weitergeleitet werden.

        Hinweis

        • Werden die voreingestellten Ports geändert, muss der XCC beendet und neu gestartet werden.

        • Für ein Gespräch werden 4 Ports angenommen.

        • Pro Screensharing-Teilnehmer im Meeting werden drei gerade Ports benötigt (die ungraden werden für RTCP verwendet).

  2. Wahlparameter [2]

    Wahlparameter erstellen

    • Öffnen Sie die Web-Administration und navigieren Sie zu:

      Systemeinstellungen > Telefonie & Meetings > Telefonie > Wahlparameter

    • Klicken Sie im Menü auf Neuer Wahlparameter.

    • Es öffnet sich das Dialogfenster Neuen Wahlparameter erstellen.

    • Hinterlegen Sie die erforderlichen Daten des Wahlparameters.

    • Speichern Sie die Einstellungen.

    Hinweis

    Erstellen Sie für jedes CTI- oder SIP-Gateway immer jeweils einen eigenen Wahlparameter.

  3. SIP-Trunk [2]

    SIP-Trunk einrichten

    • Öffnen Sie die Web-Administration und navigieren Sie zu:

      Systemeinstellungen > Telefonie & Meetings > Telefonie > SIP

    • Klicken Sie in der Menüleiste auf Neuer SIP-Trunk.

    • Es öffnet sich das Dialogfenster Neuen SIP-Trunk erstellen.

    • Konfigurieren Sie die erforderlichen Daten des Telefonie-Gateways für den SIP-Trunk und den zuvor erstellten Wahlparameter.

      • Detaillierte Anleitungen zur Einrichtung spezifischer Telefonsysteme finden Sie im Kapitel PBX/SBC Integration.

      • Sollte Ihr System nicht dabei sein, können Sie den XCC über einen Native SIP Trunk anbinden.

    • Wenn Sie planen Softphone Desktop oder Softphone Mobile zu verwenden, müssen Sie die SIP-Verbindung XCC <-> XPhone Connect Server aktivieren und die IP-Adressen konfigurieren.

      Tipp

      • Bei der Verwendung des lokalen XCCs sind auch Loopback-Adressen erlaubt.​

      • Die Ports dürfen nicht mit denen anderer SIP-Trunks kollidieren.​

      • Die hier eingetragenen Ports müssen im Netzwerk verfügbar sein.

      • Sie können im XCC-Objekt Standard-IP-Adressen für den XCC- und den XPhone-Server definieren. Diese können Sie hier mit der Checkbox Standard-IP-Adresse verwenden nutzen.

      • In der Liste der SIP-Gateways befindet sich ein Eintrag mit dem Namen Internal gateway. Dieses Gateway wird für die Audio- und Screensharing-Verbindung in Meetings benötigt. Eine Konfiguration ist nicht erforderlich. Es muss jedoch grün sein, damit die Audio- und Screensharing-Funktionen genutzt werden können.

    • Wenn Sie planen AnyDevice, Softphone Desktop oder Softphone Mobile in Kombination mit Ihrem Bürotelefon zu verwenden, sollten Sie eine der beiden Umleitungsvarianten konfigurieren:

  4. Standort Einstellungen

    Aktivieren Sie Softphone Mobile für eine/n Konfigurationsgruppe/Standort

    • Öffnen Sie die Web-Administration und navigieren Sie zu:

      Benutzerverwaltung > Standort [> Konfigurationsgruppe]

    • Wechseln Sie zum Reiter Einstellungen.

    • Klicken Sie auf Telefonie.

    • Scrollen Sie zum Abschnitt AnyDevice / Softphone.

    • Aktivieren Sie die Checkbox Softphone Mobile verwenden.

    • Speichern Sie Ihre Einstellung.

  5. Leitung [3]

    AnyDevice / Softphone-Hauptleitung einrichten

    • Öffnen Sie die Web-Administration und navigieren Sie zu:

      Benutzerverwaltung > Standort [> Konfigurationsgruppe]

    • Wechseln Sie zum Reiter Benutzer.

    • Wählen Sie die gewünschten Benutzer aus, indem Sie die Checkbox checkbox links neben dem Benutzernamen aktivieren.

    • Klicken die im Menü auf AnyDevice / Softphone-Konfiguration.

    • Der AnyDevice / Softphone-Konfigurationsassistent öffnet sich.

    • Falls mehrere SIP-Gateways eingerichtet sind, werden Sie gefragt, welches SIP-Gateway Sie verwenden möchten.

      • Wählen Sie das gewünschte SIP-Gateway aus und klicken Sie auf Weiter.

    • Wählen Sie den Radiobutton Neueinrichtung aus und klicken Sie auf Weiter.

    • Entscheiden Sie sich für eine der folgenden Optionen und klicken Sie auf Weiter:

      • AnyDevice / Softphone zusätzlich zu einem CTI-Gerät verwenden.

      • AnyDevice / Softphone eigenständig verwenden.

      • Zum nachträglichen Ändern folgen Sie der Anleitung unter Modus wechseln.

    • Die Voraussetzungen werden überprüft.

      • Falls die Voraussetzungen nicht erfüllt sind, erscheint ein warning-Symbol als Warnhinweis.

      • Überprüfen Sie in diesem Fall die Voraussetzungen und beheben Sie eventuelle Fehler. Im Info-Feld wird genau angezeigt, welche Voraussetzung nicht erfüllt ist.

      • Sobald keine Warnungen mehr angezeigt werden, klicken Sie auf Weiter.

    • Sie sehen eine Zusammenfassung. Wenn alle Angaben korrekt sind, klicken Sie auf Fertigstellen.

  6. Externe Medien

    STUN und TURN konfigurieren

    Bei der Verwendung von Softphone Mobile müssen die Audio-Medien (Sprachdaten) auf einem beliebigen Weg zum XCC gelangen. Die Technik die hierbei verwendet wird ist WebRTC.

Push-Benachrichtigungen#

Aktivieren und deaktivieren#

XPhone Connect Mobile App

  1. Starten Sie die App auf Ihrem Smartphone.

  2. Tippen Sie auf die Seite Start und oben links auf Einstellungen (Burger-Menü). Aktivieren Sie die Push-Benachrichtigungen bzw. deaktivieren Sie sie hier.

  3. Die Einstellungen werden automatisch gespeichert.

XPhone Connect Server

  1. Starten Sie die Web-Administration

  2. Aktivieren bzw. Deaktivieren Sie unter Systemeinstellungen > Allgemein > Mobile App die Push-Benachrichtigung serverseitig.

  3. Klicken Sie abschließend auf Speichern.

Ändern des Ziel Ports für iOS#

Es gibt die Möglichkeit einen alternativen Port 2197 statt 443 zu nutzen. In diesem Fall muss zusätzlich zu den Einstellungen für die Firewall-Freigaben der Port 2197 auch im XPhone Connect Server konfiguriert werden. Öffnen Sie dazu im XPhone Connect Server Programmverzeichnis (im Standard: C:\Programme\C4B\XPhone Connect Server) das Unterverzeichnis PushProxy. Dort befindet sich die Datei appsettings.json. Öffnen Sie diese Datei mit einem Text-Editor.

appsettings.json#
    {
      "AppSettings": {
            "Secret": "XXX",
            "C4BPushCertificatesApi": "https://mobile.c4b.de/pushconfig/",
            "C4BPushCertificatesApiTimeoutInSeconds": 30,
            "CertCachePeriodInMinutes": 1440,
            "ApplePushNotificationService": "https://api.push.apple.com/3/device/",
            "PushRequestTimeoutInSeconds": 30
      },
      "Logging": {
            "LogLevel": {
              "Default": "Information",
              "Microsoft": "Warning",
              "Microsoft.Hosting.Lifetime": "Information"
            }
      },
      "AllowedHosts": "*"
    }

  • Ändern Sie die URL:

    • von: https://api.push.apple.com/3/device

    • zu: https://api.push.apple.com:2197/3/device

  • Speichern Sie die Änderungen und öffnen Sie anschließend den Internetinformationsdienste (IIS)-Manager auf dem XPhone Connect Server.

    • z.B. über den XPhone Connect Server Manager unter Tools > IIS Manager….

  • Markieren Sie im IIS-Manager den Punkt Anwendungspool und markieren Sie in der Liste der Anwendungspools XPhoneConnectPushProxy.

  • Beenden Sie dann den ausgewählten Anwendungspool und starten ihn neu.

Ihre Meinung zählt!

Ob Lob, hilfreiche Ideen oder ein Hinweis auf einen Fehler - wir freuen uns über jede Nachricht.
Schreiben Sie uns einfach an doku@c4b.de und helfen Sie mit, diese Dokumentation noch besser zu machen.
Vielen Dank für Ihre Unterstützung!