Features

Mobile#

Hint

After the upgrade, the XPhone Connect 9 Mobile app is intended for migration purposes only. Please make sure that all users switch to the XPhone Connect 10 Mobile App. The development of the XPhone Connect 9 Mobile App will not be continued.

Video tutorial#

Softphone Mobile

Features#

An XPhone Connect Mobile user literally has his office phone in his pocket. The Mobile app offers the following features:

  • Chat

  • Journal

    • Calls

    • Faxes

    • Voicemails

    • Chat messages

  • Making calls with Softphone Mobile (inbound/outbound)

  • Access to the company address book

  • Push notifications for:

    • Calls

    • New faxes

    • New voicemails

    • New chat messages

  • TeamDesk

    • Managing your own status

    • Display of key performance indicators

Hints#

  • Network requirements

    • Make sure that the network is VoIP-ready to ensure optimum call quality.

    • Configure Quality of service in the network.

    • Read our KB article

    • Please note the different Hosting variants.

    • Here you can find out which concepts can be used for media streams:

      Softphone Mobile

      rtp-pf-mobile

      1. In this scenario, the signaling for Softphone Mobile takes place via the https connection to the IIS (WebClient API).

      2. STUN is used to determine the public IP addresses that are signalled to the communication partner for the RTP data streams.

      3. The XPhone Call Controller can be reached from the Internet (via NAT or UDP port forwarding for RTP audio streams).

        • It is irrelevant whether the XPhone Call Controller (XCC) is the integrated XCC on the Windows server or a remote XCC on a Linux satellite.

        • The XPhone Call Controller RTP port range can be freely configured (default is UDP 30000-33000).

        • In addition, Hole Punching may be necessary for restrictive NAT types.

      4. The RTP media stream is sent directly from the Mobile App to the XPhone Call Controller and vice versa.

      Softphone Mobile with TURN Server

      rtp-turn-mobile

      1. In this scenario, the signaling for Softphone Mobile takes place via the https connection to the IIS (WebClient API).

      2. STUN is used to determine the public IP addresses that are signalled to the communication partner for the RTP data streams.

      3. The XPhone Call Controller can be reached from the Internet (via NAT or UDP port forwarding for RTP audio streams).

        • It is irrelevant whether the XPhone Call Controller (XCC) is the integrated XCC on the Windows server or a remote XCC on a Linux satellite.

        • The XPhone Call Controller RTP port range can be freely configured (default is UDP 30000-33000)

        • In addition, Hole Punching may be necessary for restrictive NAT types.

      4. In this scenario, an additional TURN server is used to overcome the NAT routers or firewalls of the Mobile Apps.

        • The TURN Server uses various procedures (ICE) to overcome the firewall on the client side, so that an RTP data stream from the XPhone Server to the Mobile Apps is possible via the TURN Server.

      5. The RTP media stream is sent directly from the Mobile App to the XPhone Call Controller.

      Attention

      C4B does not provide a TURN server. This must be taken into consideration during the planning phase, as additional costs may be incurred. Currently, only the Xirsys.com TURN server is available for a fee. If you would like to use other TURN servers, please contact C4B Product Support.

    • With the Firewall Generator you can summarize all required Network policies in a PDF file.

  • Resources

  • PBX and SBCs

  • Push

    • The push notifications are required for signalling new calls for display-locked mobile devices and for number resolution.

  • WebClient API

    • The WebClient API must be accessible from the Internet.

    • Alternatively, the WebClient API can be installed on a separate server.

    • With Android, only encrypted connections to the XPhone server via SSL/TLS (HTTPS) are possible.

  • Mobile App

    • The mobile app is installed on the smartphone either via the Google Play Store or via the Apple App Store.

    • Supported operating systems

      • Android: from version 14

      • Apple iOS: from version 17.4

    Hint

    • For Mobile Device Management Systems or for the manual installation of XPhone Connect Mobile, the Android APK files are located on the installation medium under \Software\Apps\Android.

    • Please also update your mobile apps to make the most of the latest version of XPhone Connect.

    • Older mobile app versions (6, 7, 8) are not compatible with XPhone Connect Server 10.

      • Only the XPhone Connect 10 Mobile app is supported.

      • After the upgrade, the XPhone Connect 9 Mobile app is intended exclusively for migration purposes.

