Introduction


At the end of this article, you will be able to configure a SIP Device from your PBX to the ZoiPer freeware softphone application which is a third-party service, any license fees to unlock premium features inside the softphone are the responsibility of the customer and are not included in your PBX service subscriptions. The article will also assist you with the softphone installation process. Should you need any assistance, feel free to contact our support department.

 

Configuring a PBX SIP device with ZoiPer desktop


ZoiPer is a softphone application which allows you to place audio and video calls through your service provider. The application is support on Windows, Mac, Android and iOS. For the ZoiPer configuration, firstly you should download the application from the website https://www.zoiper.com/en/voip-softphone/download/current and select your operating system.

 

zoiper1.JPG

 

Once downloaded, run the installation file on your desktop with all the standard settings. After that, log into your customer portal and click on the PBX tab. This is achieved by clicking on the SIP devices option at the bottom left corner of the page. Then select the SIP device you would like to configure to the softphone application. The SIP device information will be displayed as shown in the image below. It is important to remember only a single SIP device can be connected to a single handset or softphone at a time, registering the same account details to 2 devices will cause your IP address to become blocked for 15 minutes. 

 

zoiper3.JPG

 

Next, you should enter the chosen device information on the ZoiPer application. Firstly, the SIP login and the SIP password. Should you enter the password incorrectly it is important you fix the password and wait 15 minutes before attempting to reconnect. 

 

zoiper2.JPG

 

Then the SIP server which the ZoiPer application will connect to. Please note that you must enter the port number to the end of the SIP server address using a colon then the port number, as an example sipm6.au.voipcloud.online:7060

 

zoiper5.JPG

 

Now you have entered the connection details the device should change status from offline to online on the customer portal.

 

zoiper7.JPG

 

Additionally, it is necessary to access the account configuration on the ZoiPer application and update the transport configuration. Accessing the advanced configurations and update the transport protocol to TCP instead of UDP, on the network settings. Utilising UDP for the transport protocol has the potential to cause issues with the softphone de-registering periodically. 

 

zoiper9.JPG

 

Configuring a PBX SIP device with ZoiPer for iPhone iOS

 

There are a couple of ways in which you can configure ZoiPer on iOS but to start you must download ZoiPer from your app store. Log into your customer portal and select the SIP device you would like to configure. Now use the QR code which will automatically register the device. 

zoiperiphone.JPG

Open the ZoiPer application and click the QR button on the top left of your smartphone as shown in point 2 of the screenshot below. Point the camera of your smartphone to the QR code on the screen and the device will connect automatically. 


step123.JPG


If you are having trouble connecting using the QR code the second option is to register the account manually. Open the ZoiPer application on your smartphone, click on the settings and then the accounts option as shown in the screenshot above.

 

zoiperiphone2.JPG

 

Click on the plus button and accept the warning. Manually enter in the SIP login, SIP password and SIP server. Please note that you must enter the port number to the end of the SIP server address using a colon then the port number, as an example sipm6.au.voipcloud.online:7060. This is shown in the screenshot below and should you enter the password incorrectly it is important you fix the password and wait 15 minutes before attempting to reconnect. Additionally, it is important to remember only a single SIP device can be connected to a single handset or softphone at a time, registering the same account details to 2 devices will cause your IP address to become blocked for 15 minutes. 

step456.JPG

 

The next step is to update the transport protocol from UDP to TCP, selecting "Network Settings" on the additional settings section, as shown in the screenshot above. The devices will now appear online inside your PBX portal. 

 

zoiperiphone3.JPG

 

The additional configuration should be set on your device as shown in the screenshot below, it is recommended to enable the notifications, background app refresh and cellular data for ZoiPer. On top of this, it is essential that the transport protocol is TCP rather than UDP. Lastly, clicking on "incoming calls" on the settings tab, you can enable the push notification, which is a remote server to keep alive the SIP connection, even when the app is running in the background. Some of these settings may require an upgrade to ZoiPer premium, this fee is not covered by any PBX license fees. 

 

789.JPG

 

