Groundwire Softclient

Groundwire is a paid SIP softclient for both iOS and Android, which is compatible with Compass. This guide explains how to set up the app correctly.

Versions tested

Groundwire for iOS: version 3.8.1

Groundwire for Android: version 5.2.4

Preparation

Make sure to add a softphone to Compass before adding an account in Groundwire.

  • Go to Phones > Add Phone and select Phone model Generic SIP Softphone. Enter a name and click Save.

Setting up Groundwire on an iOS device

Download and install Groundwire from the Apple App Store.

When installed open Groundwire. If opted, allow push notifications or go to the phone's Settings > Groundwire > Notifications and enable Allow Notifications. In the 'Add new account' screen, select Generic SIP account. Keep the softphone's status page in Compass ready for setting up the Groundwire account and enter the following:

  • Title: Enter a descriptive name for the account. This is the account name visible in the app
  • Username: Enter the username found in the softphone's status in Compass
  • Password: Enter the password found in the softphone's status in Compass
  • Domain: Enter the domain on which the softphone is registered within Compass, found in the softphone's status in Compass under Registrar/proxy
  • Display name: Can be left empty because display names are overwritten by Compass
  • Incoming calls: Set Use Global Setting when in the general settings Incoming calls are set to Push Notifications. This ensures that this is set equally for all accounts. Or set to Push Notifications if multiple accounts with different push settings is preferred.

Tap Advanced settings and set the following options:

  • NAT Traversal: Set to auto. Tap and make sure Send Keepalives is turned on. Keepalive Period is best set to 25 seconds to comply with Compass settings. Outbound Proxy must be set to the Outbound proxy in the softphone's status in Compass.
  • Codecs: Enable Opus*, G.722, GSM, G.711 mu-law and G.711 A-law, preferably in that order. These codecs are supported by Compass. * = support for Opus is expected in a future version of Compass. Set Packet time to 20ms
  • Network constraint: in areas with 4G coverage, select Mobile data for best performance
  • Outgoing calls need registration: Defaults to enabled
  • Transport Protocol: Make sure this is set to UDP.
  • Voicemail Number: Set to 1233. If there is a new voicemail message, a blue voicemail button will be added in the Keypad screen. When this button is tapped, the set voicemail number will be called enabling the user to log in to the voicemail box and listen to the messages. On the Accounts overlay (tap account name in Keypad screen) the number of voicemails is visible behind the account name.
  • Push Options: Single instance should be enabled
  • DTMF Mode: Only RFC 2833 is supported.
  • Expires: Set to 3600 to comply with Compass registration period.
  • Call waiting: This option can be enabled to be able to receive calls while already in a call.

When finished tap Done to go back to the Account Details, then tap Save. The new account is visible in the Accounts screen. Tap <Settings, then Done to go to the Keypad screen. When the account is successfully set up, the account name will turn green when connected. The Groundwire account acts as though it is a generic desktop telephone. Log a user in by dialing *1, followed by the user's extension and PIN code if applicable.

Setting up Groundwire on an Android device

Download and install Groundwire from Google Play.

Start Groundwire and agree to the Personal Data Protection policy. Give the proper app permissions. In the Add new account screen, choose New SIP account. Keep the softphone's status page in Compass ready for setting up the Groundwire account and enter the following:

  • Title: Enter a descriptive name for the account. This is the account name visible in the app
  • Username: Enter the username found in the softphone's status in Compass
  • Password: Enter the password found in the softphone's status in Compass
  • Domain: Enter the domain on which the softphone is registered within Compass, found in the softphone's status in Compass under Registrar/proxy
  • Display name: can be left empty because display names are overwritten by Compass

Tap Advanced settings and set the following options:

  • Incoming calls: Set Use Global Setting when in the general settings Incoming calls are set to Push Notifications. This ensures that this is set equally for all accounts. Or set to Push Notifications if multiple accounts with different push settings is preferred.
  • NAT traversal: Set to auto. Tap and make sure Send Keepalives is turned on. Keepalive Period is best set to 25 seconds to comply with Compass settings. Outbound Proxy must be set to the Outbound proxy in the softphone's status in Compass.
  • Transport Protocol: Make sure this is set to UDP.
  • Codecs: Enable Opus*, G.722, GSM, G.711 mu-law and G.711 A-law, preferably in that order. These codecs are supported by Compass. * = support for Opus is expected in a future version of Compass. Set Packet time to 20ms
  • Network constraint: in areas with 4G coverage, select Mobile data for best performance
  • Outgoing calls need registration: Defaults to enabled
  • Voicemail Number: Set to 1233. If there is a new voicemail message, a blue voicemail button will be added in the Keypad screen. When this button is tapped, the set voicemail number will be called enabling the user to log in to the voicemail box and listen to the messages. On the Accounts overlay (tap account name in Keypad screen) the number of voicemails is visible behind the account name.
  • Push options: Single registration should be enabled
  • DTMF Mode: Only RFC 2833 is supported.
  • Expires: Set to 3600 to comply with Compass registration period.

When finished tap the check mark to go back to the Accounts screen. The new account is visible in the Accounts screen. Tap back arrow to go to the Keypad screen. When the account is successfully set up, the indicator next to the account name will turn green when connected. The Groundwire account acts as though it is a generic desktop telephone. Log a user in by dialing *1, followed by the user's extension and PIN code if applicable.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.