Configuration#

Mobile App#

The following configuration steps are required to put the mobile app into operation:

  1. General settings

    Configure URL

    • Call up the XPhone Connect Server Web-Administration:

      System settings > General > Web-API .

    • The URL is entered here:

      URL for access to XPhone Web-API

    • Enter the external URL in this format in the corresponding field:

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

      for example:

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

    • These URLs must be accessible from the Internet in order to connect the mobile app correctly.

      Please note the different hosting variants and HTTPS Certificate.
    Configure push notification

    • Navigate to in the Web-Administration:

      System settings > General > Mobile App .

    • For push notifications to work (see Features), the Enable push notification checkbox must be set.

    • Optionally, the Use proxy settings for sending push notifications checkbox can also be set.

      • To do this, configure the proxy server under System settings > General > Proxy settings.

    • In the firewall, allow outgoing connections to the following ports that are required for the XPhone Connect Mobile push notification services:

  1. Location settings

    Activate the mobile app for a configuration group/location

    • Open the Web-Administration and navigate to :

      User management > Location [> Configuration group]

    • Switch to the Settings tab.

    • Click on Connect Client.

    • Scroll to the Connect mobile client section.

    • Activate the Use mobile client checkbox.

    • Save your setting.

  2. User

    XPhone Connect Server login
    The XPhone Connect Server login is required to operate the Mobile Client and must be configured for each user.

    • You can configure the XPhone Connect Server login manually in the user:

      • Navigate to in the Web-Administration:

        User management > Location/Configuration group > User

      • Select a user via the checkbox checkbox to the left of the user name and click Edit. Alternatively, you can also click on the name:

      • The Change user dialog box opens.

        • Activate the checkbox:

          Permit XPhone Connect Server login

        • The login name is made up of the User Account > Logon name and the domain.

        • Configure a password. [1]

      • Save your settings.

    • Alternative:

App installation#

Installing the XPhone Connect Mobile app from the corresponding App Store:

Smartphone app available for:

  • iOS

  • Android

Search for XPhone Connect Mobile in the corresponding app-store and install it.

Logon#

Access data:

After successful installation of the XPhone Connect Mobile app, the access information must be entered.

  1. Start the XPhone Connect Client of the user who wants to connect to the Mobile App and click on Settings > Mobile Client in the top right-hand corner. A QR code is displayed.

  2. Start the app on your smartphone. The access information is required upon first start. Scan the displayed QR code:

    • To do this, tap Scan access information (You may have to enable the app to access the camera first).

    • Point the smartphone camera at the QR code and wait until the camera has focussed on and scanned the QR code.

  3. Enter your password in the mobile app. If you don’t know it, you can set a new XPhone Connect password. To do so, click Change in the XPhone Connect client under Settings > Mobile Client > Password.

  4. Now tap Login.

Editing access information:

If you want to scan the access data again, tap on the Start page in the XPhone Connect Mobile app that has been started and on Settings (cogwheel symbol) in the top right-hand corner. Select Display login dialog and log in again as described above.

Softphone Mobile#