Please note that due to recent changes on Apple iOS devices, incoming calls on ZoiPer will no longer work reliably in the background under any set of conditions configured. The only way to have reliability is by utilising APNS on iOS, for further information see the link https://www.zoiper.com/en/support/home/article/205/Zoiper%20Push%20Proxy.

 

Configuring a PBX SIP device with ZoiPer for Android

 

There are a couple of ways in which you can configure ZoiPer on Android but to start you must download ZoiPer from the play store. Login to your customer portal and select the SIP device you would like to configure. Now use the QR code which will automatically register the device. 

zoiperiphone.JPG

Open the ZoiPer application and click the QR button on the top left of your smartphone as shown in point 2 of the screenshot below. Point the camera of your smartphone to the QR code on the screen and the device will connect automatically. 


step123.JPG


If you are having trouble connecting using the QR code the second option is to register the account manually. Open the ZoiPer application on your smartphone, click on the settings and then the accounts option as shown in the screenshot above.

 

zoiperiphone2.JPG

 

Click on the plus button and accept the warning. Manually enter in the SIP login, SIP password and SIP server. Please note that you must enter the port number to the end of the SIP server address using a colon then the port number, as an example sipm6.au.voipcloud.online:7060. This is shown in the screenshot below and should you enter the password incorrectly it is important you fix the password and wait 15 minutes before attempting to reconnect. Additionally, it is important to remember only a single SIP device can be connected to a single handset or softphone at a time, registering the same account details to 2 devices will cause your IP address to become blocked for 15 minutes. 
 

step456.JPG

 

The next step is to update the transport protocol from UDP to TCP, selecting "Network Settings" on the additional settings, as shown in the screenshot above. The devices will now appear online inside your PBX portal. 

 

zoiperiphone3.JPG

The additional configuration should be set on your device as shown in the screenshot below, it is recommended to enable the notifications, background app refresh and cellular data for ZoiPer. On top of this, it is essential that the transport protocol is TCP rather than UDP. Lastly, clicking on "incoming calls" on the settings tab, you can enable the push notification, which is a remote server to keep alive the SIP connection, even when the app is running in the background. Some of these settings may require an upgrade to ZoiPer premium, this fee is not covered by any PBX license fees. 

 

789.JPG

 

Please note that due to recent changes on Android devices, incoming calls on ZoiPer will no longer work reliably in the background under any set of conditions configured. The only way to have reliability is by utilising Firebase Cloud Messaging (FCM) on Android, for further information see the link https://www.zoiper.com/en/support/home/article/205/Zoiper%20Push%20Proxy.

 

Using ZoiPer's instant messaging

 

Please note that the use of ZoiPer's instant messaging service requires a premium account license. Once you have connected your SIP devices open the ZoiPer application and click on the settings icon on the top-right corner.

 

zoiperIM1.JPG

 

The first step to enable messaging on ZoiPer is to subscribe and publish the device's presence. For that, you should select the account which you would like to enable it and click on advanced settings. In the features section, you should tick the checkbox to subscribe and publish the presence. This way, your contacts will be able to see your device status and if you are available for a call. Save this configuration and return to the main screen.

 

zoiperIM2.JPG

 

You will now need to add all your contacts to your ZoiPer address book. The easiest method of adding a user to your contacts is placing a call to their internal number. Next, click on the notification in recent history and the following image will be displayed. You can see a warning that the chatbox hasn't been set yet. Click on the link "set one here".

 

zoiperIM4.JPG

 

Now, you will need to save the contact's information. For this, you should enter a name and choose the relevant account to dial for this contact and which account should publish its presence to the contact. In our case, both accounts are the user "Desktop 1", as shown in the image below. Save all these changes and come back to the chat screen.

 

zoiperIM6.JPG

 

Lastly, you will be able to see your contact's status and send a message through the chatbox. From now on you only need to save your contacts and make sure that they have enabled subscribe and publish presence as well. Please note chatbox will only work with other ZoiPer softphone users configured with SIP devices. 

 

zoiperIM8.JPG

 

Watch this in action

 

The video below will show you a visual representation of the areas covered throughout this knowledge base guide.

 

zoiper.gif