In this article

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.

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__1_.JPG

Note that if you are on Zoiper 5.5.7, you will need to take additional steps to prevent audio issues. In the advanced configuration above, scroll down to audio codecs and disable all Opus and G.722 codecs

zoipercodecs.png

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. 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__1_.JPG

Open the Zoiper application and click the QR button at the bottom 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.


androidzoiper123.png

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 username field as shown in the screenshot above.

zoiperiphone2__1_.JPG

If this is your first time configuring Zoiper, manually enter in the SIP login, SIP password, SIP server, and hit the button "create an account". Please note that you must enter the port number to the end of the SIP server address using a colon then the port number 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.

androidzoiper456.png

Alternatively, if you have already set up a SIP account in Zoiper before, select "settings" on the left menu, and enter your SIP credentials, as pointed in step 6. The devices will now appear online inside your PBX portal.

zoiperiphone3__1_.JPG

The additional configuration should be set on "Network Settings" located at the bottom of the "Settings" screen. On top of this, it is essential that the registration expiry time is 120 rather than 600 seconds. Additionally, we recommend setting TCP as the transport protocol instead of UDP. Some of these settings may require an upgrade to Zoiper premium, this fee is not covered by any PBX license fees.

androidzoiper78.png

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.

Importing remote phonebook to Zoiper

To import the remote phonebook into your Zoiper, click on the PBX tab and select 'Phonebooks' located towards the bottom-left corner. A window will generate, click on show URL and copy the Zoiper's URL to your clipboard.

Zoiper_1.png

Next, launch the Zoiper app and enter your account credentials. Please note that Zoiper requires a premium license to import and export phonebooks. Next, click on settings and hit the contacts button.

Zoiper_2.png

In the contacts section, click 'Add' and select the 'XML' option from the dropdown list. Then, click the smaller 'Add' button towards the right.

Zoiper_3.png

Before attempting to import the remote phonebook, please ensure you have downloaded the latest version of Zoiper. Paste the URL from the clipboard into the local/URL path field. Leave the authentication type as 'Don't use'. Lastly, click on the 'XML Contact Service 1' on your left to save and confirm the configuration.

Zoiper_4.png

After the phonebook has been successfully imported, a list of numbers will appear under the 'Contacts' tab on the Zoiper home screen.

Zoiper_5.png

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 chat box 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.

Lastly, you will be able to see your contact's status and send a message through the chat box. 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 chat box 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.

gif.gif