The following configuration steps are required to put Softphone Mobile into operation:

  1. XPhone Call Controller [2]

    Use XPhone Call Controller locally or on a satellite

    • Using the local XPhone Call Controller

      • Open the Web-Administration and navigate to :

        System settings > Telephony & Meetings > Telephony > SIP > XCC

      • Edit the XCC and uncheck the Disabled checkbox.

      • Configure the XCC IP address and the XPhone server IP address.

    • Alternatively: Use XPhone Call Controller on a satellite

    • Configure the external UDP ports

      • Open the Web-Administration and navigate to :

        System settings > Telephony & Meetings > Telephony > SIP > XCC

      • For Softphone Mobile, Payload Separation and Meetings, the ports must be specified under RTP communication. These must be forwarded to the XCC in the firewall.

        Hint

        • If the default ports are changed, the XCC must be stopped and restarted.

        • Four ports are assumed for a conversation.

        • Three even ports are required per screen sharing participant in the meeting (the odd ones are used for RTCP).

  2. Dialling parameter [2]

    Create dialling parameters

    Hint

    Always create a separate dialling parameter for each CTI or SIP gateway.

  3. SIP trunk [2]

    SIP trunk set up

    • Open the Web-Administration and navigate to :

      System settings > Telephony & Meetings > Telephony > SIP

    • Click on New SIP trunk in the menu bar.

    • The Create new SIP trunk dialog box opens.

    • Configure the required Telephony gateway data for the SIP trunk and the previously created Dialling parameter.

      • Detailed instructions for setting up specific telephone systems can be found in chapter PBX/SBC Integration.

      • If your system is not listed, you can connect the XCC via a Native SIP Trunk.

    • If you plan to use Softphone Desktop or Softphone Mobile, you must activate the SIP connection XCC <-> XPhone Connect Server and configure the IP addresses.

      Tip

      • Loopback addresses are also permitted when using the local XCC

      • The ports must not collide with those of other SIP trunks

      • The ports entered here must be available in the network.

      • You can define standard IP addresses for the XCC and XPhone server in the XCC object. You can use these here with the Use default IP address checkbox.

      • The list of SIP gateways contains an entry with the name Internal gateway. This gateway is required for the audio and screen sharing connection in meetings. No configuration is required. However, it must be green so that the audio and screen sharing functions can be used.

    • If you plan to use AnyDevice, Softphone Desktop or Softphone Mobile in combination with your office phone, you should configure one of the two forwarding variants:

  4. Location settings

    Activate Softphone Mobile for a configuration group/location

    • Open the Web-Administration and navigate to :

      User management > Location [> Configuration group]

    • Switch to the Settings tab.

    • Click on the Telephony button.

    • Scroll to the AnyDevice / Softphone section.

    • Activate the Use softphone mobile checkbox.

    • Save your setting.

  5. Line [3]

    Set up AnyDevice / Softphone main line

    • Open the Web-Administration and navigate to :

      User management > Location [> Configuration group]

    • Switch to the User tab.

    • Select the desired users by activating the checkbox checkbox to the left of the user name.

    • Click on AnyDevice / Softphone configuration in the menu.

    • The AnyDevice / Softphone configuration wizard opens.

    • If several SIP gateways are set up, you will be asked which SIP gateway you would like to use.

      • Select the desired SIP gateway and click Next.

    • Select the New set-up radio button and click Next.

    • Choose one of the following options and click on Next:

      • Use AnyDevice / Softphone in addition to a CTI device.

      • Use AnyDevice / Softphone independently.

      • To change it later, follow the instructions under Change mode.

    • The requirements are checked.

      • If the requirements are not met, a warning symbol appears as a warning.

      • In this case, check the requirements and correct any errors. The info field shows exactly which requirement has not been met.

      • As soon as no more warnings are displayed, click on Next.

    • You will see a summary. If all the details are correct, click Finish.

  6. External media

    Configure STUN and TURN

    When using Softphone Mobile, the audio media (voice data) must be sent to the XCC via any route. The technology used for this is WebRTC.

Push notifications#

Activate and deactivate#

XPhone Connect Mobile App

  1. Start the app on your smartphone.

  2. On the Start page, tap Settings (burger menu). Activate Push notifications or deactivate them here.

  3. The settings are saved automatically.

XPhone Connect Server

  1. Start the Web-Administration

  2. Activate or deactivate the push notification on the server side under System settings > General > Mobile App.

  3. Then click Save.

Changing the destination port for iOS#

It is possible to use an alternative port 2197 instead of 443. In this case, in addition to the settings for the firewall shares, port 2197 must also be configured in the XPhone Connect Server. To do this, open the PushProxy subdirectory in the XPhone Connect Server program directory (by default: C:\Program Files\C4B\XPhone Connect Server). There you will find the file appsettings.json. Open this file with a 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": "*"
    }

  • Modify the URL:

    • from: https://api-push.apple.com/3/device

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

  • Save the changes and then open the Internet Information Services (IIS) Manager on the XPhone Connect Server.

    • e.g. via the XPhone Connect Server Manager under Tools > IIS Manager….

  • In the IIS Manager, select the Application Pool item and select XPhoneConnectPushProxy in the list of application pools.

  • Stop and start the highlighted application pool.

Your opinion matters!

Be it praise, helpful ideas, or a tip about an error – we truly appreciate every message.
Just send us an email at doku@c4b.de. And help us make this documentation even better.
Thank you very much for your support!