Manual

Phone - Softphone

The softphone application enables you to make and answer calls. It needs to be installed and running on every computer, which you want to use for VoIP calls.

Download

The softphone application can be downloaded from:

Install

Windows

To install the softphone application on Microsoft Windows follow the steps below:

Softphone Application Download

Figure 6.1 Softphone Application Download.
  1. Click the 'Download' link and save the file.

Softphone Application Run

Figure 6.2 Softphone Application Run.
  1. Locate and double click VoIPHome-ver.exe icon to start the set up program.

Softphone Windows Application Install

Figure 6.3 Softphone Windows Application Install.
  1. Wait for installation to complete.

Mac OS

To install the softphone application on a Mac follow the steps below:

  1. Download the VoIPHome-ver.dmg package and open it.

Softphone Mac OS Application Install

Figure 6.4 Softphone Mac OS Application Install.
  1. Drag and drop the VoIP Home icon into Applications folder.

Linux

deb

Follow the instructions below to install the softphone on Linux distribution using deb packages (Debian, Ubuntu, Mint etc.):

  1. Install the GPG key: wget -O - [http://repo.ssl7.net/repo/key](http://repo.ssl7.net/repo/key) | sudo apt-key add -
  2. Add repository: echo "deb [http://repo.ssl7.net/repo/voipstudio/stable/main/binary](http://repo.ssl7.net/repo/voipstudio/stable/main/binary) /" | sudo tee /etc/apt/sources.list.d/voipstudio.list
  3. Update and install: sudo apt-get update & sudo apt-get install voipstudio

Login

Softphone Application Login

Figure 6.5 Softphone Application Login.

To start making VoIP calls you need to login into the softphone application with your email and password (the same you use for web control panel). Enter your email address into field (1) and password into field (2). Click the 'Login' button (3) and verify that there is a green icon app-online.png in your taskbar which indicates that the application is running correctly - see Figure 6.6 below.

Softphone Application - status icon

Figure 6.6 Softphone Application - status icon.

Call Transfer

Softphone Application - Call Transfer

Figure 6.7 Softphone Application - Call Transfer.

In order to transfer a call to another user or external number:

  1. Click the Transfer button located in the bottom part of the active call panel.
  2. Select the transfer destination from your contacts list.
  3. Alternatively, enter the transfer destination number manually. This way you can transfer the call to any external number.
  4. Click Attended Transfer to put the active call on hold and place a call to the transfer destination. Once the transfer destination answers, click the Transfer button again to complete the transfer.
  5. Alternatively click Blind Transfer to make an instant call transfer without calling the destination number first.

Settings

General

Softphone Settings General

Figure 6.8 Softphone Settings General.
  1. Click the gear icon to open settings.
  2. Change the number of minutes before the softphone changes to away status due to inactivity.
  3. Select to enable/disable the automatic start of the softphone when the device starts up.

User Profile

Softphone Settings User Profile

Figure 6.9 Softphone Settings User Profile.
  1. Click the gear icon to open settings.
  2. Edit the first name or identifier of user.
  3. Edit the last name or second identifier of user.
  4. Edit the login and voicemail email address of user.
  5. Edit or enter the user's mobile number.
  6. Click 'Submit' to complete and save any changes.

Password

Softphone Settings Password

Figure 6.10 Softphone Settings Password.
  1. Click the gear icon to open settings.
  2. Enter the current password for authentication.
  3. Enter and confirm the new password.
  4. Click 'Submit' to complete and save any changes.

Incoming Call Options

Softphone Settings Incoming Call Options

Figure 6.11 Softphone Settings Incoming Call Options.
  1. Click the gear icon to open settings.
  2. Select the time before an incoming call is transferred to a destination if it is unanswered.
  3. Enable or disable call waiting.
  4. Select the action when an incoming call is not answered.
  5. Click 'Submit' to complete and save any changes.

Voicemail

Softphone Settings Voicemail

Figure 6.12 Softphone Settings Voicemail.
  1. Click the gear icon to open settings.
  2. Select to enable email notification with an audio file attachment of voicemail message.
  3. Select to enable transcription of voicemail message to text.
  4. Click 'Add' to upload a new voicemail greeting message and 'Play' to listen to the current greeting.
  5. If multiple files are uploaded, the active message can be selected from the dropdown list.
  6. Click 'Submit' to complete and save any changes.

Call Forwarding

Softphone Settings Call Forwarding

Figure 6.13 Softphone Settings Call Forwarding.
  1. Click gear icon to open settings.
  2. Click to enable call forwarding.
  3. Click to enable forwarding for direct calls only. If disabled, calls from ring groups and queue's will be forwarded too.
  4. Enable the use of # as the confirmation of forwarded calls on the receiving device.
  5. If a VoIP Phone is online, a specified time can be set to ring the VoIP device first before call forwarding starts.
  6. Select remote(callers) or local(VoIP) number to be displayed as caller ID on the receiving device.
  7. Add, Play or Upload Message played to caller before call is forwarded.
  8. Enter and add number(s) to forward calls to.
  9. If multiple numbers are available for forwarding, a ring strategy can be used to manage call distribution.
  10. Select how long a forwarded call will ring before going to 'No Answer'.
  11. Select an action to be taken if a call is not answered.
  12. Click 'Submit' to complete and save any changes.

Member of

Softphone Settings Member Of

Figure 6.14 Softphone Settings Member Of.
  1. Click Gear Icon to Open Settings.
  2. As VoIPHome is meant for individual users, extensions can not be member of any queue or group.

Audio Devices

Softphone Settings Audio Devices

Figure 6.15 Softphone Settings Audio Devices.
  1. Click gear icon to open settings.
  2. Change microphone settings.
  3. Change call audio settings.
  4. Select ringer device.
  5. Select webcam or other video device.

Advanced

Softphone Settings Advanced

Figure 6.16 Softphone Settings Advanced.
  1. Click gear icon to open settings.
  2. Enable automatic update checks.
  3. Enable compact view of active calls.
  4. Call and softphone window will always be at the front of other windows or applications.
  5. Enable volume levels to be controlled automatically.
  6. Enable the application to use default gateway settings only.

Troubleshooting

Below is a listing of commonly asked questions and answers and basic troubleshooting steps for the softphone application.

Invalid email / password

"Wrong email/password entered" message displayed when I try to login.

Make sure that the email address and password is the same you use to login into the control panel at https://voiphome.com/login/. If you forgot your password, go to https://voiphome.com/recover-password/ and we will send a new password to your email address.

Firewall

"Firewall error" message displayed when I try to make calls.

Softphone WebRTC Test

Figure 6.17 Softphone WebRTC Test.

Some ISPs (Internet Service Providers) block UDP ports which are required for our softphone application to work. To check if your computer can successfully connect to our network:

  1. Click main menu icon.
  2. Select Help from the contact menu.
  3. Select Troubleshooting... from the Help sub-menu.
  4. Click WebRTC Test tab.
  5. Click Start Test button.

After few moments you will see a list of ports being tested. If any shows connection and Failed you will need to inspect your firewall / router configuration and/or contact your Internet Service Provider to have the ports unblocked.

Reporting a problem

Softphone report problem

Figure 6.18 Softphone report problem.

To report a problem with a softphone application or calls made / received:

  1. Click the main menu icon.
  2. Select Help from the contact menu.
  3. Select Report a problem from the Help sub-menu.
  4. Enter the details of the issue. If a problem relates to a particular phone call make sure to include the date and time of the calls and number dialled (for outbound calls) or caller ID for inbound calls.
  5. Click the Submit button to open a support ticket.